English Français العربية

io.github.birthday-tools/edgarmcp

Official registry AI and agents

Clean, normalized SEC EDGAR / FRED / ETF / index data for AI agents.

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-edgar
Claude Code 
claude mcp add edgarmcp -e 'EDGAR_USER_AGENT=<EDGAR_USER_AGENT>' -e 'FRED_API_KEY=<your fred_api_key>' -e 'OPENFIGI_API_KEY=<your openfigi_api_key>' -- uvx mcp-edgar==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "edgarmcp": {
            "command": "uvx",
            "args": [
                "mcp-edgar==0.1.2"
            ],
            "env": {
                "EDGAR_USER_AGENT": "<EDGAR_USER_AGENT>",
                "FRED_API_KEY": "<your fred_api_key>",
                "OPENFIGI_API_KEY": "<your openfigi_api_key>"
            }
        }
    }
}

Environment variables

  • EDGAR_USER_AGENT Override the SEC User-Agent contact string
  • FRED_API_KEY secret Free FRED API key for get_macro_series and index levels
  • OPENFIGI_API_KEY secret Optional OpenFIGI key for a higher CUSIP/ISIN rate limit

Frequently asked questions

What is io.github.birthday-tools/edgarmcp?

Clean, normalized SEC EDGAR / FRED / ETF / index data for AI agents.

How do I install io.github.birthday-tools/edgarmcp?

It runs on your machine. In Claude Code: claude mcp add edgarmcp -e 'EDGAR_USER_AGENT=<EDGAR_USER_AGENT>' -e 'FRED_API_KEY=<your fred_api_key>' -e 'OPENFIGI_API_KEY=<your openfigi_api_key>' -- uvx mcp-edgar==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.birthday-tools/edgarmcp need an API key?

Yes. It expects FRED_API_KEY, OPENFIGI_API_KEY, which you set in its configuration.

Is io.github.birthday-tools/edgarmcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.birthday-tools/edgarmcp?

It is published by birthday-tools. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.