# 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/dgunning/edgartools). 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, conda, uv), see the [documentation](https://sec-edgar-mcp.amorelli.tech/setup/quickstart). ## 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](https://dify.ai), 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](https://github.com/promptfoo/promptfoo)-based test suite. See [`evals/`](evals/) for details. ```bash cd evals && npm install && npm run eval ``` ## Documentation Full docs: [sec-edgar-mcp.amorelli.tech](https://sec-edgar-mcp.amorelli.tech/) ## Contributors

## Citation If you use this software in research, please cite it: [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17123166.svg)](https://doi.org/10.5281/zenodo.17123166) ```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](CITATION.cff) for additional formats. ## License [AGPL-3.0](LICENSE). For commercial licensing: stefano@amorelli.tech

Sec Edgar Mcp

Install

Sec Edgar Mcp

Install