EDGAR MCP — SEC companyfacts, frames, Form 4, 13F

MCP server that connects to SEC EDGAR with a User-Agent. No API key. Financials are read via companyfacts / frames, not FMP; XBRL tag mapping is in xbrl_map.py.

Tools

Related MCP server: edgarmcp

Setup

cd edgar-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

EDGAR_USER_AGENT in .env must be a real name + email. SEC blocks generic python-requests agents with 403.

EDGAR_USER_AGENT=Your Name your.email@example.com
MCP_TRANSPORT=stdio

Cursor (stdio)

%USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "edgar": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "C:\\Users\\yunus\\Documents\\dev\\edgar-mcp",
      "env": {
        "MCP_TRANSPORT": "stdio",
        "EDGAR_USER_AGENT": "Your Name your.email@example.com"
      }
    }
  }
}

Railway → Claude (Streamable HTTP)

If PORT is set, the default transport is http and the endpoint is https://<railway-host>/mcp. Don't set MCP_TRANSPORT=stdio — the process doesn't listen, Railway shows "online" but Claude can't connect.

Variables

Check: https://<host>/health → {"ok": true, ...}

Claude (claude.ai / Desktop Connectors)

1. Customize → Connectors → Add custom connector

2. URL: https://<host>/mcp (not ending in /sse)

3. Request headers → Authorization = Bearer <MCP_AUTH_TOKEN> (including the Bearer space)

4. Add, open with + → Connectors in the chat

Claude Code

claude mcp add --transport http edgar https://<host>/mcp --header "Authorization: Bearer <MCP_AUTH_TOKEN>"

For the old /sse, use MCP_TRANSPORT=sse (not preferred for the Claude connector).

Test

python -m unittest tests.test_xbrl_map tests.test_form_parsers tests.test_http_auth tests.test_client_utils

Resources

• companyfacts / concept / frames: https://data.sec.gov

• submissions: https://data.sec.gov/submissions

• archives: https://www.sec.gov/Archives/edgar

• full-text: https://efts.sec.gov/LATEST/search-index

• Fair Access: https://www.sec.gov/os/webmaster-faq#code-support (max 10 req/s, User-Agent required)

13F values are in thousands of USD per SEC convention. The 13F is filed by the institution, not the stock.