Skip to main content

SEC EDGAR MCP server for company filings and financial data

Project description

SEC EDGAR MCP

PyPI Conda Version Python: 3.11+ License: AGPL-3.0 Verified on MseeP DOI

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

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, 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:

python -m sec_edgar_mcp.server --transport streamable-http --port 9870

No authentication is included. Use only on private networks.

Documentation

Full docs: sec-edgar-mcp.amorelli.tech

Contributors

Citation

If you use this software in research, please cite it:

DOI

@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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sec_edgar_mcp-1.0.7.tar.gz (44.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sec_edgar_mcp-1.0.7-py3-none-any.whl (50.0 kB view details)

Uploaded Python 3

File details

Details for the file sec_edgar_mcp-1.0.7.tar.gz.

File metadata

  • Download URL: sec_edgar_mcp-1.0.7.tar.gz
  • Upload date:
  • Size: 44.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sec_edgar_mcp-1.0.7.tar.gz
Algorithm Hash digest
SHA256 a603f4f60ad97d734e44aea62511212ded30e70df37f194bc6488e7927d7e6bf
MD5 aa18b6f716691dc5dfc79c7894647eeb
BLAKE2b-256 bdf2d569b3e917e03a7e48ac5042dcefd22d1408d048f88f6e62622d5f872bee

See more details on using hashes here.

Provenance

The following attestation bundles were made for sec_edgar_mcp-1.0.7.tar.gz:

Publisher: publish_pypi.yml on stefanoamorelli/sec-edgar-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sec_edgar_mcp-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: sec_edgar_mcp-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 50.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sec_edgar_mcp-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 319af487e5cbfa6d972a43c78f3d42432d88552d9a6fe5cca986b97a3e9b0946
MD5 223880edfb076b59a4eac282d7255b77
BLAKE2b-256 89e9f1a2e63bef1e503493b43460736c60109f315c579e6daecebdb6d2b25fdd

See more details on using hashes here.

Provenance

The following attestation bundles were made for sec_edgar_mcp-1.0.7-py3-none-any.whl:

Publisher: publish_pypi.yml on stefanoamorelli/sec-edgar-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page