SEC EDGAR MCP MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Ticker/nombre → resolución CIK; punto final de datos de la empresa
Presentaciones: recuperación y extracción de secciones 10-K, 10-Q, 8-K
Datos financieros de XBRL analizados en balance/estado de resultados/flujo de caja
Uso de información privilegiada: transacciones del formulario 3/4/5
Cada respuesta cita la URL de presentación de la SEC para su verificación.

Demo en vivo

Cómo se ve en la práctica

sec-edgar-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: SEC EDGAR MCP

Haga una lectura rápida de 10 K con números y citas exactos

👤 Analistas, inversores, periodistas que cubren empresas públicas. ⏱ ~30 min intermediate

Cuándo usarlo: Necesitas leer un 10-K esta tarde, no esta semana.

Requisitos previos

SEC_EDGAR_USER_AGENT configurado con tu nombre y correo electrónico — La SEC requiere un agente de usuario contactable para el acceso programático

Flujo

resolver la empresa

Busque el CIK de Microsoft.✓ Copiado

→ CIK 0000789019 devuelto
Saque el último 10-K

Obtenga el último 10-K y extraiga la sección Factores de riesgo.✓ Copiado

→ Sección de factores de riesgo devuelta con URL de presentación
Tira los números

Extraiga el balance y la cuenta de resultados del año fiscal 2025.✓ Copiado

→ Limpiar filas con valores + unidades + URL de archivo

Resultado: Una lectura digerible de 10 K con enlaces verificables a EDGAR.

Errores comunes

Años fiscales y calendario confusos — Imprima siempre el período fiscal en la respuesta para que los usuarios puedan verificar la cordura

Combinar con: yahoo-finance

Realice un seguimiento de las transacciones internas para obtener una lista de seguimiento

👤 Los inversores siguen el sentimiento interno ⏱ ~20 min intermediate

Cuándo usarlo: Quiere un resumen diario sobre la actividad de Form 4 para su lista de seguimiento.

Flujo

Enumerar información privilegiada para cada ticker

Para AAPL, MSFT, NVDA: obtenga transacciones del Formulario 4 en los últimos 30 días.✓ Copiado

→ Filas con nombre de información privilegiada, función, compra/venta, acciones, precio, fecha
Agregar

Resuma las compras netas de información privilegiada frente a las ventas por ticker.✓ Copiado

→ Una línea por ticker con dirección neta

Resultado: Un resumen nítido y privilegiado sin raspar a EDGAR a mano.

Errores comunes

Contar transacciones relacionadas con opciones como 'compras' — Filtrar códigos de transacción; Materia P/S vs A/M/D

Combinar con: alpaca

Resuma las presentaciones 8-K de hoy en una lista de seguimiento

👤 Salas de redacción, equipos de desarrollo corporativo, relaciones con inversores ⏱ ~10 min beginner

Cuándo usarlo: Algo material sucedió; desea obtener rápidamente el resumen en inglés sencillo.

Flujo

Saca 8-K recientes

Obtenga las presentaciones de 8-K de hoy para ver los tickers en mi lista de seguimiento.✓ Copiado

→ Por presentación: códigos de artículo + enlace
Resumir

Para cada uno, un resumen de una frase en inglés sencillo con el código del artículo.✓ Copiado

→ Resumen claro con la URL de la SEC

Resultado: Un resumen de la lista de seguimiento en el que puede confiar y al que puede vincular.

Combinar con: fetch

Compare las finanzas de dos empresas una al lado de la otra

👤 Analistas de acciones, estudiantes construyendo modelos. ⏱ ~20 min intermediate

Cuándo usarlo: Necesita una comparación rápida de manzanas con manzanas.

Flujo

Extraiga el XBRL de ambas empresas

Obtenga ingresos, ganancias brutas, ingresos operativos, ingresos netos de AAPL y MSFT para el año fiscal 2024.✓ Copiado

→ Tabla alineada con unidades y URL de archivo
Diferenciar los márgenes

Calcule y compare los márgenes bruto y operativo.✓ Copiado

→ Márgenes uno al lado del otro; enlace a cada presentación

Resultado: Una comparación defendible con las URL de origen exactas.

Combinar con: antv-chart

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

sec-edgar-mcp + yahoo-finance

Combine los fundamentos de la SEC con las cotizaciones actuales del mercado

Obtenga los últimos ingresos netos de 10 K de MSFT y la capitalización de mercado actual; calcular múltiplos implícitos.✓ Copiado

sec-edgar-mcp + alpaca

Utilice señales internas como pantalla

Para tickers con compras internas netas en los últimos 30 días, indique los precios actuales de Alpaca.✓ Copiado

sec-edgar-mcp + antv-chart

Trazar los números XBRL extraídos

Obtenga 5 años de ingresos y grábelos con antv-chart.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
lookup_cik	ticker_or_name: str	Primer paso para cualquier consulta de empresa	1 SEC request
get_company_facts	cik: str	Descubra qué líneas de pedido se informan	1 SEC request
get_filings	cik: str, form_type: str, limit?: int	Extraiga presentaciones 10-K / 10-Q / 8-K	1 SEC request
extract_section	accession_number: str, section: str	Lea una sección específica (por ejemplo, Factores de riesgo, MD&A)	1 SEC request
get_financials	cik: str, period: str	Estados financieros estructurados con unidades.	1 SEC request
get_insider_transactions	cik: str, days?: int	Actividad del formulario 3/4/5	1 SEC request

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Límite de velocidad de la SEC: ~10 solicitudes/seg por IP; respételo
Tokens por llamada: Pequeñas para metadatos, las presentaciones pueden ser muy grandes (decenas de miles de tokens)
Monetario: Gratis — EDGAR es público
Consejo: Utilice extract_section en lugar de deshacerse de todo el archivo; Las secciones MD&A o Factores de riesgo por sí solas suelen ser suficientes.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: SEC_EDGAR_USER_AGENT lo identifica ante la SEC; utilice un nombre real y un correo electrónico de contacto. No envíe su correo electrónico personal a una configuración compartida.

Salida de datos: Todas las llamadas van a sec.gov. No hay servicios de terceros en la configuración predeterminada.

Nada de lo devuelto por este MCP constituye asesoramiento de inversión. Verifique siempre a través de la presentación SEC vinculada antes de actuar.

Resolución de problemas

Errores comunes y soluciones

403 de sec.gov

Su User-Agent falta o tiene un formato incorrecto. La SEC requiere el formato 'Nombre (correo electró[email protected])'.

Verificar: echo $SEC_EDGAR_USER_AGENT

Tarifa limitada (429)

Retroceda a menos de 10 solicitudes/s. Lote por CIK en lugar de emitir muchas llamadas paralelas.

Verificar: Inspect headers on the failing response

Concepto XBRL no encontrado

La empresa no podrá informar ese concepto. Utilice get_company_facts para ver qué conceptos existen.

Verificar: get_company_facts(cik) and grep for the concept

Alternativas

SEC EDGAR MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
yahoo-finance	Quieres cotizaciones + fundamentos básicos sin precisión a nivel de SEC	Menos autoritario; sin presentaciones directas
alpaca	Necesita datos del mercado de corretaje y operaciones	Sin presentaciones; forma de datos diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills