SEC EDGAR MCP con Cursor: informes y CIK

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → SEC EDGAR, instálalo sin clave, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

SEC EDGAR + Cursor

Presentaciones y datos financieros de SEC EDGAR, el registro del regulador bursátil de EE. UU., gratis y sin clave: encuentra el CIK de una empresa, consulta su perfil e historial de presentaciones (10-K, 10-Q, 8-K, Form 4), obtén valores XBRL de los estados financieros por concepto, compara empresas con frames, busca en el texto completo de presentaciones desde 2001 y lista los documentos de una presentación. Solo hace falta un User-Agent con contacto.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

SEC_EDGAR_USER_AGENT (un nombre y un correo de contacto, no una clave)

Paso 1 — Configurar el conector

Gratis, sin clave, un solo ajuste: la configuración lleva un minuto. El conector lee las API públicas de EDGAR de la U.S. Securities and Exchange Commission: perfiles, historiales de presentaciones y datos financieros XBRL de https://data.sec.gov, búsqueda de texto completo y búsqueda de empresas de https://efts.sec.gov, y carpetas de presentaciones del archivo EDGAR en https://www.sec.gov. No hace falta cuenta ni clave.

1. La política de la SEC exige que cada petición automatizada diga quién la envía, con un correo de contacto, en la cabecera User-Agent; las peticiones sin ella se bloquean con 403. Escribe en SEC_EDGAR_USER_AGENT tu organización o tu nombre y un correo donde la SEC pueda contactarte, por ejemplo Example Research LLC [email protected].
2. Instala el conector. No hay paso Authorize with Provider.
3. Compruébalo con sec_edgar_full_text_search y forms 10-K: lista los últimos informes anuales presentados.

CIK: cada declarante tiene un Central Index Key. Las herramientas de data.sec.gov lo piden con ceros a la izquierda hasta 10 dígitos (0000320193 para Apple); sec_edgar_get_filing_index también lo acepta sin ceros. sec_edgar_search_companies convierte un nombre o ticker en el CIK: NVDA da 1045810, es decir 0001045810.

Qué lee: cualquier declarante ante la SEC, incluidas las empresas cotizadas en EE. UU., los emisores extranjeros, los fondos y los insiders.

• Hasta 10 declarantes que coinciden con un nombre o ticker, con CIK, nombre y tickers.
• El perfil de un declarante: nombre, tickers, bolsas, sector SIC, cierre del ejercicio fiscal, estado de constitución, direcciones y nombres anteriores, más sus 100 presentaciones más recientes con accession number, formulario (10-K, 10-Q, 8-K, 4, DEF 14A y otros), fecha de presentación, fecha del informe y documento principal. El historial más antiguo viene de los archivos de olderFilingFiles.
• Datos financieros XBRL: los nombres de todos los conceptos que declara una empresa (us-gaap, ifrs-full, dei, srt) y después todos los valores de un concepto, por ejemplo us-gaap NetIncomeLoss en USD. Los ingresos suelen ser Revenues o RevenueFromContractWithCustomerExcludingAssessedTax según la empresa, así que la IA revisa antes la lista de conceptos.
• Comparaciones entre empresas con frames: un concepto para un periodo natural, los 250 valores más altos con CIK, empresa, ubicación y fin del periodo. CY2024 es un año completo, CY2024Q3 un trimestre y CY2024Q4I una fecha de balance.
• Búsqueda de texto completo en presentaciones desde 2001, por palabras o una "frase exacta", tipos de formulario, startdt y enddt, ciks o entityName y sede. Sin q lista las últimas presentaciones de un formulario, como los 8-K de hoy.
• Los documentos de una presentación: nombres, tipos y tamaños del documento principal, los anexos, los archivos XBRL y el texto completo de la presentación.

Formatos de datos: en recentFilings las listas van en paralelo: la entrada n de accessionNumber, form, filingDate, reportDate y primaryDocument describe la misma presentación, de la más reciente a la más antigua. Los valores XBRL están en la unidad indicada (USD, shares, USD-per-shares), no en miles. fy y fp (FY, de Q1 a Q4) son el ejercicio y el periodo de la presentación que informó el valor, mientras que start y end dan el periodo real. El mismo periodo aparece en varias presentaciones, porque un 10-K repite años anteriores: para tener un valor por periodo, la IA prefiere las entradas con frame (p. ej. CY2024). Los valores trimestrales de un 10-Q pueden ser acumulados del año, así que compara start y end. El enlace a un documento es https://www.sec.gov/Archives/edgar/data/<cik>/<accession without dashes>/<file name>; el id de un resultado de texto completo es <accession>:<file name>.

Paginación: la búsqueda de texto completo devuelve 100 resultados por página; la IA avanza con from en pasos de 100, hasta 10.000 resultados por consulta, así que acota por formulario y fecha. El historial de presentaciones se recorre con olderFilingFiles.

Solo lectura: todas las herramientas solo leen, así que no hay nada que confirmar y ninguna herramienta queda desactivada al instalar.

Límites: como máximo 10 peticiones por segundo por remitente. Por encima, la SEC bloquea la dirección durante unos 10 minutos.

Errores frecuentes: 403 significa que falta el User-Agent o no se acepta, o que se superó el límite de frecuencia. 404 significa un CIK, concepto, unidad o periodo desconocido; no todas las empresas declaran todos los conceptos.

El conector no descarga los archivos ZIP masivos ni el company_tickers.json de 1 MB, no lee los documentos completos de las presentaciones (a menudo megabytes de HTML) y no presenta documentos. Los endpoints de búsqueda de texto completo y de empresas de efts.sec.gov alimentan el sitio web de EDGAR y no forman parte de la API documentada de la SEC, así que pueden cambiar.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de SEC EDGAR.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuáles fueron los ingresos anuales y el beneficio neto de NVIDIA en sus últimos cinco ejercicios, según sus presentaciones ante la SEC?"
• "Lista los 8-K que Tesla ha presentado este año, con fecha y documento principal."
• "¿Qué 10 empresas declararon los mayores activos totales a finales de 2024?"
• "Busca 10-K desde 2023 que mencionen "tariff exposure" y dime de qué empresas son."
• "Muéstrame los Form 4 de insiders de Apple del último mes y enlaza los documentos."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot