English Français العربية

io.github.stefanoamorelli/sec-edgar-mcp

Registre officiel Autres

SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package sec-edgar-mcp
Claude Code 
claude mcp add sec-edgar-mcp -e 'SEC_EDGAR_USER_AGENT=<SEC_EDGAR_USER_AGENT>' -- uvx sec-edgar-mcp==1.0.5
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sec-edgar-mcp": {
            "command": "uvx",
            "args": [
                "sec-edgar-mcp==1.0.5"
            ],
            "env": {
                "SEC_EDGAR_USER_AGENT": "<SEC_EDGAR_USER_AGENT>"
            }
        }
    }
}

Variables d'environnement

  • SEC_EDGAR_USER_AGENT obligatoire The user agent to access the SEC EDGAR API

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. SEC EDGAR MCP
  2. Quick Start
  3. Tools
  4. HTTP Transport
  5. Evaluations
  6. Documentation
  7. Contributors
  8. Citation
  9. License

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

CategoryTools
CompanyCIK lookup, company info, company facts
Filings10-K, 10-Q, 8-K retrieval, section extraction
FinancialsBalance sheet, income statement, cash flow (XBRL-parsed)
Insider TradingForm 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

Questions fréquentes

Qu'est-ce que io.github.stefanoamorelli/sec-edgar-mcp ?

SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API

Comment installer io.github.stefanoamorelli/sec-edgar-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sec-edgar-mcp -e 'SEC_EDGAR_USER_AGENT=<SEC_EDGAR_USER_AGENT>' -- uvx sec-edgar-mcp==1.0.5. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.stefanoamorelli/sec-edgar-mcp ?

Oui. Il attend SEC_EDGAR_USER_AGENT, à renseigner dans sa configuration.

io.github.stefanoamorelli/sec-edgar-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence AGPL-3.0.

Qui maintient io.github.stefanoamorelli/sec-edgar-mcp ?

Il est publié par stefanoamorelli. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.