io.github.stefanoamorelli/sec-edgar-mcp

Official

by stefanoamorelli · Python

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

Provides access to US SEC EDGAR financial filings and regulatory data.

Topics

edgaredgar-databasefinancegenaillmmcpmcp-serveraiartificial-intelligencemodel-context-protocolmodel-context-protocol-server

README.md4 KBView on GitHub

SEC EDGAR MCP

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 edgartools.

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

<details> <summary>See demo video</summary> <a href="https://www.loom.com/share/17fcd7d891fe496f9a6b8fb85ede66bb"> <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/17fcd7d891fe496f9a6b8fb85ede66bb-7f8590d1d4bcc2fb-full-play.gif"> </a> </details>

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, conda, 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

Install

Configuration

Environment variables

SEC_EDGAR_USER_AGENTrequired

The user agent to access the SEC EDGAR API

claude_desktop_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "uvx",
      "args": [
        "sec-edgar-mcp"
      ],
      "env": {
        "SEC_EDGAR_USER_AGENT": "<YOUR_SEC_EDGAR_USER_AGENT>"
      }
    }
  }
}