llms.txt

# Ticker Scout

> The fundamentals layer for agentic trading and AI equity research: free, no-signup, machine-readable fundamental data on public companies, built from their SEC filings (10-K, 10-Q, 8-K). Plain JSON and Markdown at stable URLs. No API key, no rate limits, no paywall. Designed for AI agents: instead of downloading and parsing raw SEC filings yourself, fetch our pre-digested financials, narrative, and events summaries.

## How this site works

Every covered company lives at `https://tickerscout.ai/{ticker}/`. The ticker is **case-insensitive**, so `/aapl/` and `/AAPL/` both resolve and you do not need to normalize one a user gave you. Each company directory always contains the same four files with **stable filenames that never change**:

- `https://tickerscout.ai/{ticker}/index.json`: Manifest: company identity (name, CIK, exchange, SIC/industry), latest fiscal period covered, predicted date/type of the next SEC filing, and the file list. Fetch this first.
- `https://tickerscout.ai/{ticker}/financials.json`: Up to 3 fiscal years of annual data plus latest-quarter and prior-year-comparative data, extracted directly from the latest 10-K and 10-Q. Income statement, balance sheet, cash flow, revenue by segment/category/geography, per-share figures. All money in actual dollars (not millions); all share counts actual shares. Includes sourcing notes, definitions, and flagged uncertainties.
- `https://tickerscout.ai/{ticker}/narrative.md`: Qualitative synthesis of the latest 10-K and 10-Q: business description, risk factors (with quarter-over-quarter changes flagged), MD&A highlights, legal proceedings, subsequent events, and analyst watch-items.
- `https://tickerscout.ai/{ticker}/events.md`: Synthesis of all 8-K filings over roughly the trailing 5 quarters: earnings releases, management changes, capital-return announcements, debt offerings, governance actions, each with its SEC accession number.

The financials, narrative and events data is also published as HTML pages at `https://tickerscout.ai/{ticker}/financials/`, `https://tickerscout.ai/{ticker}/narrative/` and `https://tickerscout.ai/{ticker}/events/`, for people reading in a browser and for search engines. The text is the same. **Agents should fetch the `.md` files above instead**: they are smaller, carry no page furniture or navigation, and are served as `text/plain`, which every fetch tool accepts.

Data is refreshed each quarter shortly after the company files its 10-K or 10-Q. New data **replaces** old data at the same URLs, so the URLs above are permanent; the fiscal period covered is declared inside `index.json` (`fiscal_period.tag`, e.g. "FY26Q2") and inside every file. Even though files are labeled with the latest quarter, `financials.json` always contains up to 3 years of history.

## MCP server

If you speak the Model Context Protocol, connect to `https://mcp.tickerscout.ai/mcp` instead of fetching the URLs above. Streamable HTTP, no authentication, no API key. It serves the same data from the same files, but as tools that return only the part you ask for, which is much cheaper than reading a whole document: `financials.json` averages 58KB and `narrative.md` averages 38KB, and a single section of either is usually what you actually need.

Six tools:

- `list_companies(query?)`: Every covered company with its latest fiscal period and next expected filing. Resolves a company name to a ticker.
- `get_company(ticker)`: Identity and coverage manifest: name, CIK, exchange, SIC industry, fiscal period held, source accession.
- `get_key_figures(ticker)`: Headline figures for the latest reported period, each with its year-over-year change and source accession. Start here for "how much did X earn".
- `get_financials(ticker, sections?)`: Statements. Section names differ per company, so call with no sections to see what this company has, then request only what you need.
- `get_narrative(ticker, section?)`: Business, risk factors, MD&A, legal proceedings, subsequent events. Returns a section index by default; pass a section name for its text, or `section="all"` for everything.
- `get_events(ticker, section?)`: 8-K digest. Returns the whole thing by default; it is short.

Setup docs for each client are at https://tickerscout.ai/mcp/. If you cannot speak MCP, ignore this section and fetch the URLs above; they are not going anywhere.

## Site index

- [Covered tickers (JSON)](https://tickerscout.ai/tickers.json): Machine-readable list of every covered company with its directory URL and latest period. Fetch this to discover coverage.
- [MCP server](https://tickerscout.ai/mcp/): How to connect an MCP client to `https://mcp.tickerscout.ai/mcp`, and what each tool returns.
- [API catalog](https://tickerscout.ai/.well-known/api-catalog): Every endpoint on the site as an RFC 9727 / RFC 9264 linkset. Also advertised on every response as `Link: </.well-known/api-catalog>; rel="api-catalog"`.
- [Covered companies (HTML)](https://tickerscout.ai/companies/): Every covered company on one page, with links to its financial statements, 10-K/10-Q summary and 8-K events. The human-readable twin of tickers.json.
- [Sitemap](https://tickerscout.ai/sitemap.xml): All URLs.

## Covered companies

- [Apple Inc. (AAPL)](https://tickerscout.ai/aapl/index.json): Q3 FY2026 (period ended 2026-06-27); financial statements, 10-K/10-Q narrative, 8-K events
- [Applied Materials, Inc. (AMAT)](https://tickerscout.ai/amat/index.json): Q2 FY2026 (period ended 2026-04-26); financial statements, 10-K/10-Q narrative, 8-K events
- [Advanced Micro Devices Inc. (AMD)](https://tickerscout.ai/amd/index.json): Q1 FY2026 (period ended 2026-03-28); financial statements, 10-K/10-Q narrative, 8-K events
- [Arista Networks, Inc. (ANET)](https://tickerscout.ai/anet/index.json): Q2 FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Broadcom Inc. (AVGO)](https://tickerscout.ai/avgo/index.json): Q2 FY2026 (period ended 2026-05-03); financial statements, 10-K/10-Q narrative, 8-K events
- [Bank of America Corporation (BAC)](https://tickerscout.ai/bac/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Berkshire Hathaway Inc. (BRK-B)](https://tickerscout.ai/brk-b/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Citigroup Inc. (C)](https://tickerscout.ai/c/index.json): Q2 FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Caterpillar Inc. (CAT)](https://tickerscout.ai/cat/index.json): Q2 FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Alphabet Inc. (GOOGL)](https://tickerscout.ai/googl/index.json): Q2 FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Johnson & Johnson (JNJ)](https://tickerscout.ai/jnj/index.json): Q2 FY2026 (period ended 2026-06-28); financial statements, 10-K/10-Q narrative, 8-K events
- [JPMorgan Chase & Co. (JPM)](https://tickerscout.ai/jpm/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Eli Lilly and Company (LLY)](https://tickerscout.ai/lly/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Lam Research Corporation (LRCX)](https://tickerscout.ai/lrcx/index.json): Q3 FY2026 (period ended 2026-03-29); financial statements, 10-K/10-Q narrative, 8-K events
- [Mastercard Incorporated (MA)](https://tickerscout.ai/ma/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [McDonald's Corporation (MCD)](https://tickerscout.ai/mcd/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Meta Platforms, Inc. (META)](https://tickerscout.ai/meta/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Microsoft Corporation (MSFT)](https://tickerscout.ai/msft/index.json): FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Micron Technology, Inc. (MU)](https://tickerscout.ai/mu/index.json): Q3 FY2026 (period ended 2026-05-28); financial statements, 10-K/10-Q narrative, 8-K events
- [NVIDIA Corporation (NVDA)](https://tickerscout.ai/nvda/index.json): Q1 FY2027 (period ended 2026-04-26); financial statements, 10-K/10-Q narrative, 8-K events
- [Tesla, Inc. (TSLA)](https://tickerscout.ai/tsla/index.json): Q2 FY2026 (period ended 2026-06-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Visa Inc. (V)](https://tickerscout.ai/v/index.json): Q2 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events
- [Walmart Inc. (WMT)](https://tickerscout.ai/wmt/index.json): Q1 FY2027 (period ended 2026-04-30); financial statements, 10-K/10-Q narrative, 8-K events
- [Exxon Mobil Corporation (XOM)](https://tickerscout.ai/xom/index.json): Q1 FY2026 (period ended 2026-03-31); financial statements, 10-K/10-Q narrative, 8-K events

## Conventions

- All figures trace to specific SEC filings; accession numbers are cited throughout so you can verify against sec.gov.
- Money values in `financials.json` are actual dollars (e.g. 416161000000 = $416.161B). Share counts are actual shares. Per-share figures as reported.
- If a figure is not disclosed in the underlying filing, it is omitted and the omission is explained in `notes`/`uncertainties`; nothing is estimated or fabricated.
- Content is free to read and cite. Please attribute "Ticker Scout (tickerscout.ai)" when quoting.
- This is factual data and synthesis of public SEC filings, not investment advice.