Content
# SEC EDGAR MCP
<p align="center">
<a href="https://pypi.org/project/sec-edgar-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/sec-edgar-mcp.svg" /></a>
<a href="https://anaconda.org/stefanoamorelli/sec-edgar-mcp"><img alt="Conda Version" src="https://img.shields.io/conda/vn/stefanoamorelli/sec-edgar-mcp.svg" /></a>
<img alt="Python: 3.11+" src="https://img.shields.io/badge/python-3.11+-brightgreen.svg" />
<img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" />
<a href="https://mseep.ai/app/0132880c-5e83-410b-a1d5-d3df08ed7b5c"><img alt="Verified on MseeP" src="https://mseep.ai/badge.svg" /></a>
<a href="https://doi.org/10.5281/zenodo.17123166"><img alt="DOI" src="https://zenodo.org/badge/DOI/10.5281/zenodo.17123166.svg" /></a>
<a href="https://github.com/stefanoamorelli/sec-edgar-mcp/actions/workflows/evals.yml"><img alt="Evals" src="https://github.com/stefanoamorelli/sec-edgar-mcp/actions/workflows/evals.yml/badge.svg" /></a>
</p>
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
<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](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
<a href="https://github.com/stefanoamorelli/sec-edgar-mcp/graphs/contributors">
<img src="https://contrib.rocks/image?repo=stefanoamorelli/sec-edgar-mcp" />
</a>
## Citation
If you use this software in research, please cite it:
[](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
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
markitdown
Python tool for converting files and office documents to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.