Equibles
Mercado de valores y datos financieros de EE. UU. — búsqueda de texto completo en presentaciones SEC, fundamentos XBRL, tenencias institucionales 13F, operaciones de personas con información privilegiada y del Congreso, transcripciones de llamadas de resultados, interés corto y macro FRED; más de 90 herramientas, nivel gratuito, autoalojable.
Documentación
Equibles — Servidor MCP de Datos Financieros y del Mercado de Valores
111 herramientas MCP para agentes de IA como Claude, ChatGPT y Cursor: presentaciones SEC, fundamentos, tenencias institucionales 13F, operaciones de personas con información privilegiada y del Congreso, transcripciones de llamadas de resultados, cadenas de opciones, cotizaciones en vivo, presentaciones de OPI, interés corto, datos macro y tu propia cartera. Nivel gratuito alojado, o auto-aloja la pila de código abierto.
¿Qué es esto?
El Protocolo de Contexto de Modelo (MCP) permite que los asistentes de IA llamen a herramientas de datos externas en lugar de adivinar a partir de los datos de entrenamiento. Equibles expone datos financieros y del mercado de valores de EE. UU. como un servidor MCP: úsalo alojado en https://mcp.equibles.com/mcp (clave API gratuita, o OAuth sin clave alguna), o ejecútalo tú mismo desde la pila de código abierto. Todo se analiza de las fuentes primarias (SEC EDGAR, FINRA, FRED, CFTC, CBOE, USAspending, sitios de relaciones con inversores de empresas), no de estimaciones de terceros.
Inicio rápido (alojado, 30 segundos)
- Crea una cuenta gratuita en equibles.com — no se requiere tarjeta de crédito.
- Crea una clave API en
https://equibles.com/dashboard/apikeys. Comienza coneq_y se muestra una sola vez, así que cópiala de inmediato. - Conecta tu cliente con la URL
https://mcp.equibles.com/mcp(ver más abajo).
ChatGPT y Claude (web y Desktop) pueden omitir la clave por completo e iniciar sesión a través de OAuth.
Conecta tu cliente de IA
Claude Desktop / Claude web (claude.ai)
Configuración → Conectores → Añadir conector personalizado → URL https://mcp.equibles.com/mcp → inicia sesión a través de OAuth (sin necesidad de clave).
Alternativa con clave: usa la URL https://mcp.equibles.com/mcp?api_key=eq_your_api_key.
Claude Code
claude mcp add --transport http equibles https://mcp.equibles.com/mcp
Luego ejecuta /mcp y elige Autenticar para iniciar sesión a través de OAuth.
Alternativa con clave:
claude mcp add-json equibles '{"type":"http","url":"https://mcp.equibles.com/mcp","headers":{"Authorization":"Bearer eq_your_api_key"}}' --scope user
ChatGPT
Añade un conector en modo desarrollador con la URL https://mcp.equibles.com/mcp y completa el inicio de sesión OAuth (o usa la URL ?api_key=eq_your_api_key).
Cursor
Añade a ~/.cursor/mcp.json:
{ "mcpServers": { "equibles": { "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
VS Code (Copilot)
code --add-mcp '{"name":"equibles","type":"http","url":"https://mcp.equibles.com/mcp"}'
O añade un .vscode/mcp.json con un objeto "servers" usando la misma URL y la forma del encabezado Authorization:
{ "servers": { "equibles": { "type": "http", "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
Cualquier cliente MCP
Usa el transporte HTTP con la URL https://mcp.equibles.com/mcp, autenticando con un encabezado Authorization: Bearer eq_... o un parámetro de consulta ?api_key=eq_....
Después de conectarte, consulta las guías completas por cliente en https://equibles.com/docs/mcp.
Ejemplos de indicaciones
- "¿Qué fondos de cobertura compraron más NVIDIA el último trimestre?"
- "Resume los factores de riesgo en el último 10-K de Tesla."
- "Muestra ventas recientes de personas con información privilegiada en Microsoft, y ¿algún miembro del Congreso ha operado con ella este año?"
- "¿Qué guió NVIDIA para el próximo trimestre y qué KPIs reportó?"
- "¿Qué acciones tienen las puntuaciones más altas de contracción de cortos hoy?"
- "Filtra acciones de software rentables con un P/E inferior a 20."
- "¿Cuál es el último IPC y la tasa de desempleo?"
Herramientas
111 herramientas, agrupadas por conjunto de datos.
Búsqueda de presentaciones SEC y RAG de texto completo
| Herramienta | Descripción |
|---|---|
| SearchDocuments | Búsqueda híbrida por palabras clave + semántica en todas las presentaciones SEC de las empresas. |
| SearchCompanyDocuments | Búsqueda híbrida de las presentaciones de una empresa por ticker. |
| SearchDocument | Búsqueda híbrida dentro de una sola presentación. |
| ListCompanyDocuments | Explora las presentaciones SEC y transcripciones disponibles de una empresa. |
| SearchDocumentKeyword | Búsqueda por palabras clave dentro de una presentación. |
| ReadDocumentLines | Lee un rango de líneas de una presentación. |
Estados financieros y fundamentos (XBRL)
| Herramienta | Descripción |
|---|---|
| GetFinancialStatement | Estado de resultados, balance general o estado de flujo de efectivo para un período fiscal (XBRL). |
| GetFinancialFact | Un concepto financiero a lo largo del tiempo. |
| CompareFinancialFact | Compara un concepto entre empresas. |
| GetRevenueBreakdown | Ingresos por segmento, geografía y producto (XBRL dimensional). |
Tenencias institucionales 13F y carteras de fondos de cobertura
| Herramienta | Descripción |
|---|---|
| GetFundCloneBacktest | Backtest clonando la cartera 13F de un declarante institucional frente a un índice de referencia de mercado. |
| GetTopHolders | Principales tenedores institucionales de una acción de las presentaciones 13F-HR de la SEC, clasificados por acciones en cartera. |
| GetOwnershipHistory | Tendencia histórica de la propiedad institucional a lo largo de los trimestres. |
| GetInstitutionPortfolio | La cartera de una institución específica de su 13F-HR. |
| SearchInstitutions | Busca inversores institucionales por nombre o CIK de la SEC. |
| GetTopBuyersSellers | Instituciones con los mayores aumentos/reducciones de acciones en una acción este trimestre. |
| GetMarketWide13FActivity | Clasificaciones de 13F en todo el mercado (principales compras/ventas/nuevas/vendidas) para un trimestre. |
| GetMostHeldStocks | Acciones clasificadas por amplitud institucional 13F. |
| GetInstitutionSummary | Resumen de cartera para un declarante 13F (valor, concentración, rotación). |
| GetInstitutionSectorAllocation | Asignación 13F de una institución por sector. |
| GetInstitutionQuarterlyActivity | Actividad iniciada / aumentada / reducida / salida frente al trimestre anterior. |
| GetFundOverlap | Superposición de carteras 13F entre dos instituciones. |
| GetConsensusHoldings | Cartera de consenso de 2 a 25 instituciones. |
Operaciones de personas con información privilegiada (Formularios 3/4/5 y 144)
| Herramienta | Descripción |
|---|---|
| GetInsiderTransactions | Operaciones recientes de personas con información privilegiada de los Formularios 3/4/5 de la SEC. |
| GetInsiderOwnership | Resumen de propiedad de personas con información privilegiada, clasificado por acciones en cartera. |
| GetProposedSales | Ventas propuestas de personas con información privilegiada del Formulario 144 de la SEC. |
| SearchInsiders | Busca personas con información privilegiada corporativa por nombre. |
| GetInsiderSentimentScores | Acciones con las puntuaciones compuestas más altas de 0 a 100 de sentimiento de información privilegiada. |
Operaciones bursátiles del Congreso
| Herramienta | Descripción |
|---|---|
| GetCongressionalTrades | Operaciones del Congreso para un ticker. |
| GetMemberTrades | Operaciones divulgadas de un miembro. |
| GetMemberNetWorth | Historial de patrimonio neto de un miembro a partir de divulgaciones. |
| SearchCongressMembers | Busca miembros por nombre. |
| GetMarketWideCongressionalActivity | Acciones que el Congreso operó más en una ventana reciente. |
Llamadas de resultados: transcripciones, resúmenes e información de IA
| Herramienta | Descripción |
|---|---|
| GetEarningsCallEvent | El evento de llamada de resultados para un trimestre fiscal. |
| ListInvestorEvents | Eventos recientes de inversores. |
| GetInvestorEventSpeakers | Transcripción con etiquetas de orador por ID de evento. |
| GetEarningsCallSpeakers | Transcripción de llamada de resultados con etiquetas de orador por trimestre fiscal. |
| GetEarningsBrief | Resumen de resultados de IA (TL;DR, alcista/ bajista, citas destacadas). |
| GetCallInsights | Información puntuada por IA (tono, cobertura, temas). |
| GetInvestorEventSlides | Presentación de diapositivas capturada del evento de inversores: título, fuente, número de páginas y enlaces al PDF o imágenes de diapositivas. |
Guía de resultados, KPIs y conciliaciones no GAAP
| Herramienta | Descripción |
|---|---|
| GetGuidance | Guía de resultados de 8-K y transcripciones de llamadas. |
| GetCompanyKpis | KPIs específicos de la empresa (suscriptores, ARR, EBITDA ajustado…). |
| GetNonGaapBridge | Conciliaciones de no GAAP a GAAP. |
Precios de acciones e indicadores técnicos
| Herramienta | Descripción |
|---|---|
| GetStockPrices | Historial diario de OHLCV (ajustado por divisiones). |
| GetLatestPrices | Último cierre, cambio y volumen. |
| GetStochasticOscillator | Serie del oscilador estocástico. |
| GetAverageTrueRange | Serie del rango verdadero promedio (ATR). |
| GetOnBalanceVolume | Serie de volumen en balance (OBV). |
| GetBollingerBands | Serie de Bandas de Bollinger. |
Interés corto, volumen corto y grupos oscuros (FINRA)
| Herramienta | Descripción |
|---|---|
| GetShortVolume | Volumen diario de ventas en corto (FINRA). |
| GetShortInterest | Interés corto quincenal. |
| GetShortInterestSnapshot | Instantánea de liquidación más reciente en todo el mercado. |
| GetLargestShortVolume | Mayor volumen diario de ventas en corto. |
| GetShortSqueezeScores | Puntuaciones compuestas más altas de 0 a 100 de contracción de cortos. |
| GetOffExchangeVolume | Volumen semanal de grupos oscuros / OTC (FINRA ATS). |
Cotizaciones en vivo y cadenas de opciones
| Herramienta | Descripción |
|---|---|
| GetLiveQuote | Precio intradía más reciente para uno o más valores de EE. UU. |
| GetOptionExpirations | Fechas de vencimiento de opciones disponibles para una acción, con el número de contratos en cada una. |
| GetOptionChain | Opciones de compra y venta para un vencimiento: strike, bid/ask, volumen, interés abierto, IV y griegas. |
| GetOptionContract | Instantánea completa de un contrato de opción por su símbolo OCC. |
Pipeline de OPI (S-1 / F-1)
| Herramienta | Descripción |
|---|---|
| GetIpoFeed | El pipeline de registro S-1/F-1 de EE. UU., con la actividad de presentación más reciente primero. |
| GetIpoDetails | Un registro completo: estado, términos de la oferta, aseguradores, factores de riesgo y finanzas previas a la OPI. |
Múltiplos de valoración y filtro de acciones
| Herramienta | Descripción |
|---|---|
| GetValuationMultiples | EV/Ingresos, EV/EBIT, P/E con cuartiles de la industria. |
| GetValuationMultiplesHistory | Los mismos múltiplos de valoración a lo largo del tiempo. |
| ScreenStocks | Filtra el universo de acciones con filtros de rango en todos los conjuntos de datos. |
| GetCorrelatedStocks | Acciones más y menos correlacionadas por rendimientos diarios. |
Datos económicos (FRED) y calendario macro
| Herramienta | Descripción |
|---|---|
| GetEconomicIndicator | Serie temporal para un indicador FRED (~40 series seleccionadas). |
| GetLatestEconomicData | Valores más recientes en todas las categorías. |
| SearchEconomicIndicators | Busca en las series seleccionadas. |
| GetEconomicCalendar | Publicaciones macro de EE. UU. programadas y recientes. |
Posicionamiento de futuros (CFTC COT)
| Herramienta | Descripción |
|---|---|
| GetCftcPositioning | Posicionamiento COT para un contrato de futuros. |
| GetLatestCftcData | Instantánea COT más reciente en ~35 contratos rastreados. |
| SearchCftcMarkets | Busca contratos CFTC rastreados. |
Volatilidad y sentimiento de opciones (CBOE)
| Herramienta | Descripción |
|---|---|
| GetPutCallRatios | Ratios put/call de CBOE (Total / Acciones / Índice / Vix / Etp). |
| GetVixHistory | Historial diario de OHLC del VIX. |
Fondos, ETFs y asesores de inversión
| Herramienta | Descripción |
|---|---|
| SearchInvestmentAdvisers | Busca asesores de inversión registrados en la SEC (Formulario ADV). |
| GetInvestmentAdviser | Perfil completo del Formulario ADV por número CRD. |
| GetFundOperations | Datos operativos del fondo del Formulario N-CEN. |
| GetFundHoldings | Tenencias de cartera de fondos/ETFs del último NPORT-P. |
| GetFundsHoldingStock | Fondos/ETFs que tienen una acción determinada. |
| GetExemptOfferings | Colocaciones privadas del Formulario D. |
| GetFailsToDeliver | Datos de FTD de los archivos quincenales de la SEC. |
| SearchFunds | Busca fondos/ETFs registrados. |
| GetFundProfile | Perfil del fondo y mayores tenencias de NPORT-P. |
Composición de índices y pronósticos
| Herramienta | Descripción |
|---|---|
| GetIndexComposition | Lista actual de constituyentes de un índice, primero los más pesados, con el peso de cada empresa. |
| GetIndexChanges | Empresas que se han unido o salido de un índice, primero las más recientes, con las fechas que delimitan cada cambio. |
| GetIndexForecast | Aplica las reglas de entrada publicadas de un índice a cada empresa que rastreamos, regla por regla. |
Eventos corporativos y gobernanza
| Herramienta | Descripción |
|---|---|
| GetExecutiveChanges | Cambios de ejecutivos/directores del 8-K Ítem 5.02. |
| GetExecutiveCompensation | Compensación del DEF 14A. |
| GetBuybackPrograms | Programas de recompra de acciones e historial. |
| GetAtmPrograms | Programas de oferta de acciones en el mercado (ATM). |
| GetGoingConcernStatus | Estado de duda sobre la empresa en funcionamiento de la presentación más reciente. |
| GetCustomerConcentration | Divulgaciones de riesgo de concentración de clientes. |
| GetInvestorRelationsNews | Comunicados de prensa recientes de relaciones con inversores. |
| GetInvestorRelationsEvents | Próximos eventos/webcasts de relaciones con inversores. |
| GetSuperInvestors | Directorio seleccionado de superinversores con CIKs 13F. |
| GetGovernmentContracts | Adjudicaciones de contratos federales (USAspending.gov) ganadas por una empresa. |
| GetTopGovernmentContractors | Empresas clasificadas por dólares de contratos federales. |
| GetFdaCatalysts | Reuniones programadas del comité asesor de la FDA. |
| GetMarketStatus | Estado de la sesión del mercado de EE. UU. |
| GetMarketCalendar | Días festivos y medios días del mercado. |
Tu propia cartera (las únicas herramientas que escriben)
Limitado a la cuenta detrás de la clave API. Las tenencias propias del llamante, nunca las de nadie más.
| Herramienta | Descripción |
|---|---|
| GetMyPortfolio | Las tenencias guardadas del usuario, valoradas, con base de costo y ganancia realizada/no realizada. |
| CreateMyPortfolio | Crear una cartera nueva y vacía. |
| DeleteMyPortfolio | Eliminar permanentemente una cartera y todos los lotes que contiene. |
| AddPortfolioLot | Registrar una compra o venta como lote, para una acción o un contrato de opción. |
| UpdatePortfolioLot | Corregir la cantidad, el precio, la fecha de negociación o la nota de un lote. |
| ClosePortfolioLot | Registrar una venta, cobertura o vencimiento de todo o parte de un lote, conservando su ganancia realizada. |
| RemovePortfolioLot | Eliminar permanentemente un lote ingresado por error. |
| WatchInstrument | Poner una acción o un contrato de opción en una lista de seguimiento, sin registrar posición. |
| UnwatchInstrument | Quitar una acción o un contrato de opción de una lista de seguimiento. |
Comentarios del agente
| Herramienta | Descripción |
|---|---|
| ReportProblem | Reportar datos incorrectos, faltantes o rotos directamente desde la llamada a la herramienta. |
| SuggestToolImprovement | Sugerir un cambio en el comportamiento, los argumentos o la salida de una herramienta. |
Precios y límites de tasa
| Plan | Solicitudes diarias | Precio | Tarjeta requerida |
|---|---|---|---|
| Gratis | 100 solicitudes/día | $0 | No |
| Pro | 10,000 solicitudes/día | Ver precios | Sí |
- Un contador diario compartido entre el servidor MCP y la API REST; se reinicia a las 00:00 UTC.
- Los encabezados de límite de tasa se exponen en las respuestas:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-ResetyRetry-After(en 429). - Cuando se supera el límite, el servidor MCP responde en banda con un resultado de herramienta normal que explica el límite en lugar de devolver un error opaco, para que tu agente pueda leerlo y reaccionar.
Detalles en https://equibles.com/pricing.
Autoalojamiento con Docker (código abierto)
La pila completa es de código abierto en https://github.com/daniel3303/Equibles.
git clone https://github.com/daniel3303/Equibles
cd Equibles
docker compose up
El servidor MCP se inicia en http://localhost:8081/mcp. No se requiere clave API por defecto; establece la variable de entorno MCP_API_KEY para requerir un encabezado Authorization: Bearer <key>. Al autoalojar, el encabezado Bearer es el único método de autenticación (sin parámetro de consulta, sin OAuth).
El servidor autoalojado expone el subconjunto de código abierto de 64 herramientas: tenencias 13F, operaciones de información privilegiada, presentaciones SEC y fundamentos, fondos/ETFs/asesores, FRED, CFTC, CBOE, operaciones del Congreso, datos de venta en corto, precios de acciones, contratos gubernamentales y el calendario de la FDA. El servidor alojado añade 44 más: llamadas de resultados, orientación, KPIs, el filtro, múltiplos de valoración, recompra de acciones, datos ejecutivos, cotizaciones en vivo, cadenas de opciones, presentaciones de IPO y tu propia cartera.
Nota: la pila autoalojada ejecuta sus propios rastreadores contra las fuentes primarias, por lo que las bases de datos comienzan vacías y se llenan con el tiempo después de iniciarla.
API REST
Todo también está disponible como una API REST convencional en https://api.equibles.com/v1, que comparte la misma clave API y límite diario que el servidor MCP. Documentación en https://equibles.com/docs.
Fuentes de datos y metodología
Cada conjunto de datos se analiza desde la fuente primaria, nunca desde estimaciones de terceros:
- SEC EDGAR — presentaciones, fundamentos XBRL, tenencias 13F, Formularios 3/4/5/144, NPORT, ADV, N-CEN, Formulario D
- FINRA — volumen de venta en corto, interés de venta en corto, volumen de dark-pool / fuera de bolsa
- FRED — indicadores económicos y series macro
- CFTC — posiciones de futuros de Commitments of Traders
- CBOE — ratios put/call y VIX
- USAspending.gov — adjudicaciones de contratos del gobierno federal
- Sitios de IR de empresas — noticias y eventos de relaciones con inversores
- Divulgaciones del Congreso — operaciones y patrimonio neto de los miembros
Detalles de metodología en https://equibles.com/docs/methodology.
Enlaces
- Sitio web: https://equibles.com
- Documentación: https://equibles.com/docs
- Crear una clave API: https://equibles.com/dashboard/apikeys
- Pila de código abierto: https://github.com/daniel3303/Equibles
- Precios: https://equibles.com/pricing