SEC EDGAR
SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
uvx sec-edgar-mcp
MCP client config
{
"mcpServers": {
"sec-edgar": {
"command": "uvx",
"args": [
"sec-edgar-mcp"
]
}
}
}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 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
{
"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:
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.
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:
@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
