mcp-edgar

An MCP (Model Context Protocol) server that gives LLMs direct access to SEC EDGAR — search filings, extract sections, pull structured financials, and track insider transactions.

No API key required. SEC EDGAR is entirely public.

Quick Start

Add to your MCP client config (Claude Code, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "sec-edgar": {
      "command": "npx",
      "args": ["-y", "mcp-edgar"]
    }
  }
}

That's it. No configuration needed.

Tools

Filing Discovery

Filing Content

Structured Financial Data (XBRL)

Insider Transactions

Example Prompts

Once connected, you can ask your LLM:

• "What are NVIDIA's most recent 10-K filings?"

• "Extract the Risk Factors section from Apple's latest annual report"

• "Show me Tesla's revenue trend over the last 5 years"

• "Who has been buying or selling MSFT stock recently?"

• "Find all SEC filings mentioning 'GLP-1 receptor agonist' in 2024"

• "Compare Amazon and Google's R&D spending over the past 3 years"

• "What's Pfizer's SIC industry code and fiscal year end?"

Typical Workflow

Most analysis follows this pattern:

1. edgar_company_info    → Get company overview and CIK
2. edgar_search          → Find specific filings (10-K, 10-Q, 8-K)
3. edgar_get_section     → Read MD&A, Risk Factors, etc.
4. edgar_company_facts   → Pull structured financials for comparison
5. edgar_insider_transactions → Check insider activity

Environment Variables

Rate Limiting

The server includes a built-in rate limiter (10 requests/sec) to comply with SEC's fair access policy. No configuration needed.

Development

git clone https://github.com/cmanohar/mcp-edgar.git
cd mcp-edgar
npm install
npm run build
node dist/index.js  # runs on stdio

How It Works

This server wraps three SEC EDGAR APIs:

• Submissions API (data.sec.gov/submissions/) — company info, filing history

• XBRL API (data.sec.gov/api/xbrl/) — structured financial data

• EFTS (efts.sec.gov/LATEST/) — full-text search across all filings

• Archives (sec.gov/Archives/edgar/) — raw filing documents (HTML, XML)

All APIs are free, public, and require no authentication — just a descriptive User-Agent header.

License

MIT