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

io.github.stefanoamorelli/sec-edgar-mcp (SEC EDGAR MCP)

The SEC EDGAR MCP server provides access to US public filings through the US SEC EDGAR API. It is an MCP server (“model-context-protocol-server”) focused on retrieving and exposing EDGAR-related data for use with Model Context Protocol clients.

🛠️ Key Features

Access to US public filings via the US SEC EDGAR API
MCP server implementation (model-context-protocol, mcp, mcp-server)

🚀 Use Cases

Querying and integrating SEC EDGAR filing data for finance-focused applications
Supporting GenAI/LLM workflows that require structured public regulatory filings (genai, llm, ai)

⚡ Developer Benefits

Topics aligned with MCP and Model Context Protocol: model-context-protocol, model-context-protocol-server, mcp-server
Python-focused packaging indicated by Python 3.11+ (from the included readme excerpt)

⚠️ Limitations

Tool-level capabilities and tool count are not provided in the provided source data.

Topics

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

README.md4 KBView on GitHub

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:

DOI

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

Add to VS Code Add to Cursor

claude_desktop_config.json