SEC EDGAR MCP

SEC filings and XBRL financials as MCP tools, under AGPL or a paid commercial licence.

by Stefano Amorelli

Last updated

Visit SEC EDGAR MCP
From
Free
Licence
AGPL-3.0-or-later
Self-hosted
Yes
Platforms
CLI, Library

What it is

An MCP server that puts SEC EDGAR behind twenty-one tools an assistant can call: ticker-to-CIK lookup, filings by form type and date, 10-K and 10-Q section extraction, an 8-K item reader, XBRL financial statements and segment data, and Forms 3, 4 and 5 parsed into insider transactions. It ships as a Python package, a console script and a Docker image.

EDGAR is free and public, so the parsing is the product: XBRL figures arrive as the exact values filed rather than as numbers a model read off a document, a 40,000-word 10-K reaches the context window as the one section asked for, and every response carries the filing URL.

Pricing

Free to run; the licence is the commercially material fact. The code is AGPL-3.0 — use it, modify it, ship it commercially, but network-serve a modified version and its users are owed that modified source under the same licence. Running the stock server inside your own company triggers nothing. A commercial licence covering the same code without the copyleft obligation is negotiated by email; no price list exists.

Data & coverage

US filers only, because that is what EDGAR holds, and no prices or quotes of any kind. Structured parsing covers 10-K, 10-Q, 8-K and Forms 3/4/5; anything else comes back as raw text. Calls go live to the SEC with a local cache, so a filing is available as soon as EDGAR publishes it.

Integrations

Any MCP client over stdio. A streamable-HTTP transport exists for platforms like Dify and ships no authentication, which makes it a private-network deployment rather than a public endpoint. SEC_EDGAR_USER_AGENT with a real name and email is required — the SEC blocks requests without it — and the rate limit defaults to the SEC's ceiling of ten requests per second.

Limitations

  • No section extraction for foreign-issuer forms (20-F, 40-F), proxies (DEF 14A) or 13F holdings.
  • No full-text search across filings; you filter by company, form type and date, then read.
  • Nothing cross-company: no screening, no ranking, no comparison across filers.
  • One maintainer. Version 1.1.0 shipped 20 August 2026, the last commit to main landed 21 August 2026, 357 stars and three open issues — alive, not staffed.
  • AGPL-3.0 is a real constraint for anyone embedding it in a hosted product, and the alternative is an unpublished price.

Alternatives

Other EDGAR MCP servers carry more permissive licences — cyanheads/secedgar-mcp-server under Apache-2.0, edgartools-mcp under MIT — both far smaller. For parsed fundamentals rather than filings, an API such as Financial Modeling Prep or Intrinio normalises them for a subscription.

Specs

Interfaces
Python, MCP server
Export
JSON
Asset classes
Stocks
Markets
US
Platforms
CLI, Library
AI features
None
Pricing verified
Capabilities verified
Coverage verified

Also worth comparing

  • AI Hedge Fund — LLM investor personas score a ticker, deterministic code sizes the book, nothing trades.
  • FinGPT — Financial LLM adapters, instruction datasets and training notebooks, all MIT.
  • MaverickMCP — Thirty-seven stock-analysis tools for any MCP client, on Yahoo data and no key.
  • TradingAgents — Analyst, bull, bear, risk and portfolio-manager agents argue over one ticker.
  • Vibe-Trading — A local finance research agent with 74 MCP tools, nine backtest engines and 14 brokers.
  • Equibles — Scrapes SEC, FINRA, FRED and CFTC data into your own Postgres and serves it over MCP.

FAQ

EDGAR is already free — what does this add over calling it directly?

The fetching you could write yourself; the parsing is the work. It resolves a ticker to a CIK, reads XBRL company facts as exact filed values rather than letting a model read numbers out of a document, splits a 10-K or 10-Q into business, risk factors and MD&A so only the relevant section reaches the context window, and turns Forms 3, 4 and 5 into structured transactions. Every response carries the SEC filing URL for checking.

Can I use it inside a closed-source commercial product?

Not under the default licence. It is AGPL-3.0, so modifying it and exposing it over a network obliges you to offer users that modified source. Running the unmodified server internally is fine. A separate commercial licence removes the obligation and is arranged by email with the author; no price is published.

Do I need an API key?

No. EDGAR is free and public. You must set SEC_EDGAR_USER_AGENT to your real name and email — the SEC blocks requests without it — and stay inside the SEC's ceiling of ten requests per second, which is the server's default setting.

Which filings does it actually parse?

Section extraction covers 10-K and 10-Q, with a dedicated reader for 8-K items and Forms 3, 4 and 5, plus XBRL financial statements and concepts. Other forms — 20-F, DEF 14A, 13F, S-1 — come back as raw filing text you page through yourself.