MCP Setup

edgar-mcp is a thin MCP server that proxies the hosted EdgarParser API. It does not import the parser locally; the API key controls access and billing.

Claude Code Config


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

For local source checkout testing, use:


{
  "mcpServers": {
    "edgar-parser-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["/Users/henrychien/Documents/Jupyter/Edgar_updater/mcp_server.py"],
      "env": {
        "EDGAR_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Environment Variables

Variable	Required	Purpose
`EDGAR_API_KEY`	yes	API key for the hosted EdgarParser API
`EDGAR_API_URL`	no	Override the API base URL; defaults to `https://www.edgarparser.com`
`EDGAR_MCP_OUTPUT_DIR`	no	Local directory for file-output tool responses

Tool Families

XBRL facts and concepts
Filing metadata and documents
Structured filing tables
Filing text search
Premium extraction caches
Operational KPI drivers

See the Tool Reference for the generated contract pages.

See the Agent Cookbook for tool-selection patterns and response-handling guidance.