# TickerFacts

> SEC EDGAR fundamentals as agent tools: look up or screen US public companies. Free, no key, CC0.

- name: com.tickerfacts/fundamentals
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 76/100 flags: no-repository
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.tickerfacts%2Ffundamentals
- tools: https://api.protogrid.dev/v1/servers/com.tickerfacts%2Ffundamentals/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "fundamentals": {
      "type": "http",
      "url": "https://tickerfacts.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 65
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% ~updated-91d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 83/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 10 of 10 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 3,827 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 17 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 10, about 3,827 tokens to load them all
- tool set hash: a43d04f20775b9c4250c8457b18af4b5
- tools last changed: 2026-10-05T23:02:02.209Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.tickerfacts/fundamentals.svg)](https://protogrid.dev/servers/com.tickerfacts/fundamentals)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-05 `get_fundamentals_batch` changed (inputSchema)
- 2026-10-05 `get_fundamentals` changed (description, inputSchema)
  - before: SEC-derived annual observations with exact dates, units and source filings for a US public company, by ticker symbol (use search_companies to find one by name), plus trailing-twelve-month figures and the latest quarterly balances (latest_interim) when a 10-Q is newer than the annual report. Each year also carries computed ratios (margins, return on equity, leverage, revenue_growth; any metric's change as <metric>_growth) and notes on figures that are not comparable with the year before (a restatement or a stock split between them): do not compute a change across a noted year. Includes coverage gaps, metric definitions, requested/canonical identity, dataset SHA-256 and research links. Empty annual history is unavailable, not zero; current-CIK history is not reconciled across reorganizations. Data traces to SEC EDGAR filings. For research and education only; not financial advice or a recommendation to buy, sell or hold.
  - after: SEC-derived annual observations with exact dates, units and source filings for a US public company, by ticker symbol (use search_companies to find one by name), plus trailing-twelve-month figures and the latest quarterly balances (latest_interim) when a 10-Q is newer than the annual report. Pass quarters (1 to 12) or period "quarterly" for single fiscal quarters (income, cash flow and balances, each reported or the difference of two reported year-to-date figures, named in derivation); reporting says whether the quarter after the latest report has ended without a report yet. Each year also carries computed ratios (margins, return on equity, leverage, revenue_growth; any metric's change as <metric>_growth) and notes on figures that are not comparable with the year before (a restatement or a stock split between them): do not compute a change across a noted year. Includes coverage gaps, metric definitions, requested/canonical identity, dataset SHA-256 and research links. Empty annual history is unavailable, not zero; current-CIK history is not reconciled across reorganizations. Data traces to SEC EDGAR filings. For research and education only; not financial advice or a recommendation to buy, sell or hold.
- 2026-09-25 `send_feedback` changed (inputSchema)
- 2026-09-25 `send_feedback` added
  - Report what you needed from TickerFacts and did not get, what looked wrong, what was confusing, or what worked. Call this whenever a tool call fails or a result lacks a figure, period, company or filter your user's task needed; say what the user was trying to accomplish and exactly which fields, periods, companies or filters would have solved it. Also call it once at the end of a session that went well, naming what was useful. Reports are read by the maintainers and drive what gets added; there is no reply channel unless you give a contact. Free-text fields are bounded; nothing is published.
- 2026-09-25 `screen_companies` changed (inputSchema)
- 2026-09-24 `search_companies` added
  - Find US public companies by name or ticker, forgiving typos, best match first: ticker, SEC CIK, readable name, exchange, SEC sector and industry, and the end of the latest annual period on file. Includes companies that have left the ticker directory (listing_status former). Use it to turn a company name into the ticker the other tools take.
- 2026-09-24 `get_cashflow_inputs` changed (title, annotations)
- 2026-09-24 `get_county_context` changed (title, annotations)
- 2026-09-24 `get_company_evidence` changed (title, annotations)
- 2026-09-24 `get_fundamentals_batch` changed (title, inputSchema, annotations)

Full history: https://api.protogrid.dev/v1/servers/com.tickerfacts%2Ffundamentals/changes

## Remotes

- https://tickerfacts.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (10)

- `get_cashflow_inputs`: Dated per-period cash-flow inputs for a US public company: operating cash flow, capital expenditure, net income and shares outstanding, each with its own period start and end, unit, filing date, SEC accession number and source URL. Values sharing a period end are matched on duration and currency before being grouped. Returns observations only: no discount rate, no terminal assumption, no fair value and no price target. For research and education only; not financial advice or a recommendation to buy, sell or hold.
- `get_company_evidence`: Read short, verified primary-source passages for reviewed company events, with source URLs, section labels, dates, hashes and predecessor links where reviewed. Selective coverage only: no passages means unreviewed, not no events. Quotes normalize whitespace; financial histories are not automatically reconciled across events.
- `get_company_research`: Company filings, quarterly insider transaction disclosures, aliases, headquarters and legal-entity relationships, with source licenses and explicit coverage dates. Not a live trading feed. For research and education only; not financial advice or an investment signal.
- `get_county_context`: Census ACS resident characteristics (housing costs, income, education, occupation mix) with published 90% margins of error, plus BLS QCEW private-industry jobs, pay and year-over-year growth by NAICS code with a national reference row, for one US county by FIPS code or name. Resident and workplace populations are different and must not be combined into one rate; missing and suppressed values are unavailable, not zero. Describes a place, not any company's operating or revenue exposure. For research and education only; not financial advice.
- `get_economic_context`: Selected government Treasury yields (daily) and BLS inflation, employment and wage series (monthly), with observation dates, units and reuse provenance. Returns the last year of observations unless since is given. For research and education only; not financial advice.
- `get_fundamentals`: SEC-derived annual observations with exact dates, units and source filings for a US public company, by ticker symbol (use search_companies to find one by name), plus trailing-twelve-month figures and the latest quarterly balances (latest_interim) when a 10-Q is newer than the annual report. Pass quarters (1 to 12) or period "quarterly" for single fiscal quarters (income, cash flow and balances, each reported or the difference of two reported year-to-date figures, named in derivation); reporting says whether the quarter after the latest report has ended without a report yet. Each year also carries computed ratios (margins, return on equity, leverage, revenue_growth; any metric's change as <metric>_growth) and notes on figures that are not comparable with the year before (a restatement or a stock split between them): do not compute a change across a noted year. Includes coverage gaps, metric definitions, requested/canonical identity, dataset SHA-256 and research links. Empty annual history is unavailable, not zero; current-CIK history is not reconciled across reorganizations. Data traces to SEC EDGAR filings. For research and education only; not financial advice or a recommendation to buy, sell or hold.
- `get_fundamentals_batch`: Read annual fundamentals for 1 to 20 comma-separated ticker symbols in one request. Defaults to one newest period per issuer; optional metrics projection. Each result keeps requested/canonical identity and source lineage; unknown tickers produce per-entry errors. No historical point-in-time filtering.
- `screen_companies`: Find US public companies whose latest annual period fundamentals match filters (minimum revenue, margins, ROE, growth; sector; profitable-only), sorted and limited. Returns a ranked list of companies with their key figures. Data traces to SEC EDGAR filings. For research and education only; not financial advice or a recommendation to buy, sell or hold.
- `search_companies`: Find US public companies by name or ticker, forgiving typos, best match first: ticker, SEC CIK, readable name, exchange, SEC sector and industry, and the end of the latest annual period on file. Includes companies that have left the ticker directory (listing_status former). Use it to turn a company name into the ticker the other tools take.
- `send_feedback`: Report what you needed from TickerFacts and did not get, what looked wrong, what was confusing, or what worked. Call this whenever a tool call fails or a result lacks a figure, period, company or filter your user's task needed; say what the user was trying to accomplish and exactly which fields, periods, companies or filters would have solved it. Also call it once at the end of a session that went well, naming what was useful. Reports are read by the maintainers and drive what gets added; there is no reply channel unless you give a contact. Free-text fields are bounded; nothing is published.