Equibles

Equibles

Equibles es un servidor MCP de datos financieros de código abierto y autoalojado — una alternativa de código abierto a un Terminal Bloomberg, construido para agentes de IA en lugar de humanos. Recopila, almacena y sirve presentaciones SEC y estados financieros XBRL, tenencias institucionales 13F, operaciones de personas con información privilegiada y del Congreso, datos de ventas en corto de FINRA/SEC, indicadores económicos de FRED, posicionamiento de CFTC y CBOE, presentaciones de fondos, contratos gubernamentales y precios diarios de acciones — y expone todo ello a través del Protocolo de Contexto de Modelo (MCP), para que Claude, ChatGPT, Cursor o cualquier agente pueda consultarlo directamente. Se ejecuta en tu propio hardware con Docker, de forma gratuita y para siempre.

Este es el núcleo de código abierto de Equibles. Equibles Cloud ejecuta este mismo núcleo y añade más herramientas encima — transcripciones y audio de llamadas de resultados, cotizaciones en tiempo real, cadenas de opciones con griegas, KPIs y guía extraídos por LLM, recompra de acciones, presentaciones de OPI, cambios ejecutivos, múltiplos de valoración, composición de índices, seguimiento de carteras y un screener completo del mercado estadounidense. Mismo protocolo, mismos nombres de herramientas, nada que ejecutar — consulta lo que incluye.

¿No quieres ejecutar nada? Apunta tu asistente de IA a https://mcp.equibles.com/mcp y obtén una clave API gratuita en equibles.com/mcp — 100 solicitudes/día, sin tarjeta. Las guías de configuración por cliente están en daniel3303/stock-market-mcp-server.

Consulta docs/ para la guía de usuario y la documentación técnica.

Qué Incluye

Todo lo marcado como Autoalojado es recopilado, almacenado y servido por este repositorio — 62 herramientas MCP, sin cuenta, sin clave. Equibles Cloud ejecuta este mismo núcleo sobre el mismo protocolo con los mismos nombres de herramientas, y añade más herramientas encima.

Dominio	Fuente de Datos	Autoalojado	Equibles Cloud	Descripción
Presentaciones SEC	SEC EDGAR	✅	✅	Informes anuales/trimestrales/actuales 10-K, 10-Q, 8-K con búsqueda de texto completo
Estados Financieros	SEC XBRL	✅	✅	Estado de resultados, balance general y flujo de caja analizados por período fiscal
Tenencias	SEC 13F-HR	✅	✅	Propiedad institucional — quién posee qué, cuánto y la tendencia a lo largo del tiempo
Presentaciones de Fondos	SEC NPORT / N-CEN / Formulario D	✅	✅	Tenencias de carteras de fondos, operaciones de fondos registrados (proveedores de servicios) y ofertas exentas (colocaciones privadas)
Asesores de Inversión	SEC Formulario ADV	✅	✅	Asesores registrados en la SEC — activos bajo gestión, oficina principal, número de empleados, estructura de tarifas
Operaciones de Información Privilegiada	SEC Formularios 3/4/5/144	✅	✅	Transacciones de directores, ejecutivos y propietarios del 10%, declaraciones anuales de propiedad y ventas propuestas (Formulario 144)
Operaciones del Congreso	Declaraciones de Cámara/Senado	✅	✅	Transacciones de valores por miembros del Congreso, incluyendo la acción, opción, bono u otro instrumento presentado
Datos de Ventas en Corto	SEC / FINRA	✅	✅	Fallos de entrega (SEC), volumen diario de ventas en corto e interés corto (FINRA)
Indicadores Económicos	FRED (Reserva Federal)	✅	✅	Tasas de interés, inflación, empleo, PIB, diferenciales de rendimiento y más
Precios de Acciones	Yahoo Finance	✅	✅	Precios diarios OHLCV con indicadores técnicos (SMA, RSI, MACD)
Listados Europeos	ESMA/FCA FIRDS + directorios de bolsas	✅	✅	Listados de acciones verificados en Euronext (París, Ámsterdam, Bruselas, Dublín, Oslo, Milán, Lisboa), Xetra, Nasdaq Estocolmo, Helsinki y Copenhague (mercado principal y First North), BME y GPW, identificados por ISIN y mercado, con precios diarios en la moneda del propio listado; cada mercado con un adaptador de directorio se ejecuta automáticamente; aún no hay herramientas MCP (ver docs/equity-identity.md)
Posicionamiento de Futuros	CFTC	✅	✅	Datos de Compromisos de los Operadores (COT) para más de 30 contratos de futuros
Indicadores de Mercado	CBOE	✅	✅	Índice de volatilidad VIX (1990+) y ratios put/call por categoría
Contratos Gubernamentales	USAspending.gov	✅	✅	Adjudicaciones de contratos federales a empresas públicas — montos, agencias adjudicadoras, fechas y códigos NAICS/PSC
Catalizadores FDA	FDA.gov	✅	✅	Calendario de reuniones del comité asesor (AdComm) — fechas programadas de paneles de la FDA, centro y título que actúan como catalizadores regulatorios para acciones de biotecnología/farmacéuticas
Transcripciones de Llamadas de Resultados	Webcasts de empresas	—	✅	Transcripciones completas de llamadas trimestrales con atribución de oradores, buscables junto con las presentaciones
Audio de Llamadas de Resultados	Webcasts de empresas	—	✅	La llamada grabada en sí, reproducible y alineada con la transcripción
Resúmenes de Resultados, Guía y Cambio Narrativo	Llamadas de resultados + comunicados	—	✅	Resúmenes trimestrales aprobados por verificadores, citas de llamadas, cambios narrativos derivados, revisiones de guía de gestión y resultados reportados frente a la guía previa de la empresa
Cotizaciones en Vivo	Fuente de mercado con licencia	—	✅	Cotizaciones de acciones estadounidenses en tiempo real
Cadenas de Opciones	Fuente de opciones con licencia	—	✅	Cadenas por vencimiento y precio de ejercicio con bid/ask, volumen, interés abierto, volatilidad implícita y delta/gamma/theta/vega
KPIs de Empresas	Presentaciones + comunicados de resultados	—	✅	Métricas operativas que una empresa reporta pero XBRL nunca estandarizó, más puentes GAAP a no-GAAP
Guía	Comunicados de resultados + llamadas	—	✅	Guía prospectiva de la gestión, sus rangos y cómo se movió entre trimestres
Recompra de Acciones y ATM	8-K / 10-Q	—	✅	Programas de recompra autorizados y programas de capital en el mercado (ATM), con montos y fechas
Fuente de OPI	SEC S-1 / F-1	—	✅	Nuevos registros con términos de oferta, suscriptores, factores de riesgo y finanzas pre-OPI
Relaciones con Inversores	Sitios de RI de empresas	—	✅	Próximos eventos, apariciones en conferencias y comunicados de prensa de RI
Ejecutivos	SEC 8-K / DEF 14A	—	✅	Nombramientos y salidas, más cifras de la Tabla de Compensación Resumida
Múltiplos de Valoración	Derivados	—	✅	P/E, P/S, P/B, EV/EBIT, EV/EBITDA actuales e históricos y más, con los períodos de los que se calcularon
Screener	Derivados	—	✅	Filtra todo el mercado estadounidense por valoración, márgenes, crecimiento, propiedad, datos de ventas en corto y dividendos
Dinero Inteligente	Derivados	—	✅	Puntuaciones de sentimiento de información privilegiada, carteras de superinversores y actividad del Congreso en todo el mercado
Indicadores de Riesgo	Presentaciones SEC	—	✅	Lenguaje de empresa en funcionamiento y divulgaciones de concentración de clientes
Contexto de Mercado	Derivados	—	✅	Acciones correlacionadas, más calendario de mercado y estado abierto/cerrado
Composición de Índices	SEC N-PORT + archivos de tenencias de fondos	—	✅	Constituyentes e historial de cambios de membresía para el S&P 500/400/600, Nasdaq-100, Russell 1000/2000 y el Dow, más pronósticos de adición y eliminación basados en reglas
Carteras	Tu propia cuenta	—	✅	Seguimiento de tenencias y listas de seguimiento en acciones y opciones, con base de costo y P&L realizado/no realizado. Las únicas herramientas del servidor que escriben

Por Qué Algunos Datos Son Solo en la Nube

Nada de lo anterior se retiene de este repositorio. Las filas solo en la nube son datos cuya producción necesita infraestructura que no montarías en casa:

• Transcripciones y audio — las llamadas de resultados son webcasts, no presentaciones. Cada una debe ser descubierta y grabada por una flota de navegadores, luego procesada con reconocimiento de voz por GPU con diarización de oradores, cada llamada, cada trimestre.
• Cotizaciones en vivo y cadenas de opciones — fuentes en tiempo real con licencia, más un servicio de streaming siempre activo para distribuirlas. Ni la licencia ni el tiempo de actividad caben en un contenedor en un portátil.
• KPIs, guía, recompra de acciones, términos de OPI, ejecutivos, indicadores de riesgo — extraídos de presentaciones, poderes y comunicados de resultados mediante canales de extracción LLM con pasos de verificación y una cola de revisión humana, lo que requiere capacidad de inferencia sostenida.
• Eventos y noticias de relaciones con inversores — recopilados de miles de sitios de RI de empresas, necesitando la misma flota de navegadores sigilosos que los webcasts.
• Múltiplos, screener, dinero inteligente, contexto de mercado — derivados, y solo significativos sobre un corpus completamente retroalimentado de todo el mercado en lugar de los tickers que hayas recopilado hasta ahora.
• Composición de índices — ensamblada a partir del programa N-PORT de cada fondo de seguimiento más el archivo de tenencias de cada fondo obtenido diariamente, lo que necesita el corpus NPORT completo y un buscador que siga reaprendiendo dónde se movieron esos archivos.
• Carteras — no son datos recopilados en absoluto: son tuyos, almacenados contra tu cuenta. La versión autoalojada no tiene cuentas, por lo que no hay nada contra lo que almacenarlos.

Más allá de los datos, la nube ya está retroalimentada y mantenida al día, y está gestionada — sin scrapers que cuidar. Este repositorio es gratuito para siempre bajo AGPL-3.0; la nube tiene un nivel gratuito de 100 solicitudes/día sin tarjeta.

Comienza en el nivel gratuito y autoalójalo cuando prefieras ser dueño de la pila.

Inicio Rápido

Docker Compose (recomendado)

La forma más rápida de tener todo funcionando. Requiere Docker.

git clone https://github.com/daniel3303/Equibles.git
cd Equibles
cp .env.example .env
# Edit .env and set SEC_CONTACT_EMAIL (required by SEC EDGAR fair access policy)
docker compose up

Esto inicia:

Servicio	Puerto	Descripción
db	5432	ParadeDB (PostgreSQL + pgvector + pg_search)
web	8080	Portal web para navegar por los datos
mcp	8081	Servidor MCP para asistentes de IA
worker	—	Scrapers (SEC, FINRA, Congreso, FRED, Yahoo, CFTC, CBOE, USAspending, FDA, FIRDS, directorios de bolsas europeas)

La recopilación de datos comienza automáticamente. Las presentaciones SEC, tenencias, operaciones de información privilegiada y operaciones del Congreso comenzarán a poblarse en minutos.

Configuración

Todos los ajustes se pueden configurar mediante un archivo .env en la raíz del proyecto (recomendado para Docker) o variables de entorno.

Datos de Ventas en Corto de FINRA (se requiere clave API gratuita):

El scraper de FINRA (volumen de ventas en corto e interés corto) requiere una clave API gratuita. Sin ella, el scraper se omite correctamente y todos los demás scrapers funcionan con normalidad. Los datos de fallos de entrega provienen de la SEC y funcionan sin credenciales de FINRA.

Para obtener una clave:

1. Ve a la Consola de API de FINRA e inicia sesión (una cuenta de Google funciona)
2. Abre el menú Credenciales de API y crea una nueva Clave de API
3. Copia el ID de Cliente y el Secreto de Cliente
4. Establece Finra__ClientId y Finra__ClientSecret en tu archivo .env o variables de entorno

El flujo anterior de developer.finra.org "Teams & Apps" se ha retirado — usa la Consola de API anterior.

Datos Económicos de FRED (se requiere clave API gratuita):

El scraper de FRED requiere una clave API gratuita del Banco de la Reserva Federal de San Luis. Sin ella, el scraper se omite correctamente y todos los demás scrapers funcionan con normalidad.

Para obtener una clave:

1. Regístrate en fred.stlouisfed.org/docs/api/api_key.html
2. Copia la clave API de 32 caracteres
3. Establece Fred__ApiKey en tu archivo .env o variables de entorno

Filtrado de Tickers (opcional):

Por defecto, todos los tickers se sincronizan. Para limitar la sincronización de datos a acciones específicas, establece una lista única de tickers que se aplique a todos los scrapers:

# .env — sync only these tickers (applies to all scrapers)
Worker__TickersToSync__0=AAPL
Worker__TickersToSync__1=MSFT
Worker__TickersToSync__2=GOOGL

Cuando no se establece, todas las acciones se sincronizan.

Fecha Mínima de Sincronización (opcional):

Por defecto, todos los scrapers comienzan desde enero de 2020. Establece una fecha más reciente para una sincronización inicial más rápida, o retrocede hasta 2000-01-01 para más datos históricos:

# .env — start syncing from 2024 instead of 2020
Worker__MinSyncDate=2024-01-01

Incrustación (opt-in):

Configuración	Predeterminado	Descripción
Embedding__Enabled	false	Establecer en true para habilitar la generación de incrustaciones vectoriales
Embedding__Provider	Ollama	Ollama (/api/embed) o OpenAI (/v1/embeddings — vLLM, Text-Embeddings-Inference, u OpenAI)
Embedding__BaseUrl	—	Endpoint de incrustaciones (p. ej., http://localhost:11434)
Embedding__ModelName	—	Nombre del modelo (p. ej., qwen3-embedding:0.6b)
Embedding__ApiKey	—	Token Bearer, si el servidor lo requiere (p. ej., vLLM --api-key)
Embedding__BatchSize	10	Textos por lote de incrustaciones

Notificaciones de actualización (opcional):

Configuración	Predeterminado	Descripción
CHECK_FOR_UPDATES	true	Cuando true, el portal web verifica GitHub Releases y muestra un banner cuando hay una versión más reciente disponible. Establecer en false para deshabilitar.

Autenticación (opcional):

Configuración	Predeterminado	Descripción
AUTH_USERNAME	—	Nombre de usuario del portal web (autenticación deshabilitada si está vacío)
AUTH_PASSWORD	—	Contraseña del portal web (autenticación deshabilitada si está vacía)
MCP_API_KEY	—	Clave API del servidor MCP (autenticación deshabilitada si está vacía)

Cuando se establece, el portal web requiere inicio de sesión y el servidor MCP requiere el encabezado Authorization: Bearer <key>. Cuando no se establece, todo es de acceso abierto (predeterminado).

Actualización

El portal web verifica GitHub Releases según un horario y muestra un banner cuando hay una versión más reciente disponible (deshabilitar con CHECK_FOR_UPDATES=false). Para actualizar a la última versión:

Docker Compose:

git pull
docker compose up -d --build --remove-orphans

Incluya cualquier archivo de anulación de Compose opcional en el comando de actualización para que esos servicios permanezcan habilitados.

Desde el código fuente:

git pull
dotnet build Equibles.sln

Las migraciones de base de datos se aplican automáticamente al iniciar. Revise el registro de cambios para ver cambios notables antes de actualizar.

Portal Web

El portal web en http://localhost:8080 proporciona una interfaz basada en navegador para explorar datos:

• Acciones — Explore y busque todas las empresas rastreadas, vea gráficos de precios con indicadores técnicos (SMA, EMA, RSI, MACD, Bandas de Bollinger), insignias de cruce dorado/de la muerte y rachas de precios, rendimiento frente a SPY, además de pestañas por acción para tenencias institucionales, datos de venta en corto, presentaciones SEC, estados financieros, operaciones de información privilegiada, ventas propuestas (Formulario 144), tenencias de fondos (NPORT), operaciones de fondos (N-CEN), ofertas exentas (Formulario D) y operaciones del Congreso
• Instituciones — Explore tenedores institucionales (fondos de cobertura, gestores de activos), vea perfiles detallados con desgloses de cartera, asignación por industria, actividad trimestral, backtesting y comparaciones lado a lado. Los declarantes se puntúan según el rendimiento ajustado al riesgo (alfa frente a un punto de referencia) y una página de Índice de Dinero Inteligente agrega los fondos con mayor puntuación en una señal de consenso. Incluye un filtro de tenencias con filtros (número de declarantes, valor, % de flotación, ubicación, AUM/número de posiciones, industria) y exportación CSV
• Asesores — Explore asesores de inversión registrados en la SEC (/advisers), clasificados por activos bajo gestión, con perfiles por firma (AUM regulatorio, oficina principal, número de empleados, estructura de tarifas)
• Operaciones de Información Privilegiada — Panel que muestra las principales compras, ventas y transacciones más grandes de información privilegiada en los últimos 90 días
• Actividad de Venta en Corto — Tabla de líderes de mayor venta en corto (/most-shorted, clasificados por interés corto de FINRA) y mayor volumen diario de venta en corto (/short-volume), cada uno con selector de fecha, ordenamiento del lado del servidor y paginación
• Economía — Explore indicadores económicos de FRED agrupados por categoría (tasas de interés, inflación, empleo, PIB, etc.) con gráficos y estadísticas
• Futuros — Datos de posicionamiento de CFTC Commitments of Traders para más de 30 contratos de futuros (materias primas, índices, divisas) con gráficos de posiciones comerciales/no comerciales
• Mercado — Indicadores de mercado de CBOE: índice de volatilidad VIX con gráficos OHLC, ratios put/call (acciones, índices, total, VIX, ETP)
• Búsqueda — Búsqueda global en acciones, instituciones, información privilegiada y miembros del Congreso con filtrado por categoría y rangos de fechas
• Estado — Salud del sistema, estado de los trabajadores, recuentos de datos y registro de errores

Servidor MCP

El servidor MCP expone herramientas de datos financieros para asistentes de IA (Claude, ChatGPT, etc.):

• Tenencia Institucional — Principales tenedores, historial de propiedad, carteras y resumen de instituciones, asignación sectorial, actividad trimestral, acciones más mantenidas, tenencias de consenso, superposición de fondos, actividad 13F en todo el mercado, búsqueda de instituciones
• Operaciones de Información Privilegiada — Transacciones de información privilegiada, resumen de propiedad, ventas propuestas (Formulario 144), búsqueda de información privilegiada
• Operaciones del Congreso — Operaciones para un ticker, operaciones de un miembro, búsqueda de miembros
• Documentos SEC — Búsqueda de texto completo, búsqueda semántica, navegación de documentos, búsqueda de palabras clave dentro de presentaciones
• Estados Financieros — Serie temporal de hechos XBRL por ticker, comparación de hechos entre tickers, estado de resultados completo / balance general / flujo de efectivo por período fiscal
• Presentaciones de Fondos y Asesores — Tenencias de cartera de fondos (NPORT), operaciones de fondos registrados (N-CEN), ofertas exentas (Formulario D) y búsqueda y consulta de asesores de inversión registrados en la SEC (Formulario ADV)
• Datos de Venta en Corto — Volumen diario de venta en corto, mayor volumen diario de venta en corto en todo el mercado, interés corto quincenal y la instantánea más reciente de interés corto en todos los tickers
• Indicadores Económicos — Consulta de datos FRED, instantánea macro más reciente, búsqueda de indicadores en categorías
• Precios de Acciones — Historial diario OHLCV con cierre ajustado, cierre más reciente en uno o más tickers e indicadores técnicos bajo demanda (EMA, Oscilador Estocástico, Rango Verdadero Promedio, Volumen en Balance, Bandas de Bollinger)
• Posicionamiento de Futuros — Datos de posicionamiento COT, instantánea más reciente en todos los contratos, búsqueda de contratos
• Indicadores de Mercado — Datos históricos de VIX, ratios put/call por tipo (acciones, índices, total, VIX, ETP)
• Contratos Gubernamentales — Adjudicaciones de contratos federales ganadas por un ticker (agencia adjudicadora, monto, fechas del período) y una clasificación de los principales contratistas de empresas públicas por total de dólares federales en un rango de fechas (USAspending.gov)
• Catalizadores FDA — Reuniones programadas del comité asesor (AdComm) de la FDA en un rango de fechas — las fechas de catalizadores regulatorios que mueven las acciones de biotecnología y farmacéuticas (FDA.gov)

Formato de Salida (GCF, opt-in)

Por defecto, las herramientas de tablas devuelven tablas markdown. Graph Compact Format se usa en su lugar cuando es más pequeño; de lo contrario, se recurre a markdown. GCF lleva las mismas celdas que mostraría la tabla markdown, con los nombres de columnas factorizados en un único encabezado y el relleno de | por celda y la fila separadora eliminados.

Alcanza las respuestas renderizadas a través de MarkdownTable.Render, que hoy son las herramientas de volumen corto e interés corto, volumen fuera de bolsa, fallos de entrega, operaciones del Congreso y divulgaciones de miembros, las herramientas de series y calendario de FRED, posicionamiento CFTC, ratios CBOE, reuniones asesoras de la FDA, contratos gubernamentales y las herramientas de búsqueda de instituciones y asesores. Las herramientas que ensamblan su respuesta con MarkdownTable.Start y agregan filas ellas mismas no se codifican, porque esas respuestas continúan más allá de la tabla con notas de truncamiento y notas al pie; eso incluye las herramientas de precios, estados financieros, información privilegiada, dividendos, cartera 13F, presentaciones de fondos y búsqueda de presentaciones. Enrutarlas a través del renderizador compartido se rastrea por separado.

Solicítelo por solicitud, que es lo que un servidor compartido quiere, con el encabezado X-Equibles-Output-Format: gcf o un parámetro de consulta ?output_format=gcf (el parámetro de consulta está ahí para clientes cuya única configuración es una URL). markdown se acepta de la misma manera, para que un llamador pueda optar por no participar en un servidor que usa GCF por defecto. Un valor no reconocido se ignora en lugar de rechazarse, y se aplica el valor predeterminado del propio servidor.

Establezca EQUIBLES_OUTPUT_FORMAT=gcf para hacer de GCF el valor predeterminado a nivel de proceso. Una solicitud que nombre un formato tiene prioridad sobre él; una que no nombre nada lo recibe.

La selección por solicitud depende de que cada llamada de herramienta llegue como su propia solicitud HTTP, que es como funciona el transporte HTTP transmisible tanto en sus modos sin estado como con sesión: el formato se lee de esa solicitud y se aplica solo a ella. Un transporte que en su lugar despachara llamadas en una conexión abierta anteriormente llevaría lo que la solicitud de apertura pidió.

Cuánto ahorra depende de la forma de la respuesta. La tabla se comprime, la prosa que la rodea no, por lo que una tabla pequeña dentro de un preámbulo largo ahorra menos y una tabla ancha de muchos valores cortos ahorra más. Medido de extremo a extremo contra un servidor desplegado en respuestas reales de tres de las herramientas cubiertas, 30 sesiones de volumen diario de venta en corto, 25 operaciones del Congreso y 24 observaciones mensuales de una serie FRED, el texto de la respuesta es 7 a 13% más corto en caracteres.

Ese es el texto que su cliente entrega al modelo, no la carga útil HTTP. JSON escapa cada comilla que el codificador agrega, por lo que los bytes de transporte pueden crecer en la misma respuesta cuyo texto se redujo.

Es deliberadamente conservador: cada valor de celda se preserva textualmente (el formato USD compacto, agrupado por comas, decimal adaptativo y guion largo no se toca — GCF solo cambia el marco, no los números que un modelo lee), y cualquier fila que no coincida con la forma de columna del encabezado recurre a la tabla markdown, por lo que un resultado nunca se pierde o distorsiona. La salida es sin cambios para un llamador que no pide nada en un servidor que no establece nada. GCF tiene licencia MIT y su codificador es de cero dependencias.

Conexión a Claude Desktop

Agregue esto a su archivo de configuración de Claude Desktop (claude_desktop_config.json):

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

{
  "mcpServers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

Reinicie Claude Desktop y las herramientas de Equibles estarán disponibles. Luego puede hacer preguntas como "¿Quiénes son los principales tenedores institucionales de AAPL?" o "Busque la discusión de crecimiento de ingresos en el último 10-K de Apple".

Conexión a Claude Code

Agregue el servidor MCP a Claude Code:

claude mcp add equibles --transport http http://localhost:8081/mcp

Conexión a ChatGPT Desktop

Agregue esto a su archivo de configuración de ChatGPT Desktop:

macOS: ~/Library/Application Support/com.openai.chat/mcp.json Windows: %APPDATA%\com.openai.chat\mcp.json

{
  "servers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

Reinicie ChatGPT Desktop y las herramientas de Equibles estarán disponibles.

Conexión a OpenClaw

En OpenClaw, agregue un servidor MCP con la URL http://localhost:8081/mcp (transporte HTTP).

Otros Clientes MCP

Cualquier cliente compatible con MCP puede conectarse a http://localhost:8081/mcp (transporte HTTP).

Ejecución sobre stdio

Los clientes que lanzan un servidor como subproceso pueden ejecutarlo sobre stdin/stdout en lugar de HTTP:

dotnet build src/Equibles.Mcp.Server
dotnet run --no-build --project src/Equibles.Mcp.Server -- --stdio

Compile primero: un dotnet run simple restaura e imprime la salida de compilación en stdout, lo que corrompe el flujo del protocolo. El servidor lee ConnectionStrings:DefaultConnection como de costumbre, así que apúntelo a la misma base de datos que llena el trabajador. Los registros van a stderr. La clave API y el encabezado de formato de salida por solicitud y el parámetro de consulta no se aplican; establezca EQUIBLES_OUTPUT_FORMAT=gcf en el entorno del subproceso en su lugar.

Herramientas

Esta compilación autoalojada expone 62 herramientas a través de MCP. El servidor alojado en https://mcp.equibles.com/mcp ejecuta este mismo núcleo y agrega más encima. Catálogo completo y configuración del cliente: daniel3303/stock-market-mcp-server.

Tenencia institucional 13F

• GetInstitutionCloneBacktest — backtest clonando el portafolio 13F de un declarante frente a un índice de referencia
• GetTopHolders — principales tenedores institucionales de una acción (13F-HR)
• GetInstitutionalOwnershipHistory — tendencia de propiedad institucional entre trimestres
• GetInstitutionPortfolio — portafolio 13F de una institución
• SearchInstitutions — búsqueda tokenizada estricta por nombre/CIK con fecha de presentación, AUM 13F y conteo de posiciones
• GetTopInstitutionalBuyersSellers — mayores compras/reducciones de una acción este trimestre
• GetMarketWide13FActivity — tablas de clasificación 13F a nivel de mercado
• GetMostHeldStocks — acciones por amplitud institucional
• GetInstitutionSummary — resumen del declarante (valor, concentración, rotación)
• GetInstitutionSectorAllocation — asignación por sector
• GetInstitutionQuarterlyActivity — iniciadas/aumentadas/reducidas/salidas frente al trimestre anterior
• CompareInstitutionPortfolios — superposición de portafolios entre dos instituciones
• GetInstitutionConsensusHoldings — portafolio de consenso de 2 a 25 instituciones

Operaciones de información privilegiada

• GetInsiderTransactions — transacciones de información privilegiada de los Formularios 4/5
• GetInsiderOwnership — propiedad de información privilegiada clasificada por acciones
• GetForm144ProposedSales — ventas propuestas del Formulario 144
• SearchInsiders — búsqueda estricta de nombre completo con alias públicos verificados

Búsqueda de presentaciones SEC

• SearchDocuments — búsqueda híbrida de palabras clave + semántica en todas las presentaciones, opcionalmente limitada por ticker
• SearchDocument — búsqueda dentro de una sola presentación
• ListFilings — explorar presentaciones a nivel de mercado o para una empresa, con filtros de fecha/tipo/ítem 8-K
• ReadDocumentLines — leer un rango de líneas de una presentación

Fondos, ETFs y asesores

• SearchInvestmentAdvisers — búsqueda tokenizada estricta de nombre de asesor (Formulario ADV)
• GetInvestmentAdviser — perfil ADV por CRD
• GetFundNcenReports — operaciones de fondos de N-CEN con resolución exacta de identificador de directorio
• GetFundsHoldingStock — fondos que tienen una acción
• GetFormDOfferings — colocaciones privadas (Formulario D)
• GetFailsToDeliver — datos SEC de FTD
• SearchFunds — búsqueda tokenizada estricta de fondo/registrante/ticker con alias verificados de clase de acción
• GetFundProfile — perfil de fondo + tenencias NPORT-P con conteos explícitos de cobertura reportados versus almacenados

Fundamentos (XBRL)

• GetFinancialStatement — estado de ingresos/balance/flujo de caja anclado a un fin de período; los flujos trimestrales en USD se reportan como trimestres discretos o restos derivados exactos, nunca totales YTD
• GetFinancialFact — un concepto a lo largo del tiempo con rangos exactos y advertencias de cobertura de alias obsoletos
• CompareFinancialFact — un concepto entre empresas
• GetRevenueBreakdown — ingresos por segmento/geografía/producto más ingreso operativo reportado por segmento y margen derivado

Datos económicos (FRED)

• GetEconomicIndicator — una serie FRED
• GetLatestEconomicIndicators — valores más recientes por categoría
• SearchEconomicIndicators — búsqueda tokenizada estricta de series seleccionadas con alias macro estándar
• GetEconomicCalendar — calendario de publicaciones macro de EE. UU.

Futuros (CFTC COT)

• GetCftcPositioning — posicionamiento COT para un contrato
• GetLatestCftcPositioning — instantánea COT más reciente
• SearchCftcMarkets — búsqueda tokenizada estricta por nombre, código o símbolo estándar de futuros

Volatilidad (CBOE)

• GetPutCallRatios — ratios put/call
• GetVixHistory — OHLC diario del VIX

Calendario FDA

• GetFdaAdvisoryCommitteeMeetings — reuniones programadas del comité asesor de la FDA

Operaciones del Congreso

• GetCongressionalTrades — operaciones para un ticker
• GetMemberTrades — operaciones de un miembro
• GetMemberNetWorth — historial de patrimonio neto de un miembro
• SearchCongressMembers — búsqueda tokenizada estricta de la lista con alias públicos verificados

Datos de ventas en corto (FINRA)

• GetShortVolume — volumen diario de ventas en corto
• GetShortInterest — interés corto quincenal
• GetShortInterestSnapshot — instantánea a nivel de mercado
• GetLargestShortVolume — mayor volumen diario de ventas en corto
• GetShortSqueezeScores — puntuaciones compuestas de contracción corta
• GetOffExchangeVolume — volumen de dark pool/OTC

Precios de acciones

• GetStockPrices — OHLCV diario más el cierre ajustado auxiliar almacenado cuando difiere
• GetLatestClosingPrices — último cierre/cambio/volumen
• GetDividendHistory — dividendos en efectivo declarados almacenados para una acción o ETF exacto
• GetStochasticOscillator — oscilador estocástico (%K/%D)
• GetAverageTrueRange — rango verdadero promedio (ATR)
• GetOnBalanceVolume — volumen en balance (OBV)
• GetBollingerBands — Bandas de Bollinger

Contratos gubernamentales (USAspending)

• GetGovernmentContracts — adjudicaciones de contratos federales para una empresa
• GetTopGovernmentContractors — mayores contratistas de empresas públicas

Incrustaciones vectoriales (avanzado, opcional)

Las incrustaciones vectoriales permiten búsqueda semántica en presentaciones SEC (por ejemplo, "encontrar discusión de crecimiento de ingresos en el 10-K de Apple"). Esto requiere descargar el runtime de Ollama (~2GB) y el modelo Qwen3-Embedding-0.6B (~640MB).

docker compose -f docker-compose.yml -f docker-compose.embedding.yml up

Esto agrega Ollama y configura los servicios web, MCP y worker existentes para usarlo:

Servicio	Puerto	Descripción
embedding	11434	Servidor Ollama con modelo Qwen3-Embedding-0.6B
embedding-pull	—	Descarga única del modelo antes de que el worker inicie
worker	—	El worker existente, con generación de incrustaciones habilitada

Sin la anulación de incrustaciones, la búsqueda de texto completo BM25 a través de ParadeDB sigue funcionando de inmediato: la búsqueda vectorial es puramente aditiva.

Ollama incluido es el predeterminado porque no necesita GPU y funciona en cualquier lugar. Para incrustaciones masivas a escala, apunte Embedding__Provider=OpenAI a un servidor por lotes como vLLM o Text-Embeddings-Inference: procesan continuamente en lotes en la GPU y son mucho más rápidos que Ollama para corpus grandes. Consulte docs/guide/how-to-use-external-embedding-endpoint.md.

Capturas de pantalla

Detalle de acción	Acciones
Datos económicos	Detalle de indicador económico

Contribuciones

Consulte CONTRIBUTING.md para la configuración de desarrollo, la arquitectura del proyecto y cómo extender la plataforma. Los contribuyentes deben firmar el Acuerdo de Licencia de Contribuyente; esto lo maneja automáticamente un bot cuando abre una solicitud de extracción.

Licencia

AGPL-3.0

Autor

Daniel Oliveira