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

MCP-Server, der sich mit User-Agent mit SEC EDGAR verbindet. Kein API-Key. Finanzdaten werden nicht über FMP, sondern über companyfacts / frames gelesen; die XBRL-Tag-Zuordnung befindet sich in xbrl_map.py.

Tools

Related MCP server: sec-edgar-mcp

Installation

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

In .env muss EDGAR_USER_AGENT ein echter Name + E-Mail sein. SEC blockiert generische python-requests-Agenten mit 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)

Wenn PORT gesetzt ist, ist der Standardtransport http und der Endpoint https://<railway-host>/mcp. Setze MCP_TRANSPORT=stdio nicht — der Prozess lauscht nicht, Railway zeigt „online“, aber Claude kann sich nicht verbinden.

Variablen

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

Claude (claude.ai / Desktop Connectors)

1. Customize → Connectors → Add custom connector

2. URL: https://<host>/mcp (nicht mit /sse am Ende)

3. OAuth-Felder leer lassen, Individual sign-in deaktiviert

4. Add, dann in der Chat-Oberfläche mit + → Connectors öffnen

Wenn Claude Code Header senden kann, MCP_AUTH_REQUIRED=true und Authorization: Bearer <token>.

Für altes /sse gilt MCP_TRANSPORT=sse (für Claude-Connector nicht bevorzugen).

Test

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

Ressourcen

• 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 erforderlich)

13F-Werte sind gemäß SEC-Konvention in Tausend USD. 13F wird nicht von Aktien, sondern von der Institution ausgefüllt.