SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API.

🛠️ Key Features

Access to US public filings via the SEC EDGAR API
Model Context Protocol (MCP) server implementation
Topics: edgar, finance, mcp-server, ai, llm
Open-source tooling with Python 3.11+ compatibility
License: AGPL-3.0

🚀 Use Cases

Retrieve and contextualize SEC filings for downstream分析
Integrate EDGAR data into MCP-enabled pipelines
Support AI workflows requiring access to public financial filings
Use in model-context-protocol-based applications for compliance data

⚡ Developer Benefits

Clear MCP server implementation for SEC EDGAR data
Reusable components aligned with MCP conventions
Open-source distribution with PyPI and Conda availability
Well-suited for integration into ML/LLM workflows needing public filings

⚠️ Limitations

Limited to SEC EDGAR public filings via the EDGAR API
Licensing: AGPL-3.0 applies to the server software
Specific readme details may be truncated in excerpt; refer to repository for full docs

SEC EDGAR MCP

Python: 3.11+ License: AGPL-3.0

MCP server for accessing SEC EDGAR filings. Connects AI assistants to company filings, financial statements, and insider trading data with exact numeric precision.

Built on sec-edgar-toolkit.

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

See demo video

NOTE

This project is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. EDGAR and SEC are trademarks of the SEC.

Quick Start

json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEC_EDGAR_USER_AGENT=Your Name (your@email.com)",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

The -i flag is required for MCP's JSON-RPC communication.

For other installation methods (pip, uv), see the documentation.

Tools

Category	Tools
Company	CIK lookup, company info, company facts
Filings	10-K, 10-Q, 8-K retrieval, section extraction
Financials	Balance sheet, income statement, cash flow (XBRL-parsed)
Insider Trading	Form 3/4/5 transactions

All responses include SEC filing URLs for verification.

HTTP Transport

For platforms like Dify, use streamable HTTP instead of stdio:

bash

python -m sec_edgar_mcp.server --transport streamable-http --port 9870

No authentication is included. Use only on private networks.

Evaluations

Promptfoo-based test suite. See evals/ for details.

bash

cd evals && npm install && npm run eval

Documentation

Full docs: sec-edgar-mcp.amorelli.tech

Contributors

Citation

If you use this software in research, please cite it:

bibtex

@software{amorelli_sec_edgar_mcp_2025,
  title = {{SEC EDGAR MCP (Model Context Protocol) Server}},
  author = {Amorelli, Stefano},
  version = {1.0.6},
  year = {2025},
  month = {9},
  url = {https://doi.org/10.5281/zenodo.17123166},
  doi = {10.5281/zenodo.17123166}
}

See CITATION.cff for additional formats.

License

AGPL-3.0. For commercial licensing: stefano@amorelli.tech

io.github.stefanoamorelli/sec-edgar-mcp