stefanoamorelli/sec-edgar-mcp

A SEC EDGAR MCP (Model Context Protocol) Server

342 ★95 forksPythonUpdated 2d ago

What you need to know

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

Install

docker run -i --rm -e SEC_EDGAR_USER_AGENT=Your Name (your@email.com) stefanoamorelli/sec-edgar-mcp:latest
pip / conda / uv installs documented at sec-edgar-mcp.amorelli.tech

Usage

  • Configure the docker command in your MCP client's mcpServers (the -i flag is required for MCP JSON-RPC)
  • Company tools: CIK lookup, company info, company facts
  • Filings tools: 10-K, 10-Q, 8-K retrieval and section extraction
  • Financials: balance sheet, income statement, cash flow (XBRL-parsed); Insider trading: Form 3/4/5 transactions
  • For web platforms like Dify, run streamable HTTP instead: python -m sec_edgar_mcp.server --transport streamable-http --port 9870

Key features

  • Access to SEC filings, financial statements, and insider-trading data with exact numeric precision
  • All responses include SEC filing URLs for verification
  • Built on edgartools; ships a promptfoo-based evaluation suite (evals/)
  • Supports stdio (default) and streamable-http transports
  • Python 3.11+; published on PyPI and Conda

Best for

Analyzing US public company filings and financials from AI assistants, especially when numeric precision and source verification matter.

Caveats

  • Not affiliated with or endorsed by the SEC
  • Requires SEC_EDGAR_USER_AGENT (Name + email) per SEC API policy
  • HTTP transport has no authentication — README says use only on private networks
  • AGPL-3.0 licensed (commercial licensing via email)
Clients: Dify · General MCP clients
Documentation ↗

Reviewed 2026-08-07

Topics

aiartificial-intelligenceedgaredgar-databasefinancegenaillmmcpmcp-servermodel-context-protocolmodel-context-protocol-server
View on GitHub ↗
Stars
342★
Forks
95
Language
Python
License
AGPL-3.0
Created
2025-04-01
Last push
2026-08-05