Metadata-Version: 2.4
Name: edgar-mcp
Version: 0.2.1
Summary: MCP server for SEC EDGAR financial data - 6 tools for filings, financials, and metrics
Project-URL: Homepage, https://github.com/henrysouchien/edgar-mcp
Project-URL: Source, https://github.com/henrysouchien/edgar-mcp
Project-URL: Issues, https://github.com/henrysouchien/edgar-mcp/issues
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: fastmcp
Requires-Dist: requests
Description-Content-Type: text/markdown

# 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

```bash
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

```bash
edgar-mcp
```

Claude Code config snippet:

```json
{
  "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](https://github.com/henrysouchien/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.
