io.github.stefanoamorelli/sec-edgar-mcp

Name: io.github.stefanoamorelli/sec-edgar-mcp
Rating: 5 (268 reviews)
Author: stefanoamorelli

平台与服务

by stefanoamorelli

基于 US SEC EDGAR API 的 MCP server，可访问美国 SEC 公开披露文件，支持检索与读取申报数据。

做美股研究或合规分析时，它能通过 MCP 直连 SEC EDGAR，快速检索并读取申报文件，比手动翻公开披露高效得多

268GitHub

什么是 io.github.stefanoamorelli/sec-edgar-mcp？

基于 US SEC EDGAR API 的 MCP server，可访问美国 SEC 公开披露文件，支持检索与读取申报数据。

README

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/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.

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:

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

常见问题