Sec Edgar Mcp

What is Sec Edgar Mcp about?

Sec Edgar Mcp offers an open‑source MCP server exposing a rich set of tools for accessing United States SEC EDGAR data. It allows AI assistants and other MCP‑compatible clients to query company information, recent filings, detailed financial statements, and insider‑transaction details directly from the official SEC repository.

How to use Sec Edgar Mcp?

1. Install the package (e.g., via pip install sec-edgar-mcp).
2. Run the server with python -m sec_edgar_mcp.server --transport stdio (default) or specify another transport such as --transport http for HTTP/SSE integration.
3. Connect any MCP‑compatible client (LLM, CLI, Dify, etc.) to the server endpoint.
4. Discover available tools via the MCP protocol and invoke them with JSON‑RPC calls to retrieve data.

Key Features of Sec Edgar Mcp

• Comprehensive EDGAR toolset: company lookup, recent filings, full filing content, section extraction, financial statements, insider‑trading forms.
• Exact numeric precision: Direct XBRL parsing extracts financial figures without rounding.
• Deterministic, hallucination‑free responses: Strict processing rules ensure answers are based solely on SEC data.
• Filing references: Every response includes clickable SEC URLs for verification.
• Transport flexibility: Supports stdio, streamable HTTP, and SSE transports.
• Cross‑platform: Works on Windows, macOS, and Linux.

Use Cases of Sec Edgar Mcp

• Financial research assistants: AI agents can pull the latest 10‑K, 10‑Q, or 8‑K data for a ticker and summarize key metrics.
• Investment analysis platforms: Automate extraction of precise revenue, profit, or balance‑sheet numbers for quantitative models.
• Regulatory compliance tools: Retrieve insider‑transaction forms (3, 4, 5) to monitor insider activity.
• Educational bots: Teach finance students by allowing them to query real filing content.
• Data pipelines: Integrate SEC data into downstream analytics or reporting services via MCP.

FAQ from the Sec Edgar Mcp

Q: Do I need an API key to use the server? A: No. The server accesses the public SEC EDGAR REST API and public XBRL files without authentication.

Q: Which transport should I choose for production? A: Use --transport http or --transport sse for HTTP‑based integrations; stdio is convenient for local testing and CLI tools.

Q: Can I customize the tool set? A: Yes. The server is built on FastMCP; you can extend or modify tools by editing server.py and adding custom handlers.

Q: Is the data real‑time? A: The server fetches the latest filings from the SEC at request time, so responses reflect the most recent public data.

Q: How is licensing handled? A: The project is licensed under AGPL‑3.0. Commercial licensing options are available by contacting the author.

SEC EDGAR MCP

https://github.com/user-attachments/assets/d310eb42-b3ca-467d-92f7-7d132e6274fe

[!IMPORTANT] EDGAR® and SEC® are trademarks of the U.S. Securities and Exchange Commission. This open-source project is not affiliated with or approved by the U.S. Securities and Exchange Commission.

Introduction 📣

SEC EDGAR MCP is an open-source MCP server that connects AI models to the rich dataset of SEC EDGAR filings. EDGAR (Electronic Data Gathering, Analysis, and Retrieval) is the U.S. SEC's primary system for companies to submit official filings. It contains millions of filings and "increases the efficiency, transparency, and fairness of the securities markets" by providing free public access to corporate financial information. This project makes that trove of public company data accessible to AI assistants (LLMs) for financial research, investment insights, and corporate transparency use cases.

Using the Model Context Protocol (MCP) – an open standard that "enables seamless integration between LLM applications and external data sources and tools" – the SEC EDGAR MCP server exposes a comprehensive set of tools for accessing SEC filing data. Under the hood, it leverages the EdgarTools Python library to fetch data from official SEC sources and performs direct XBRL parsing for exact financial precision. This means an AI agent can ask questions like "What's the latest 10-K filing for Apple?" or "Show me Tesla's exact revenue from their latest 10-K" and the MCP server will retrieve the answer directly from EDGAR's official data with complete accuracy and filing references.

[!TIP] If you use this software, please cite it following CITATION.cff, or the following APA entry:

Amorelli, Stefano (2025). SEC EDGAR MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/sec-edgar-mcp

Usage 🚀

Once the SEC EDGAR MCP server is running, you can connect to it with any MCP-compatible client (such as an AI assistant or the MCP CLI tool). The client will discover the available EDGAR tools and can invoke them to get real-time data from SEC filings. For example, an AI assistant could use this server to fetch a company's recent filings or query specific financial metrics without manual web searching.

For comprehensive guides, examples, and tool documentation, visit the SEC EDGAR MCP Documentation.

Demo: Here's a demonstration of an AI assistant using SEC EDGAR MCP to retrieve Apple's latest filings and financial facts (click to view the video):

In the demo above, the assistant uses SEC EDGAR MCP tools to retrieve Apple's filings and financial data, showcasing how EDGAR information is fetched and presented in real-time with exact precision and filing references. 📊

Documentation 📚

For installation and setup instructions, visit the SEC EDGAR MCP Quickstart Guide. For complete tool documentation, usage examples, and configuration guides, visit the SEC EDGAR MCP Documentation.

Architecture 🏗️

The SEC EDGAR MCP server acts as a middleman between an AI (MCP client) and the SEC's EDGAR backend:

• 🔸 MCP Client: Could be an AI assistant (like Claude or other MCP-compatible tools) or any app that speaks the MCP protocol. The client sends JSON-RPC requests to invoke tools and receives JSON results.

• 🔸 MCP Server (SEC EDGAR MCP): This server defines comprehensive EDGAR tools and handles incoming requests. It features:

  • Company Tools: CIK lookup, company information, and company facts
  • Filing Tools: Recent filings, filing content, 8-K analysis, and section extraction
  • Financial Tools: Financial statements with direct XBRL parsing for exact precision
  • Insider Trading Tools: Form 3/4/5 analysis with detailed transaction data

• 🔸 EDGAR Data Sources: The server uses the edgartools Python library to access:

  • SEC EDGAR REST API: Official SEC endpoint for company data and filing metadata
  • Direct XBRL Parsing: Extracts financial data directly from SEC filings using regex patterns for exact numeric precision
  • Filing Content: Downloads and parses complete SEC filing documents (.txt format)

Key Features:

• Deterministic Responses: All tools include strict instructions to prevent AI hallucination and ensure responses are based only on SEC filing data
• Exact Precision: Financial data maintains exact numeric precision (no rounding) as filed with the SEC
• Filing References: Every response includes clickable SEC URLs for independent verification
• Flexible XBRL Extraction: Uses pattern matching to find financial concepts without hardcoded mappings

How it works: The MCP client discovers available tools (company lookup, financial statements, insider transactions, etc.). When invoked, each tool fetches data from SEC sources, applies deterministic processing rules, and returns structured JSON with filing references. This ensures AI responses are accurate, verifiable, and based solely on official SEC data.

Integrations

In its current form, the MCP server is configured to use the stdio transport. Integrations with platforms such as Dify will require switching to streamable HTTP, or possibly SSE depending on the required backwards compatibility). This can be done by passing a different --transport argument to server.py. However, it may also require editing server.py, because other arguments such as host may need to be passed to the FastMCP constructor.

References 📚

• SEC EDGAR – About EDGAR, SEC.gov (2024). EDGAR is the SEC's database for electronic company filings.

• Model Context Protocol (MCP) – Official documentation and SDKs. ModelContextProtocol.io – An open standard for connecting LLMs to tools.

• EdgarTools – A modern Python library for accessing SEC EDGAR data with powerful filing analysis capabilities. GitHub repo, Documentation.

Contributors 🤝

A big thank you to all the contributors who have helped make this project better!

License ⚖️

This open-source project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means:

• You can use, modify, and distribute this software
• If you modify and distribute it, you must release your changes under AGPL-3.0
• If you run a modified version on a server, you must provide the source code to users
• See the LICENSE file for full details

For commercial licensing options or other licensing inquiries, please contact stefano@amorelli.tech.

---

© 2025 Stefano Amorelli – Released under the GNU Affero General Public License v3.0. Enjoy! 🎉