edgar-mcp

Un servidor MCP que permite a Claude buscar el texto completo de las presentaciones de la SEC.

Pregúntale a Claude "¿qué empresas hablaron de IA agéntica en sus 10-Ks este año?" y buscará en EDGAR directamente: 235 presentaciones reales, con enlaces.

https://github.com/user-attachments/assets/afa2e1e5-ee79-42ad-a736-6f016b8f6c64

El problema más difícil

EDGAR filtra por CIK, un identificador de diez dígitos que no significa nada para un humano y lo significa todo para la API. El diseño obvio acepta un CIK como parámetro de la herramienta y deja que el modelo lo proporcione. Eso falla de la peor manera posible: un modelo de lenguaje inventará con total seguridad un CIK para cualquier empresa que no haya memorizado, y las presentaciones de una empresa equivocada se ven exactamente igual que las de la correcta — con el formato correcto, plausibles y completamente erróneas, con nada que indique el error. Por eso las herramientas aceptan un ticker o nombre de empresa y lo resuelven en código contra el propio archivo de mapeo de la SEC. Cuando el nombre es ambiguo — "American" coincide con 66 empresas — el resolvedor devuelve la lista de candidatos en lugar de elegir la coincidencia con mejor puntuación, y Claude pregunta cuál querías decir. El modelo gestiona los casos fáciles mediante el contexto; el código detecta aquellos en los que se equivoca.

Related MCP server: EdgarTools MCP

Instalación

npm install -g @alinarashid/edgar-mcp

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "@alinarashid/edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app your@email.com"
      }
    }
  }
}

SEC_USER_AGENT es obligatorio. La SEC rechaza las solicitudes que no identifican al llamante, y un encabezado ausente devuelve 403 en lugar de un resultado vacío.

Reinicia Claude Desktop.

Herramientas

search_filings — búsqueda de texto completo en todas las presentaciones desde 2001. Filtra por tipo de formulario, rango de fechas y empresa. Devuelve la empresa que presenta, el formulario, la fecha y un enlace al documento.

list_company_filings — las presentaciones de una sola empresa, de la más reciente a la más antigua. Acepta un ticker o nombre. Filtra por tipo de formulario, o en su mayoría obtendrás operaciones de información privilegiada del Form 4.

Ejemplos

¿Qué empresas mencionaron "IA agéntica" en sus presentaciones 10-K este año?

Muéstrame los informes trimestrales recientes de American Airlines.

Encuentra presentaciones 8-K de 2026 que mencionen "debilidad material".

Limitaciones conocidas

• La búsqueda devuelve metadatos, no texto. Te indica qué presentaciones coinciden, no lo que dicen. Sigue la URL para leer el texto.

• La clasificación es por relevancia de palabras clave, no por tamaño de la empresa. Una presentación corta que repite una frase supera a un 10-K de 300 páginas que la menciona dos veces.

• Solo empresas públicas. Las empresas privadas no presentan nada ante la SEC.

• La búsqueda dentro de una empresa incluye presentaciones de terceros etiquetadas con ese CIK, como propuestas de accionistas presentadas por grupos externos.

Notas

El endpoint de texto completo en efts.sec.gov no está documentado: la SEC no publica lista de parámetros, esquema de respuesta ni garantía de estabilidad. Este paquete lee de forma defensiva y puede necesitar actualizaciones si la estructura cambia.

Las solicitudes se serializan a aproximadamente 8 por segundo, por debajo del límite publicado de 10 por la SEC.

Licencia

MIT