TickerTrac

View saved version →

---
name: tickertrac-evidence-check
description: Check one assumption, expectation or claim the user states against the exact evidence TickerTrac has retained for a saved thesis, and answer supported, contradicted, partial, insufficient or unavailable with exact citations. Use when the user asks whether something they believe or assumed still holds, or whether retained filings, earnings calls, disclosures or saved signals back a specific statement. Not for a broad what-changed review (use tickertrac-thesis-review) and not for fresh research.
---

# TickerTrac evidence check

Compare one statement with retained evidence. The answer is one of five states, each with
what was searched and what was found. Nothing outside the retained records counts.

## Check the connection first

The TickerTrac connector must be connected and expose `list_theses`, `get_thesis`,
`search_evidence`, `retrieve_thesis_evidence`, `inspect_evidence` and
`get_financial_snapshot`. If those tools are absent, say so and point the user to
https://tickertrac.com/assistants. Tool errors return `{"error": <code>}`: report the code
in plain words and stop that step. No automatic retries.

## Pin the statement and the thesis

1. Restate the user's assumption in one sentence and get agreement if it is ambiguous. A
   statement that mixes two claims is checked as two.
2. Resolve the subject with `list_theses` (company `company:<watchlist>:<TICKER>` or
   `theme:<id>`). For a theme, the check needs one company explicitly linked in the saved
   version; ask which one if several fit.
3. `get_thesis` for the version returned by `list_theses`. If it is null, stop and explain
   that no saved version is available. Pin that same version for every subsequent call. Report whether the statement is **saved** (it
   appears in the narrative or a component) or **stated now** (the user holds it but the
   thesis does not say it). Never describe a stated-now assumption as something the user
   previously recorded, and never read an older version unless asked for it by number.

## Gather evidence, bounded

Use at most two listing pages, four evidence calls and three `inspect_evidence` calls
for quotes before answering. Report any unreviewed pages instead of scanning indefinitely.

- `retrieve_thesis_evidence`: English full-text match over retained filing, call and
  disclosure passages for one company. Event-time window up to 366 days, `source_scope`
  `all`, `filings`, `calls` or `disclosures`, five passages per page. Results are
  **unassessed source passages**, not saved judgments. Try the user's wording once and one
  rephrasing with the concrete nouns (metric, product, customer) if the first returns nothing.
- `search_evidence`: case-insensitive literal substring over saved signal titles and
  summaries for a detection window of at most 31 days. Use it to find TickerTrac's saved
  judgment on the topic. A hit's `excerpt_state` says whether a quote is available.
- `get_financial_snapshot`: the latest retained SEC headline-metric cache for a numeric
  claim. Read `freshness`, `missing_metrics` and `metric_provenance`. It is the latest cache,
  not the figures at the time the thesis was saved, and it never derives a metric that is
  not listed.
- `inspect_evidence`: the permitted excerpt for a saved signal. Empty `excerpts` with a
  reason means the quote is unavailable.

Always state the windows, scopes and queries you used. If `scan_truncated` or `truncated` is
true, say that the search was cut off before the retained set was exhausted.

## Answer with one state

Pick the state from [references/verdicts-and-citations.md](references/verdicts-and-citations.md)
and format citations as it describes. In short:

| State | Meaning |
|---|---|
| supported | Exact retained source text or an available, current retained metric directly addresses the same statement, period and measure and agrees with it. |
| contradicted | Exact retained source text or an available, current retained metric

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: tickertrac-thesis-review
description: Weekly or catch-up review of the user's saved TickerTrac theses from retained evidence only. Reports which saved Company theses and Investment themes had support, contradict or neutral signals in a bounded window, with exact sources and coverage gaps. Use when the user asks what changed, what they missed, or for a weekly or catch-up review of their theses. Not for testing one specific assumption (use tickertrac-evidence-check) and not for fresh research or news.
---

# TickerTrac thesis review

Read-only by default. Every statement in the review resolves to a retained TickerTrac
record or says that evidence is insufficient. The user's saved thesis is the authority;
your reading of the evidence is interpretation, never a saved judgment.

## Check the connection first

The TickerTrac connector must be connected (hosted `https://api.tickertrac.com/mcp` or the
local connector) and expose at least `list_theses`, `get_thesis`, `get_changes` and
`inspect_evidence`. If those tools are absent, say so and point the user to
https://tickertrac.com/assistants. Do not describe theses or changes you did not read.

Every result carries `coverage` (`complete`, `partial` or `unavailable` with a `note`),
`as_of`, `truncated` and `next_cursor`. A tool error returns `{"error": <code>}`; report the
code in plain words and stop that step. Never retry automatically; on `rate_limited` or
`temporarily_unavailable` wait at least `retry_after_seconds` before one further attempt.

## Scope the review

1. **Window.** Use the user's stated period. Otherwise use the last 7 days ending now. Pass
   timezone-aware ISO timestamps with `end` not in the future. `get_changes` accepts at most 31
   days per call, so a longer catch-up is a sequence of consecutive, non-overlapping windows.
   Stop after three consecutive windows (93 days) unless the user asks for more, and say which
   period you did not review.
2. **Theses.** Call `list_theses` (`kind` all, company or theme) and follow `next_cursor`
   with identical arguments for at most two pages. If the requested thesis is not found,
   ask the user to narrow the scope; do not silently scan the account. If the user named a
   thesis, review only that one. Otherwise ask which active theses to review, at most three,
   and name any you left out. Inactive
   theses are reviewed only on request.
3. **Version.** Use the `version` returned by `list_theses` for every read, and name it in
   the report. A review binds to that exact saved version, not to "the thesis" in general.
   If the version is null, say no saved version is available and skip it. Across the review,
   stop after 20 tool calls and state any unreviewed pages, sources or periods.

## Read in this order

For each thesis in scope:

1. `get_thesis` with the subject and version. Note the narrative, components (claims,
   expectations, invalidations) and, for a theme, its explicit company links.
2. `get_changes` for each window. Group items by the saved `relationship` (`support`,
   `contradict`, `neutral`, or `unknown`) and keep the saved `materiality` (`material`,
   `immaterial`, `uncertain`, `unknown`). Use those words verbatim; do not remap them to your
   own scale. Follow `next_cursor` when present, or state that further pages exist.
3. `inspect_evidence` for the items the user is most likely to act on: at most three per
   thesis unless asked, starting with `support` and `contradict` items marked `material`.
   Quote only text returned in `excerpts`. An empty `excerpts` list with a reason means the
   quote is unavailable, not that the event is doubtful.

Write the report as described in [references/catch-up-report.md](references/catch-up-report.md).

## Boundaries

- **No fresh research.** These tools make zero provider or model calls. Do not claim to have
  checked news, filings, prices or anything outside the retained records, and do not offer to.
- **Empty is not quiet.** Zero items means no retaine

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.