secEdgarMCP

Servidor MCP de SEC EDGAR

Un servidor MCP para consultar datos financieros de SEC EDGAR: información de empresas, estados financieros, métricas XBRL, presentaciones, operaciones de información privilegiada y más. Construido con Go.

Requisitos previos

• Docker (recomendado, no se necesita cadena de herramientas local) o Go 1.21+
• Para view_filing: servidor nativo (no Docker) + w3m + terminal ghostty o konsole

Primeros pasos

Opción A: Docker

git clone https://github.com/ChinmayKhachane/SecEdgarMCP.git
cd SecEdgarMCP
./run.sh build

Agregue a su .mcp.json:

{
  "mcpServers": {
    "sec-edgar": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--platform", "linux/amd64",
               "-e", "SEC_EDGAR_USER_AGENT=Your Name (you@email.com)",
               "sec-edgar-mcp"]
    }
  }
}

Si ve un error de permisos, ejecute sudo usermod -aG docker $USER y vuelva a iniciar sesión.

Opción B: Binario nativo (requerido para view_filing)

git clone https://github.com/ChinmayKhachane/SecEdgarMCP.git
cd SecEdgarMCP
./run.sh build-local          # compiles ./sec-edgar-mcp

Agregue a su .mcp.json:

{
  "mcpServers": {
    "sec-edgar-local": {
      "command": "/absolute/path/to/SecEdgarMCP/sec-edgar-mcp",
      "env": {
        "SEC_EDGAR_USER_AGENT": "Your Name (you@email.com)"
      }
    }
  }
}

El repositorio incluye un .mcp.json que puede editar en el lugar; ya contiene ambas entradas.

Comandos de run.sh

Comando	Descripción
./run.sh build	Construir la imagen de Docker
./run.sh run	Ejecutar el servidor mediante Docker (stdio)
./run.sh build-local	Compilar el binario nativo de Go
./run.sh local	Construir (si es necesario) y ejecutar de forma nativa

Variables de entorno

Variable	Requerida	Descripción
SEC_EDGAR_USER_AGENT	Sí	Su identidad para SEC EDGAR — "Name (email)"
SEC_EDGAR_LOG_FILE	No	Ruta del archivo de registro (predeterminado: sec-edgar-mcp.log)
SEC_EDGAR_TERMINAL	No	Emulador de terminal para view_filing (predeterminado: detección automática de ghostty/konsole)

Herramientas disponibles

Empresa

Herramienta	Descripción
get_company_info	Nombre, ticker, SIC, bolsa, estado, fin de año fiscal
get_cik_by_ticker	Resolver un ticker a su CIK de SEC
search_companies	Buscar empresas por nombre o ticker
get_company_facts	Todos los hechos XBRL reportados por una empresa

Presentaciones

Herramienta	Descripción
get_recent_filings	Presentaciones recientes, opcionalmente filtradas por tipo de formulario y ventana de fechas
get_latest_filing	Presentación más reciente de un tipo determinado (10-K, 10-Q, 8-K, …)
get_filing_content	Texto sin procesar de una presentación con paginación
get_filing_sections	Extraer secciones nombradas de 10-K/10-Q (MD&A, Factores de riesgo, etc.)
analyze_8k	Analizar un 8-K para elementos de eventos materiales
view_filing	Abrir una presentación en una nueva ventana de terminal mediante w3m (solo servidor nativo)

view_filing acepta un url directo (URL del documento principal de get_recent_filings) o un form_type para resolver automáticamente la presentación más reciente. Elimina el XBRL en línea y el CSS antes de renderizar.

Finanzas

Herramienta	Descripción
get_financials	Estado de resultados, balance general o datos de flujo de efectivo
get_key_metrics	Ingresos, ingreso neto, EPS y otras métricas clave
compare_periods	Comparación año tras año o trimestre tras trimestre
get_quarterly_distribution	Valores de métricas desglosados por trimestre
discover_company_metrics	Listar todas las métricas financieras reportadas para una empresa
get_xbrl_concepts	Obtener datos para un concepto XBRL específico
discover_xbrl_concepts	Buscar nombres de conceptos XBRL

Operaciones de información privilegiada

Herramienta	Descripción
get_insider_transactions	Transacciones recientes del Formulario 4
get_insider_summary	Actividad agregada de compra/venta por información privilegiada
get_form4_details	Detalles completos de una presentación específica del Formulario 4
analyze_form4_transactions	Analizar y clasificar transacciones en un Formulario 4
analyze_insider_sentiment	Sentimiento general de compra/venta de información privilegiada

Licencia

MIT