MCP server

Astreus is an MCP server: AI assistants can connect to it and work directly with the platform’s structured, traceable financial data — statements, segments, filings, decks, transcripts, guidance, events, news, ownership, macro and the claim graph, across the US, the Gulf, Japan, Taiwan, Korea and Europe. Once connected, you don’t write API calls — you ask questions:

“Did NVIDIA beat its data-center guidance last quarter? Cite the filings.”

The assistant chains the tools itself (resolve the company → pull segment revenue → pull the guidance scorecard → trace the numbers to their filings) and answers with accession numbers next to every figure. The shared source release covers financials, source documents, calendars, ownership, management, macro catalogs, government, assets and other licensed research data. The hosted server and installed CLI can run different releases: use tools/list on the connected server for the actual tool names and schemas. Account administration and billing are outside the public MCP data surface.

Connect your client

No API key needed — you approve the connection with your Astreus sign-in (OAuth).

Add the connector

In Claude, open Settings → Connectors → Add custom connector and paste:

https://astreus.ai/api/mcp

Approve access

Claude sends you to Astreus. Sign in (or you already are), review what’s being granted — read-only data access, metered on your plan — and click Approve.

Ask something

Back in Claude, enable the connector in the chat’s tools menu and ask a question. The connection works on Claude mobile too, and you can revoke it anytime from Claude’s connector settings.

One command in your terminal, using an API key from the Developers page:

claude mcp add --transport http astreus https://astreus.ai/api/mcp \
  --header "Authorization: Bearer pk_live_..."

Run /mcp inside a session to see the server and its tools, then just ask.

Claude Desktop runs the local stdio server, which ships with the CLI:

npm install -g astreus-cli

Then add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "astreus": {
      "command": "astreus",
      "args": ["mcp"],
      "env": { "ASTREUS_API_KEY": "pk_live_..." }
    }
  }
}

Restart Claude Desktop; Astreus appears under the tools icon.

In .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) — either transport:

{
  "mcpServers": {
    "astreus": {
      "url": "https://astreus.ai/api/mcp",
      "headers": { "Authorization": "Bearer pk_live_..." }
    }
  }
}

For Copilot agent mode, in .vscode/mcp.json:

{
  "servers": {
    "astreus": {
      "type": "http",
      "url": "https://astreus.ai/api/mcp",
      "headers": { "Authorization": "Bearer pk_live_..." }
    }
  }
}

Any compatible MCP client works. Both transports use shared definitions; the actual tool set follows each installed/deployed release:

Streamable HTTP: https://astreus.ai/api/mcp — authenticate with Authorization: Bearer pk_live_... (or X-API-KEY), or via the OAuth flow advertised at /.well-known/oauth-protected-resource/api/mcp (dynamic registration + PKCE).
stdio: astreus mcp (from npm i -g astreus-cli), key via ASTREUS_API_KEY.

From the Claude API, no client code at all:

{
  "mcp_servers": [{
    "type": "url",
    "url": "https://astreus.ai/api/mcp",
    "name": "astreus",
    "authorization_token": "pk_live_..."
  }]
}

Discovery manifest: /.well-known/mcp.json.

Good first prompts: “What was Apple’s gross margin trend over the last 8 quarters? Cite each figure.” · “Summarize the newest 8-K from Tesla.” · “What did NVIDIA’s management promise on the last earnings call, and what’s their guidance hit rate?” · “Show US unemployment as it was known in March 2020.”

The tools

The current source release defines 64 public data tools. Four experimental tools remain local-only and are omitted here. A connected server’s tools/list is authoritative for the version it runs.

Tool	Purpose
`search`	Search companies, macro series and countries
`get_coverage`	Coverage inventory — what Astreus holds, market by market
`get_company`	Company profile, key metrics, overview series, signals and private-company records
`get_financials`	Standardized financial statements
`get_segment_revenue`	Revenue by business segment or region
`get_fact_source`	Trace a figure to its SEC filing (citation)
`list_filings`	Filing and document index
`get_filing_sections`	Parsed filing sections index
`get_section_text`	Filing section text
`get_events`	8-K items and exchange disclosures
`get_event_text`	8-K item or exchange disclosure text
`list_transcripts`	Earnings-call transcript index
`get_transcript`	Earnings-call transcript text
`get_guidance`	Management guidance from earnings calls: promises and scorecards
`get_news`	Live news tape
`analyze_transcript_topics`	Compare transcript topics and analyst Q&A
`search_transcripts`	Search earnings-call transcripts
`get_mentioned_by`	Who is talking about a company
`get_supply_chain`	Disclosed suppliers, customers and competitors
`get_company_debt`	Company debt disclosures
`screen_corporate_bonds`	Corporate bond disclosure screener
`get_calendar`	Calendar: earnings, economic releases, corporate events, Congress, a company’s dated events
`get_calendar_event`	One calendar event’s detail
`get_country`	Country profile and map
`get_economy`	A country’s economy, one sub-tab at a time
`get_central_bank`	A country’s central bank, one sub-tab at a time
`list_macro_series`	Macro series catalog
`get_macro_series`	Macro series observations
`search_policy_text`	Search central-bank documents
`get_policy_document`	Read a central-bank document
`get_management`	Officers, directors, leadership changes and shareholder votes
`get_ownership`	Insider and institutional ownership
`get_dividends`	Declared dividends
`get_monthly_revenue`	Monthly revenue (Taiwan)
`get_note_tables`	Tables in the notes to the financial statements
`get_financials_as_filed`	Financial statements as originally filed
`get_presentations`	Investor presentations and the guidance printed in them
`get_earnings`	Earnings: reported quarters and what management said
`get_event_facts`	Facts extracted from a company’s 8-K filings and exchange disclosures
`get_government_exposure`	Regulators, laws, regulation, government awards and central-bank documents
`get_market_events`	Market events that bear on a company
`get_market_board`	Market board: commodities or currencies today
`get_market_series`	Market series: one commodity’s or currency pair’s history
`get_commodity_analytics`	Commodity analytics: positioning, spreads, inventories, market map, GPU mentions
`list_themes`	Market themes: what managements are talking about
`get_theme`	One market theme: its companies and what they said
`get_company_themes`	The themes one company is part of
`list_asset_companies`	Which companies and layers have mapped physical assets
`get_company_assets`	A company’s physical assets
`search_assets`	Physical assets in a country or area
`get_asset`	One physical asset: parties, lifecycle, sources and measured series
`get_digital_assets`	A company’s digital assets: chips, apps, websites, cloud platforms
`search_people`	Search the people registry
`get_person`	One person’s record
`list_conflicts`	Armed conflicts
`get_conflict`	One armed conflict
`get_organisation`	International organisations
`get_government`	Government, one sub-tab or one part at a time
`get_central_bank_financials`	Federal Reserve Banks’ financial statements (US only)
`list_countries`	Country screener
`get_research_widget`	Filing diff, XBRL structure, data confidence
`get_document_text`	Read a filing, report or presentation as text
`list_companies`	List published companies by country, sector or name
`get_chart_series`	Chart series: align macro, fundamentals and commodity prices on one calendar

Use the generated tool reference for exact endpoint mappings. Tool descriptions document units, coverage, licensing, pagination and source anchors. Some tools filter or reshape REST responses to satisfy their bounds and redistribution rules; do not assume every tool returns the entire corresponding REST payload. get_document_text reads a listed filing or document as bounded text, using the company identifier and accession/doc_ref from list_filings (an SEC accession alone also works, without the company). Page/character windows retain provenance. Scans without stored OCR can return text_unavailable; follow the returned source or page-image path rather than guessing the missing text.

Metering, auth and limits

A tool call is metered like the REST request(s) it makes — the same per-minute and monthly counters as the REST API. Most tools make one request; get_transcript (index + text) and get_guidance (commitments + scorecard) make two, and get_event_text makes two when it has to look the item code up first. Protocol plumbing (initialize, tools/list) is free. MCP calls appear in the usage dashboard as /api/mcp#<tool>.
get_financials takes the same period_type (including semiannual), reporting_basis and accounting basis as the REST route, and get_company returns the company’s accounting_bases so an assistant can ask for the right one.
Two credentials work: API keys (pk_live_..., as a Bearer or X-API-KEY header) and OAuth tokens from the connector flow. Both are data-scoped — key management, billing and account routes reject them by design.
When you’re rate limited, the tool result says how many seconds to wait; assistants honour it.

Availability and boundaries

The public tools omit local-only experiments. Prices, benchmarks, tracking, geometry, photos and other third-party data may be withheld or filtered by the tool’s license rules even when a REST route exists. Absence of a tool or a returned value is not zero. The data catalog and tool reference map each interface; check the tool’s own schema and returned limitations before relying on coverage. Current API keys remain data-scoped. Workspace storage, account news rules, billing and key management are not available through public MCP. The signed-in Agent mode uses the user’s existing account session for its news-monitor controls.

Rules the server enforces on itself

The server’s own instructions carry the contract from agents.md: cite accession numbers next to figures, respect vintages (/financials is latest-restated and names its filing; macro is the current vintage, not what was known at the time), treat null as “not available” — never zero — and present data without investment advice.

Getting started

Coverage

Data

Concepts

Guides

For AI agents

Connect your client

The tools

Metering, auth and limits

Availability and boundaries

Rules the server enforces on itself

​Connect your client

​The tools

​Metering, auth and limits

​Availability and boundaries

​Rules the server enforces on itself

Connect your client

The tools

Metering, auth and limits

Availability and boundaries

Rules the server enforces on itself