Tool reference

This reference is generated from the same OpenAPI contract and shared MCP definitions used by the application and CLI. It describes the matching source release. Hosted deployments and npm publication happen separately: use the live OpenAPI contract and the connected server’s tools/list to determine what your environment currently supports. The JSON catalog includes parameter schemas, response types, authentication tiers and MCP mappings. It contains no credentials or financial data. The Agent mode uses the same catalog.

MCP 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

API operations

The current source contract contains 200 operations. Use the API Reference tab for parameters and response examples. Every data operation is available through astreus api describe <operation-id> and astreus api call <operation-id>; the news stream uses astreus news --follow, and browser recording-state writes are excluded from data calls.

Operation ID	Method and path	MCP
`get-private-company-profile`	`GET /api/v1/supercycle/private/{slug}`	`get_company`
`get-private-company-filed-record`	`GET /api/v1/supercycle/private/{slug}/filed`	`get_company`
`get-crypto-asset-screener`	`GET /api/v1/crypto`	REST / CLI
`get-crypto-asset-profile`	`GET /api/v1/crypto/{id}`	REST / CLI
`get-crypto-price-history`	`GET /api/v1/crypto/{id}/prices`	REST / CLI
`get-printed-statement-by-period`	`GET /api/v1/companies/{id}/financials/as-reported`	`get_financials_as_filed`
`get-earnings-source-statements`	`GET /api/v1/companies/{id}/earnings/statements`	`get_earnings`
`get-company-regulators`	`GET /api/v1/companies/{id}/regulators`	`get_government_exposure`
`get-fx-pair-profile`	`GET /api/v1/fx/pairs/{pair}`	`get_market_series`
`get-companies-with-physical-assets`	`GET /api/v1/geo/companies`	`list_asset_companies`
`get-company-digital-assets`	`GET /api/v1/companies/{id}/digital-assets`	`get_digital_assets`
`get-digital-asset-detail`	`GET /api/v1/digital-assets/{key}`	`get_digital_assets`
`get-person-roll-call-votes`	`GET /api/v1/people/{cik}/votes`	`get_person`
`get-conflict-detail`	`GET /api/v1/military/conflicts/{key}`	`get_conflict`
`get-organisation-detail`	`GET /api/v1/foreign-relations/organisations/{code}`	`get_organisation`
`get-legislative-bills`	`GET /api/v1/countries/{iso}/government/bills`	`get_government`
`get-next-chamber-sittings`	`GET /api/v1/countries/{iso}/government/next-sitting`	`get_government`
`get-government-committee`	`GET /api/v1/countries/{iso}/government/committees/{systemCode}`	`get_government`
`get-government-roll-call-vote`	`GET /api/v1/countries/{iso}/government/votes/{congress}/{chamber}/{session}/{roll}`	`get_government`
`get-government-budget-flow`	`GET /api/v1/countries/{iso}/budget-flow`	`get_government`
`get-central-bank-financial-source`	`GET /api/v1/countries/{iso}/fed-financials/source`	`get_central_bank_financials`
`get-company-research-widget`	`GET /api/v1/research/widgets/{kind}`	`get_research_widget`
`get-federal-awards`	`GET /api/v1/companies/{id}/government-awards`	`get_government_exposure`
`get-regulation`	`GET /api/v1/companies/{id}/regulation`	`get_government_exposure`
`get-laws-regulations`	`GET /api/v1/companies/{id}/laws`	`get_government_exposure`
`get-company-debt-disclosures`	`GET /api/v1/companies/{id}/debt`	`get_company_debt`
`get-instrument-disclosure-history-and-evidence-scoped-to-its-reporting-company`	`GET /api/v1/companies/{id}/debt/{instrumentId}`	`get_company_debt`
`get-debt-source-evidence`	`GET /api/v1/companies/{id}/debt/sources/{sourceId}`	`get_company_debt`
`get-bond-issuer-screener`	`GET /api/v1/debt/issuers`	`screen_corporate_bonds`
`get-corporate-bond-screener`	`GET /api/v1/debt/instruments`	`get_company_debt`, `screen_corporate_bonds`
`get-debt-instrument-detail`	`GET /api/v1/debt/instruments/{instrumentId}`	`screen_corporate_bonds`
`get-health-check`	`GET /api/health`	REST / CLI
`get-coverage-stats`	`GET /api/v1/landing/stats`	REST / CLI
`get-coverage-inventory`	`GET /api/v1/landing/coverage`	`get_coverage`
`get-search`	`GET /api/v1/search`	`search`
`get-search-news-themes-and-transcripts`	`GET /api/v1/search/content`	`search`
`get-who-am-i`	`GET /api/v1/me`	REST / CLI
`get-list-companies`	`GET /api/v1/companies`	`list_companies`
`get-price-sparklines`	`GET /api/v1/companies/sparklines`	REST / CLI
`get-company-profile`	`GET /api/v1/companies/{id}`	`get_company`, `get_calendar`, `get_monthly_revenue`, `get_theme`, `get_research_widget`
`get-company-logo`	`GET /api/v1/companies/{id}/logo`	REST / CLI
`get-financial-statements`	`GET /api/v1/companies/{id}/financials`	`get_financials`
`get-statements-as-filed`	`GET /api/v1/companies/{id}/financials/as-filed`	`get_financials_as_filed`
`get-fact-provenance`	`GET /api/v1/companies/{id}/fact-source`	`get_fact_source`
`get-stock-prices`	`GET /api/v1/companies/{id}/prices`	REST / CLI
`get-company-filings`	`GET /api/v1/companies/{id}/filings`	`list_filings`
`get-filing-detail`	`GET /api/v1/companies/{id}/filings/{accession}`	`get_document_text`
`get-filing-sections`	`GET /api/v1/companies/{id}/filing-notes`	`get_filing_sections`
`get-note-tables-index`	`GET /api/v1/companies/{id}/filing-notes/tables`	`get_note_tables`
`get-note-family-series`	`GET /api/v1/companies/{id}/filing-notes/series`	`get_note_tables`
`get-note-table`	`GET /api/v1/companies/{id}/filing-notes/tables/{tableId}`	`get_note_tables`
`get-section-text`	`GET /api/v1/companies/{id}/filing-notes/{sectionId}`	`get_section_text`
`get-company-8-k-events`	`GET /api/v1/companies/{id}/events`	`get_events`
`get-8-k-item-text`	`GET /api/v1/companies/{id}/events/{accession}`	`get_event_text`
`get-segment-revenue`	`GET /api/v1/companies/{id}/segment-revenue`	`get_segment_revenue`
`get-regional-revenue`	`GET /api/v1/companies/{id}/regional-revenue`	`get_segment_revenue`
`get-supply-chain`	`GET /api/v1/companies/{id}/supply-chain`	`get_supply_chain`
`get-supply-chain-relationship`	`GET /api/v1/companies/{id}/supply-chain/{edgeKey}`	`get_supply_chain`
`get-company-assets-map`	`GET /api/v1/companies/{id}/assets`	`get_company_assets`
`get-map-layers`	`GET /api/v1/geo/layers`	`list_asset_companies`
`get-countries-with-mapped-assets`	`GET /api/v1/geo/countries`	`list_asset_companies`
`get-assets-in-an-area`	`GET /api/v1/geo/features`	`search_assets`
`get-asset-detail`	`GET /api/v1/geo/features/{key}`	`get_asset`
`get-asset-alt-data`	`GET /api/v1/geo/features/{key}/data`	`get_asset`
`get-live-vessels`	`GET /api/v1/tracking/vessels`	REST / CLI
`get-vessel-detail`	`GET /api/v1/tracking/vessels/{mmsi}`	REST / CLI
`get-live-aircraft`	`GET /api/v1/tracking/aircraft`	REST / CLI
`get-aircraft-detail`	`GET /api/v1/tracking/aircraft/{icao24}`	REST / CLI
`get-chokepoint-transits`	`GET /api/v1/tracking/chokepoints`	REST / CLI
`get-port-activity`	`GET /api/v1/tracking/ports/{key}`	REST / CLI
`get-airport-activity`	`GET /api/v1/tracking/airports/{key}`	REST / CLI
`get-live-feeds`	`GET /api/v1/tracking/sources`	REST / CLI
`get-company-live-fleet`	`GET /api/v1/companies/{id}/fleet`	REST / CLI
`get-capital-structure`	`GET /api/v1/companies/{id}/capital-structure`	`get_company`
`get-overview-series`	`GET /api/v1/companies/{id}/overview-series`	`get_company`
`get-monthly-revenue`	`GET /api/v1/companies/{id}/monthly-revenue`	`get_monthly_revenue`
`get-dividends`	`GET /api/v1/companies/{id}/dividends`	`get_dividends`
`get-earnings-calendar`	`GET /api/v1/companies/{id}/calendar`	`get_calendar`
`get-earnings-calendar-all-companies`	`GET /api/v1/earnings/calendar`	`get_calendar`
`post-call-recordings-for-calendar-events`	`POST /api/v1/earnings/calendar/recordings`	REST / CLI
`get-earnings-date-detail`	`GET /api/v1/earnings/calendar/{id}`	`get_calendar_event`
`get-live-earnings-calls`	`GET /api/v1/earnings/live`	`get_calendar`
`get-economic-calendar`	`GET /api/v1/economic/calendar`	`get_calendar`
`get-economic-release-detail`	`GET /api/v1/economic/calendar/{id}`	`get_calendar_event`
`get-corporate-events-calendar`	`GET /api/v1/corporate/calendar`	`get_calendar`
`get-congressional-calendar`	`GET /api/v1/congressional/calendar`	`get_calendar`
`get-congressional-meeting`	`GET /api/v1/congressional/calendar/{id}`	`get_calendar_event`
`get-management-votes`	`GET /api/v1/companies/{id}/management`	`get_management`
`get-ownership-summary`	`GET /api/v1/companies/{id}/ownership`	`get_ownership`
`get-insider-transactions`	`GET /api/v1/companies/{id}/ownership/transactions`	`get_ownership`
`get-insider-position-history`	`GET /api/v1/companies/{id}/ownership/insider-history`	`get_ownership`
`get-foreign-ownership-history`	`GET /api/v1/companies/{id}/ownership/nationality-history`	`get_ownership`
`get-company-signals`	`GET /api/v1/companies/{id}/signals`	`get_company`
`get-company-scorecard`	`GET /api/v1/companies/{id}/scorecard`	`get_guidance`
`get-earnings-overview`	`GET /api/v1/companies/{id}/earnings/overview`	`get_earnings`
`get-guidance-commitments`	`GET /api/v1/companies/{id}/earnings/promises`	`get_guidance`
`get-guidance-scorecard`	`GET /api/v1/companies/{id}/earnings/scorecard`	`get_guidance`
`get-transcript-index`	`GET /api/v1/companies/{id}/transcripts`	`list_transcripts`, `get_transcript`
`get-transcript-text`	`GET /api/v1/companies/{id}/transcripts/{transcriptId}`	`get_transcript`
`get-transcript-annotations`	`GET /api/v1/companies/{id}/transcripts/{transcriptId}/annotations`	`get_transcript`
`get-transcript-search`	`GET /api/v1/transcripts/search`	`search_transcripts`
`get-transcript-search-summary`	`GET /api/v1/transcripts/search/summary`	`search_transcripts`
`get-transcript-topic-analysis`	`GET /api/v1/transcripts/search/topics`	`analyze_transcript_topics`
`get-transcript-geography-options`	`GET /api/v1/transcripts/search/facets`	`search_transcripts`
`get-mentioned-by`	`GET /api/v1/companies/{id}/mentioned-by`	`get_mentioned_by`
`get-mentioned-by-summary`	`GET /api/v1/companies/{id}/mentioned-by/summary`	`get_mentioned_by`
`get-observations`	`GET /api/v1/companies/{id}/observations`	`get_events`, `get_event_facts`
`get-ir-presentations`	`GET /api/v1/companies/{id}/presentations`	`get_presentations`
`get-presentation-guidance`	`GET /api/v1/companies/{id}/presentation-guidance`	`get_guidance`, `get_presentations`
`get-market-events`	`GET /api/v1/companies/{id}/market-events`	`get_market_events`
`get-presentation-page-image`	`GET /api/v1/companies/{id}/presentations/{presentationId}/pages/{page}`	REST / CLI
`get-compute-exposure`	`GET /api/v1/companies/{id}/compute`	REST / CLI
`get-latest-filings`	`GET /api/v1/filings`	`list_filings`
`get-filing-by-accession`	`GET /api/v1/filings/{accession}`	`get_document_text`
`get-latest-events`	`GET /api/v1/events/latest`	REST / CLI
`get-event-wire`	`GET /api/v1/events/wire`	`get_events`
`get-news-feed`	`GET /api/v1/news/feed`	`get_news`
`get-news-story`	`GET /api/v1/news/items/{id}`	`get_news`
`get-search-news`	`GET /api/v1/news/search`	`get_news`
`get-news-topics`	`GET /api/v1/news/topics`	`get_news`
`get-news-sources`	`GET /api/v1/news/sources`	`get_news`
`get-top-news`	`GET /api/v1/news/top`	`get_news`
`get-news-stream-sse`	`GET /api/v1/news/stream`	REST / CLI
`get-company-news`	`GET /api/v1/companies/{id}/news`	`get_news`
`get-list-countries`	`GET /api/v1/countries`	`list_countries`
`get-gdp-sparklines`	`GET /api/v1/countries/gdp-sparklines`	REST / CLI
`get-country-dashboard`	`GET /api/v1/countries/{iso}`	`get_country`, `get_economy`, `get_central_bank`, `list_macro_series`, `get_macro_series`, `get_government`
`get-regional-macro-series`	`GET /api/v1/countries/{iso}/regions`	`get_country`, `list_macro_series`
`get-macro-series`	`GET /api/v1/countries/{iso}/series`	`get_macro_series`
`get-macro-series-by-id`	`GET /api/v1/macro/series/{seriesId}`	`get_macro_series`
`get-executive-orders`	`GET /api/v1/countries/{iso}/government/executive-orders`	`get_government`
`get-executive-order-monthly-counts`	`GET /api/v1/countries/{iso}/government/executive-orders/monthly`	`get_government`
`get-legislation-monthly-counts`	`GET /api/v1/countries/{iso}/government/bills/monthly`	`get_government`
`get-government-entities`	`GET /api/v1/countries/{iso}/government/entities`	`get_government`
`get-government-entity`	`GET /api/v1/countries/{iso}/government/entities/{code}`	`get_government`
`get-government-entity-series`	`GET /api/v1/countries/{iso}/government/entities/{code}/series`	`list_macro_series`
`get-government-entity-logo`	`GET /api/v1/countries/{iso}/government/entities/{code}/logo`	REST / CLI
`get-government-data`	`GET /api/v1/countries/{iso}/government/{view}`	`get_government`
`get-judiciary-data`	`GET /api/v1/countries/{iso}/judiciary/{view}`	`get_government`
`get-office-changes`	`GET /api/v1/countries/{iso}/officials/changes`	`get_government`
`get-presidential-schedule`	`GET /api/v1/countries/{iso}/officials/schedule`	REST / CLI
`get-country-officials`	`GET /api/v1/countries/{iso}/officials`	`get_government`
`get-federal-reserve-financials`	`GET /api/v1/countries/{iso}/fed-financials`	`get_central_bank`, `get_central_bank_financials`
`get-federal-reserve-financial-notes`	`GET /api/v1/countries/{iso}/fed-financials/notes`	`get_central_bank_financials`
`get-armed-conflicts`	`GET /api/v1/military/conflicts`	`list_conflicts`
`get-country-armed-forces`	`GET /api/v1/military/countries/{iso2}`	REST / CLI
`get-country-conflicts`	`GET /api/v1/military/countries/{iso2}/conflicts`	REST / CLI
`get-international-organisations`	`GET /api/v1/foreign-relations/organisations`	`get_organisation`
`get-organisation-and-country`	`GET /api/v1/foreign-relations/organisations/{code}/countries/{iso2}`	`get_organisation`
`get-policy-text-overview`	`GET /api/v1/countries/{iso}/policy-text`	`get_central_bank`
`get-policy-documents`	`GET /api/v1/countries/{iso}/policy-text/documents`	`get_central_bank`, `search_policy_text`
`get-policy-document`	`GET /api/v1/countries/{iso}/policy-text/documents/{documentId}`	`get_policy_document`
`get-beige-book-districts`	`GET /api/v1/countries/{iso}/policy-text/districts`	`get_central_bank`
`get-policy-guidance`	`GET /api/v1/countries/{iso}/policy-text/guidance`	`get_central_bank`
`get-list-benchmarks`	`GET /api/v1/indices`	REST / CLI
`get-benchmark-sparklines`	`GET /api/v1/indices/sparklines`	REST / CLI
`get-benchmark-detail`	`GET /api/v1/indices/{symbol}`	REST / CLI
`get-benchmark-prices`	`GET /api/v1/indices/{symbol}/prices`	REST / CLI
`get-list-commodities-compute`	`GET /api/v1/commodities`	`get_market_board`
`get-commodity-fundamentals`	`GET /api/v1/commodities/fundamentals`	`get_commodity_analytics`
`get-commodity-market-map`	`GET /api/v1/commodities/market-map`	`get_commodity_analytics`
`get-commodity-futures-curves`	`GET /api/v1/commodities/futures`	REST / CLI
`get-commodity-spreads-ratios`	`GET /api/v1/commodities/spreads`	`get_commodity_analytics`
`get-commodity-positioning-cftc-cot`	`GET /api/v1/commodities/positioning`	`get_commodity_analytics`
`get-instrument-detail`	`GET /api/v1/commodities/{symbol}`	`get_market_series`
`get-instrument-prices`	`GET /api/v1/commodities/{symbol}/prices`	`get_market_series`
`get-instrument-mentions`	`GET /api/v1/commodities/{symbol}/mentions`	`get_commodity_analytics`
`get-fx-reference-rates`	`GET /api/v1/fx`	`get_market_board`
`get-fx-pair-prices`	`GET /api/v1/fx/pairs/{pair}/prices`	`get_market_series`
`get-people-registry`	`GET /api/v1/people`	`search_people`
`get-person-profile`	`GET /api/v1/people/{cik}`	`get_person`
`get-person-photo`	`GET /api/v1/people/{cik}/photo`	REST / CLI
`get-person-transactions`	`GET /api/v1/people/{cik}/transactions`	`get_person`
`get-executive-leaderboard`	`GET /api/v1/scorecards/executives`	`get_guidance`
`get-executive-scorecard`	`GET /api/v1/scorecards/executives/{name}`	`get_guidance`
`get-scored-earnings-events`	`GET /api/v1/scorecards/events`	`get_guidance`
`get-scored-event-detail`	`GET /api/v1/scorecards/events/{id}`	`get_guidance`
`get-narrative-pulse`	`GET /api/v1/intelligence/pulse`	`list_themes`
`get-list-narratives`	`GET /api/v1/intelligence/narratives`	`list_themes`
`get-narrative-filter-options`	`GET /api/v1/intelligence/narratives/facets`	`list_themes`, `get_company_themes`
`get-narrative-detail`	`GET /api/v1/intelligence/narratives/{id}`	`get_theme`
`get-company-intelligence`	`GET /api/v1/intelligence/company/{id}`	REST / CLI
`get-company-claims`	`GET /api/v1/intelligence/company/{id}/claims`	REST / CLI
`get-company-themes`	`GET /api/v1/intelligence/company/{id}/themes`	`get_company_themes`
`get-company-intelligence-presence`	`GET /api/v1/intelligence/company/{id}/presence`	REST / CLI
`get-transcript-audio`	`GET /api/v1/companies/{id}/transcripts/{transcriptId}/audio`	REST / CLI
`get-transcript-video`	`GET /api/v1/companies/{id}/transcripts/{transcriptId}/video/{file}`	REST / CLI
`get-tab-presence`	`GET /api/v1/companies/{id}/tab-presence`	REST / CLI
`post-chart-series`	`POST /api/v1/charting/series`	`get_chart_series`
`get-series-catalog`	`GET /api/v1/correlation/catalog`	`get_chart_series`
`get-central-bank-documents`	`GET /api/v1/companies/{id}/central-bank`	`get_government_exposure`
`get-law-document-pdf`	`GET /api/v1/companies/{id}/laws/{docId}/document`	REST / CLI
`get-fed-financial-statement-document`	`GET /api/v1/countries/{iso}/fed-financials/documents/{docId}`	REST / CLI
`get-policy-document-file-pdf`	`GET /api/v1/countries/{iso}/policy-text/documents/{documentId}/file`	REST / CLI
`get-transcript-timeline`	`GET /api/v1/companies/{id}/transcripts/{transcriptId}/timeline`	`get_transcript`
`get-earnings-calendar-coverage`	`GET /api/v1/earnings/coverage`	`get_calendar`
`get-topic-trends-on-calls`	`GET /api/v1/transcripts/topic-trends`	REST / CLI
`get-featured-narratives`	`GET /api/v1/intelligence/narratives/featured`	REST / CLI
`get-narrative-sparklines`	`GET /api/v1/intelligence/narratives/metrics`	REST / CLI
`get-observation-context`	`GET /api/v1/intelligence/observations/{id}/context`	`get_central_bank`

Getting started

Coverage

Data

Concepts

Guides

For AI agents

MCP tools

API operations

​MCP tools

​API operations

MCP tools

API operations