Developers · machine-readable access

API & MCP

Everything on this site is available programmatically: a JSON REST API described by an OpenAPI 3.1 schema, and an MCP server for AI agents. Both are generated from the same schema definitions, are free to use, and require no authentication. Data refreshes daily.

MCP endpoint

https://financials.page/api/mcp

Streamable HTTP · stateless

REST base URL

https://financials.page/api/v1

JSON over HTTPS, no auth

OpenAPI document

https://financials.page/api/openapi.json

OpenAPI 3.1 · JSON Schema 2020-12

MCP server

for Claude and other AI agents

A Model Context Protocol server over Streamable HTTP (JSON-RPC 2.0, stateless — no session required). Every tool declares an input and output schema, and results include structuredContent. On claude.ai, add a custom connector pointing at https://financials.page/api/mcp; from Claude Code:

claude mcp add --transport http financials.page https://financials.page/api/mcp

TOOLsearch_companies

Search ~8,000 SEC-reporting companies by name or ticker. Returns CIKs (the SEC's permanent company ids) to use with the other tools.

Parameter	Type	Required	Description
query	string	yes	Company name or ticker fragment to search for
limit	integer	no	Maximum results (default 10)

TOOLget_company_profile

Registrant profile for a company: industry (SIC), exchange and ticker, headquarters, state of incorporation, fiscal year end, filer category, website, and its most recent regulatory filings with links.

Parameter	Type	Required	Description
cik	integer	yes	SEC Central Index Key of the company

TOOLget_company_financials

Annual (up to 12 fiscal years) and quarterly (up to 12 quarters) financial series for a company, as reported to the SEC: revenue, margins inputs, net income, EPS (split-adjusted), cash flow, capex, buybacks, dividends, balance sheet items. Values are in the filer's reporting currency (see `currency`).

Parameter	Type	Required	Description
cik	integer	yes	SEC Central Index Key of the company

Example — calling a tool directly:

curl https://financials.page/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_companies","arguments":{"query":"novo nordisk"}}}'
# → { "result": { "structuredContent": { "companies": [ { "cik": 353278, "ticker": "NVO", … } ] } } }

REST API

three read-only endpoints

GET/api/v1/companies

Search companies by name or ticker — Ranked search over ~8,000 SEC filers (exact ticker first, then ticker prefix, then name). Without `q`, returns the largest filers.

Parameter	Type	Required	Description
q	string	no	Name or ticker fragment
limit	integer	no	Maximum results

GET/api/v1/companies/{cik}

Registrant profile and recent filings

Parameter	Type	Required	Description
cik	integer	yes	SEC Central Index Key — the permanent company id

GET/api/v1/companies/{cik}/financials

Annual and quarterly financial series — Up to 12 fiscal years and 12 discrete quarters per metric, as reported (restatement-deduped, split-adjusted), in the filer's reporting currency. Q4 is derived as the annual figure less the three reported quarters.

Parameter	Type	Required	Description
cik	integer	yes	SEC Central Index Key — the permanent company id

Example — Apple’s financial series:

curl "https://financials.page/api/v1/companies?q=apple"
# → { "companies": [ { "cik": 320193, "ticker": "AAPL", "name": "Apple Inc." }, … ] }

curl "https://financials.page/api/v1/companies/320193/financials"
# → { "cik": 320193, "entityName": "Apple Inc.", "currency": "USD",
#     "annual":    { "revenue": [ { "period": "FY2025", "end": "2025-09-27", "value": 416161000000 }, … ], … },
#     "quarterly": { "revenue": [ { "period": "Mar ’26", "end": "2026-03-28", "value": 111200000000 }, … ], … } }