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:

  1. list_markets — markets enabled on your account
  2. get_company_analysis — our analyst: latest call (Buy / Hold / Sell) plus annual filing red flags
  3. get_company_financials — multi-year series in one call (fiscal_year_from/to, line_items, optional as_of)
  4. Or drill into one filing: list_filings → get_company_financials with as_of
  5. 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_idRegistryTypical forms
usSEC EDGAR10-K, 10-Q, 8-K, 20-F
jpEDINETYūho, quarterly reports
hkCNINFO · HKEAnnual, interim HK
krOpenDARTAnnual, quarterly KR
cnCNINFO · SZSE/SSEAnnual, interim CN
euESEF · XBRLAnnual 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.