SEC EDGAR MCP server

SEC EDGAR MCP Server 🏛️

U.S. SEC filings and financial data for Claude Desktop and any MCP-compatible client, powered by SEC EDGAR. Search companies, pull filings (10-K, 10-Q, 8-K, Form 4, ...), read XBRL financials, and full-text search across all filings — all from natural language. No API key required.

npm package: edgar-mcp  ·  GitHub repo: danishashko/edgar-mcp.

🎯 What You Get

• 🔎 Company lookup by name or ticker → CIK
• 🗂️ Recent filings (any form type) with direct document links
• 📄 Latest filing of a type (newest 10-K / 10-Q / 8-K) in one call
• 💰 Financial highlights (revenue, net income, assets, equity, EPS) from XBRL
• 📈 Concept history — any GAAP line item over time
• 🔬 Full-text search across the last ~10 years of filings

Every tool returns human-readable markdown by default, or structured JSON on request (response_format: "json"). Lightweight (Python standard library + mcp only), no API key, retries on rate limits.

🚀 Quick Start

Add this to your Claude Desktop config and restart Claude:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app-name your@email.com"
      }
    }
  }
}

The SEC asks every API client to send a descriptive User-Agent with contact info. Set SECUSERAGENT to your own name/email (a default is provided so it works out of the box). On first launch the npx wrapper creates an isolated Python environment and installs the dependency (one-time, ~a minute). You need Python 3.10+ and Node.js 16+.

Prefer a global install?

npm install -g edgar-mcp

{
  "mcpServers": {
    "edgar": {
      "command": "edgar-mcp",
      "env": { "SEC_USER_AGENT": "your-app-name your@email.com" }
    }
  }
}

🔧 Available Tools

Every tool also accepts response_format ("markdown", the default, or "json"). identifier accepts a ticker, CIK, or company name.

Common XBRL concepts for getconcept:** Revenues / RevenueFromContractWithCustomerExcludingAssessedTax, NetIncomeLoss, Assets, Liabilities, StockholdersEquity, EarningsPerShareDiluted.

💬 Example Prompts

Once the server is connected, just ask Claude:

• "What's Apple's latest 10-K?"
• "Show me Tesla's recent 8-K filings."
• "What are Microsoft's headline financials?"
• "Show me NVIDIA's net income over the last few years."
• "Which companies mention 'quantum computing' in their 10-Ks?"
• "Find the CIK for Berkshire Hathaway."

Shortened. The full README is on GitHub.