edgar-mcp

SEC EDGAR financial data for your AI agent.

What your AI can do

• get_filings: fetch filing metadata (10-Q/10-K/8-K earnings release references)

• get_financials: fetch full period facts (inline JSON or local file output)

• get_metric: fetch a specific metric/tag for a period

• list_metrics: list candidate metrics/tags in a filing period

• search_metrics: fuzzy-search metrics by natural-language query

• get_filing_sections: extract filing narrative sections/tables (10-K/10-Q default, or 8-K earnings release with source="8k")

Install

pip install edgar-mcp

Configuration

• EDGAR_API_KEY (required): API key for EDGAR Financial API

• EDGAR_API_URL (optional): defaults to https://www.financialmodelupdater.com

• EDGAR_MCP_OUTPUT_DIR (optional): path for output="file" responses

  • default: ./exports/file_output from current working directory

  • fallback: ~/.cache/edgar-mcp/file_output

Run

edgar-mcp

Claude Code config snippet:

{
  "mcpServers": {
    "edgar-financials": {
      "type": "stdio",
      "command": "edgar-mcp",
      "env": {
        "EDGAR_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Requirements

• Python 3.11+

• EDGAR API key

See also

• edgar-parser — The underlying Python library for parsing SEC EDGAR filings. Use this directly if you want to integrate EDGAR data into your own Python application without MCP.