Back to search
sec-edgar-mcp
SkillGitHub
A SEC EDGAR MCP (Model Context Protocol) Server
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/stefanoamorelli--sec-edgar-mcp)HTML
<a href="/listings/stefanoamorelli--sec-edgar-mcp"><img src="/api/listings/stefanoamorelli--sec-edgar-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
{
"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](https://sec-edgar-mcp.amorelli.tech/setup/quickstart).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 112 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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>
- <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://doi.org/10.5281/zenodo.17123165"><img alt="DOI" src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.17123165-blue.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 [sec-edgar-toolkit](https://github.com/stefanoamorelli/sec-edgar-toolkit).
- 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, 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.