Documentation
OpenFilings MCP — agentic analyst + filings
OpenFilings MCP is the global agentic financial analyst in your agent: get_company_analysis for our latest call and annual filing read, plus pre-computed KPIs so the model does not invent revenue — at https://api.openfilings.org/mcp.
This page covers what the server does. Ready to wire it up? Connect an agent →
The problem
An analyst or AI agent working across US, Japan, and Hong Kong faces fragmented portals, incompatible GAAP labels, and unstructured earnings-call narrative. Asking an LLM to read a 10-K PDF wastes tokens and risks invented revenue figures. OpenFilings MCP returns our analyst rollup plus canonical KPIs — revenue, operating income, net income, margins, cash flow — already harmonized and validated.
How it works
Your agent calls OpenFilings tools in plain language. Typical flow:
list_markets— markets enabled on your accountget_company_analysis— our analyst: latest call (Buy / Hold / Sell) plus annual filing red flagsget_company_financials— multi-year series in one call (fiscal_year_from/to,line_items, optionalas_of)- Or drill into one filing:
list_filings→get_company_financialswithas_of list_filing_sections/get_filing_section— MD&A, risk factors, business description
How fast is it?
Under a secondfor Golden KPIs on a filing we've already processed — typical in Claude, Cursor, or ChatGPT via MCP.
First request on a new Japanese or Korean report may take a few seconds while we fetch and normalize the official data. After that, it's cached for everyone.
Markets & sources
| market_id | Registry | Typical forms |
|---|---|---|
| us | SEC EDGAR | 10-K, 10-Q, 8-K, 20-F |
| jp | EDINET | Yūho, quarterly reports |
| hk | CNINFO · HKE | Annual, interim HK |
| kr | OpenDART | Annual, quarterly KR |
| cn | CNINFO · SZSE/SSE | Annual, interim CN |
| eu | ESEF · XBRL | Annual XBRL EU |
See filings as they land in Filings — same KPI normalization, no account required. Atom (RSS+) at /feed.xml.
MCP tools
Markets
list_markets— Markets in your plan (us, eu, fr, cn, hk, jp, kr, …).
Discovery
get_company_institutional_holders— Every Form 13F manager holding one listed issuer (not a top-N cut).get_company_people— Current officers and/or major shareholders for one listed issuer.get_entity— Return the full OpenFilings entity registry record (no filing fetch).get_filing— Resolve a stored filing or IR-site document by UUID.get_manager_13f_holdings— One Form 13F manager's latest book, largest positions first.get_person— Profile for one person/institution — every mandate, current and past.list_filings— Cross-market filing discovery: resolve entity, then list filings per market.search_person— Search officers, directors, and major shareholders (no filing quota).search_ticker— Resolve issuer identity from the OpenFilings entity catalogue (no filing fetch).
Financials
get_company_financials— Reported filing financials plus Street earnings calendar.get_company_supply_chain— Supplier↔customer graph for one issuer (named edges + anonymous concentration).
Market data
get_fx— Spot FX from cache (local currency units per 1 USD).get_macro— IMF World Economic Outlook as-filed vintage series (not policy rates).get_price_snapshot— All daily-close market data for one listing (not ticks, not order book).get_rates— Central-bank policy rates and sovereign yields (not FX).
Our analyst
get_company_analysis— Our analyst — company rollup (read-only, no live LLM).get_transcript— Full transcript body (``body`` field) + participants + linked filing.list_transcripts— Earnings call transcripts — Motley Fool / issuer-hosted IR PDF or webcast.
Narrative
get_filing_section— One section body (filing_id + section_key from list_filing_sections).list_filing_sections— Table of contents for a filing (filing_id required).
Lifecycle
list_corporate_events— Dated corporate lifecycle events, each backed by a filing.
Account
list_notifications— Your OpenFilings inbox — filing, press, and insider alerts for your account.
News
list_news— GlobeNewswire + Satelight press for an entity (metadata only).
Other
get_company_climate— As-filed greenhouse-gas figures, plus published climate targets when available.get_company_revenue_segments— As-filed sales by activity and by geography, with each line's share.get_disclosure_signals— One issuer's disclosure dossier — what its own notices add up to.screen_analyst_stance— Issuers by our analyst verdict on the latest primary call or annual filing.screen_climate— Issuers with a published climate target.screen_disclosure_signals— Issuers matching a disclosure pattern, or a kind, newest trigger first.screen_fx_moves— Largest stored currency moves over the requested window.screen_holders— Issuers whose current director, officer, or shareholder has been in place for N years.screen_index_moves— Largest stored index moves over the requested window.screen_insider_companies— Issuers with insider activity, one row per company.screen_issuers— Issuers matching every include and none of the excludes.screen_press— Issuers with a press release of this tier in the window, one card each.screen_rates— Countries whose policy rate or 10-year yield is high, or moved, over a chosen window.screen_red_flags— Issuers with a red flag in the window, one card each.screen_street— Issuers by analyst recommendation, one card each.
Example prompts
- “What is OpenFilings' latest view on NVDA? Use search_ticker then get_company_analysis with ticker=NVDA and market=us.”
- “Call list_markets, then get_company_financials for AAPL with fiscal_year_from=2020, fiscal_year_to=2024, line_items=ebitda.”
- “When is Palantir's next earnings? Use search_ticker then get_company_financials with ticker=PLTR and market_id=us — read the earnings block.”
- “List filings for Tencent (0700) on the Hong Kong market and summarize the latest annual report.”
- “Compare revenue and net income for AAPL vs MSFT from their latest 10-K filings.”
Free access & limits
OpenFilings MCP is free with daily and monthly usage limits — same quota pool as the REST API. list_markets does not count toward your limit. Monitor credits on Dashboard → Usage.