Edgar

SEC EDGAR financial data for AI agents, exposed as an MCP stdio server.

Install

pip install edgar-mcp

Configuration

Claude Desktop / Claude Code config:

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

Tool Inventory

This package exposes 29 public MCP tools. The inventory below is generated from the same manifest that drives the hosted API documentation.

Tool Families

Filing Metadata and Documents

get_filings, get_event_filings, describe_filing, get_filing_document, get_filing_sections, get_filing_cover_facts, get_filing_evidence

Operational KPIs

get_operational_kpi_drivers

LangExtract

get_filing_extractions, search_extractions, get_extraction_series, extract_filing_file, list_extraction_schemas

Filing Tables

get_filing_tables, search_filing_tables, compare_filing_tables

Filing Text

search_filing_text

XBRL and Concepts

get_financials, get_metric, get_metric_series, list_metrics, search_metrics, get_statement, get_concept, compare_concept, concept_trend, cite_concept, warm_metric_cache, warm_metric_cache_status

Runtime Notes

• This is a thin client for the hosted EDGAR API; it does not parse filings locally.
• Missing or invalid EDGAR_API_KEY lets the server start, but tool calls return authentication errors.
• Large payload tools support output="file" and write to EDGAR_MCP_OUTPUT_DIR or a local fallback directory.
• API rate limits and paid-tool access are enforced by the hosted service.

Links

• Hosted API: https://www.edgarparser.com
• Documentation: https://docs.edgarparser.com
• MCP setup: https://docs.edgarparser.com/mcp
• Tool reference: https://docs.edgarparser.com/tools
• Changelog RSS: https://docs.edgarparser.com/rss.xml
• In-app developer page: https://www.edgarparser.com/developers
• Open parser package: https://github.com/henrysouchien/edgar-parser
• Source package: https://github.com/henrysouchien/edgar-mcp