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

Servidor MCP que se conecta a SEC EDGAR con User-Agent. Sin clave de API. Los datos financieros no son de FMP: se leen a través de companyfacts / frames; el mapeo de etiquetas XBRL está en xbrl_map.py.

Tool

Related MCP server: sec-edgar-mcp

Instalación

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

En .env, EDGAR_USER_AGENT debe ser un nombre real + correo electrónico. SEC bloquea con 403 los agentes genéricos de python-requests.

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)

Si PORT está definido, el transporte por defecto es http y el endpoint es https://<railway-host>/mcp. No pongas MCP_TRANSPORT=stdio — el proceso no escucha, Railway aparece como "online" pero Claude no puede conectarse.

Variables

Comprobación: https://<host>/health → {"ok": true, ...}

Claude (claude.ai / Desktop Connectors)

1. Personalizar → Conectores → Añadir conector personalizado

2. URL: https://<host>/mcp (no /sse al final)

3. Deja los campos OAuth vacíos y apaga Individual sign-in

4. Añade, y ábrelo en el chat con + → Connectors

Si Claude Code puede enviar cabeceras, usa MCP_AUTH_REQUIRED=true y Authorization: Bearer <token>.

Para el antiguo /sse, MCP_TRANSPORT=sse (no lo prefieras para el conector de Claude).

Pruebas

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

Recursos

• 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 (máx. 10 req/s, User-Agent obligatorio)

Los valores del 13F se expresan en miles de USD según la convención de SEC. El 13F lo presentan la institución, no la acción.