Servidor MCP cripto para agentes de IA
MarketTrace ofrece un servidor MCP gratuito y de solo lectura para futuros perpetuos cripto. Sus diez herramientas devuelven tasas de funding con su percentil frente a hasta dos años de historial, open interest, volumen, CVD, desequilibrio del libro, liquidaciones y basis, además de velas con delta, niveles de volume profile, grandes operaciones y eventos del footprint. Cubre BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC y ENA en Binance, Bybit, OKX e Hyperliquid; las liquidaciones vienen de los tres primeros.
Hechos y normalización, sin veredictos. Cada métrica llega con su cobertura (los exchanges que la alimentaron y el historial detrás) y cada respuesta declara su antigüedad. Un agente puede distinguir un número sólido de uno endeble antes de repetir cualquiera de los dos.
- URL del servidor
https://api.markettrace.ai/mcp- Transporte
- Streamable HTTP
- Acceso con cuenta
- OAuth con un enlace por email. Sin API key, sin tarjeta.
- Permisos
- Solo lectura. Todas las herramientas llevan readOnlyHint.
- Activos
- BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA
- Exchanges
- Binance, Bybit, OKX, Hyperliquid (liquidaciones: Binance, Bybit, OKX)
- Versión
- 1.9.0, publicada el 2026-10-06 · cambios
- Nombre en el registro
- ai.markettrace/agent-feed
- Contrato de herramientas
- tools.json en GitHub, esquemas de entrada de las 10 herramientas
- Precio
- Gratis
Conecta el servidor MCP
Todos los clientes usan la misma URL y el mismo inicio de sesión. El cliente abre un navegador, escribes tu email y te enviamos un enlace de acceso. Ábrelo en el mismo dispositivo y en el mismo navegador donde empezaste, o el acceso no se completará.
Claude (web y escritorio)
- En Claude: Settings → Connectors → Add custom connector.
- Pega la URL del servidor: https://api.markettrace.ai/mcp
- Autoriza cuando se te pida y abre el enlace que te enviamos por email.
- Pregunta. El feed es de solo lectura; nunca puede operar ni mover fondos.
Claude Code y Codex se conectan desde la terminal en dos pasos. Añadir el servidor no inicia sesión, así que ejecuta ambos.
Claude Code
- Añade el servidor:
claude mcp add --transport http markettrace https://api.markettrace.ai/mcp - Inicia sesión (se abre tu navegador):
claude mcp login markettrace
Si tu Claude Code no tiene el comando mcp login, abre una sesión, escribe /mcp, elige markettrace y selecciona Authenticate.
Codex
- Añade el servidor:
codex mcp add markettrace --url https://api.markettrace.ai/mcp - Inicia sesión (se abre tu navegador):
codex mcp login markettrace
Cursor
Usa el botón Add to Cursor, o añade el servidor a ~/.cursor/mcp.json e inicia sesión cuando Cursor lo pida.
{
"mcpServers": {
"markettrace": {
"url": "https://api.markettrace.ai/mcp"
}
}
}Otros clientes y tu propio agente
Los clientes solo-stdio se conectan con el puente estándar mcp-remote, que también gestiona el inicio de sesión:
{
"mcpServers": {
"markettrace": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.markettrace.ai/mcp"
]
}
}
}Tu propio agente puede usar cualquier librería cliente de MCP con soporte OAuth; los SDK oficiales de TypeScript y Python incluyen uno. Una petición sin autenticar recibe HTTP 401 con una cabecera WWW-Authenticate que apunta a los metadatos OAuth del servidor, así que el cliente encuentra el flujo de inicio de sesión por sí mismo.
Listado en el registro oficial de MCP como ai.markettrace/agent-feed.
Puente de código abierto y documentación en GitHub
Qué preguntar
Sirven preguntas normales. La flecha indica la herramienta que usa el agente.
- ¿Cuál es el estado de mercado de BTC? ¿El posicionamiento está estirado? → get_market_state
- El funding de SOL está por encima del percentil 90. ¿Qué pasó en las 24 y 72 horas siguientes las otras veces que estuvo así de alto? → get_market_state, get_conditional_outcomes
- ¿Cómo se construyó el open interest de ETH en los últimos tres días? → get_state_history
- ¿Cuánto se liquidó en ETH en la última hora, longs o shorts? → get_liquidations_recent
- ¿BTC cotiza dentro del área de valor de ayer? ¿Hay POC desnudos cerca? → get_volume_profile, get_market_state
- ¿Hubo órdenes de mercado de más de 1 M$ en BTC en la última hora? ¿Qué exchange recibió la mayor? → get_big_trades
- ¿Se retiraron muros de compra en SOL antes de la última caída? → get_footprint_events
- ¿Dónde se apiló la venta agresiva en ETH esta mañana? → get_stacked_imbalances
- Trae las velas de 1h de BTC con delta de los últimos dos días y calcula el ATR. → get_ohlcv
- ¿Qué exchange lidera el movimiento de HYPE? Compara CVD, funding y open interest en Binance, Bybit, OKX e Hyperliquid. → get_market_state
Herramientas MCP: funding, open interest, CVD, liquidaciones, volume profile, footprint
Diez herramientas, todas de solo lectura. Cada una recibe un símbolo: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC o ENA, y también valen nombres como BTCUSDT.
get_market_state: todo el mercado en una llamada
Una instantánea normalizada por activo, combinada entre los cuatro exchanges. Empieza aquí.
- Preguntas
- «¿Cuál es el estado de mercado de BTC?» · «¿Está estirado el posicionamiento en ETH?»
- Devuelve
- Precio con variación de 1h, 4h y 24h, ATR de 1h y volatilidad realizada de 24h. Tasa de funding, percentil y racha. Open interest en USD, su variación de 1h y su múltiplo de las medianas de 1d, 1w y 1m. Volumen de 24h. CVD de 30 minutos en USD y el ratio de compras taker. Desequilibrio del libro de −1 a +1 y profundidad a 10, 25 y 50 bps. Liquidaciones de la última hora con la proporción de longs y un percentil. Basis. Valores por exchange, próximos horarios de funding y drivers: unas líneas de texto sobre lo que destaca.
En el sitio: Posicionamiento del mercado · Profundidad del libro
get_funding_percentile: ¿el funding está inusualmente alto?
La tasa de funding actual clasificada frente al propio historial del activo, de 0 a 100, más las horas que lleva con el mismo signo.
- Devuelve
- rate_bps (normalizado a 8h; positivo significa que los longs pagan a los shorts), percentile, streak_h y coverage.
- Historial
- Hasta 730 días. Los activos con un historial más corto se clasifican frente a lo que existe, y coverage.window_days indica cuánto. La tasa entre exchanges y su percentil usan los exchanges con al menos 365 días de historial de funding.
En el sitio: Tasas de funding · Contexto: tasa de funding
get_liquidations_recent: quién fue liquidado
Totales de liquidaciones en Binance, Bybit y OKX para una ventana de hasta 24 horas.
- Parámetros
- window_s en segundos, por defecto 3600, máximo 86400.
- Devuelve
- Total en USD, USD de longs y de shorts, long_ratio (la proporción de longs, de 0 a 1) y el número de eventos.
- Nota
- Los valores en USD son estimaciones: cantidad base por el precio de referencia de cada exchange, y Bybit y OKX publican el precio de quiebra. No incluye liquidaciones de Hyperliquid.
En el sitio: Liquidaciones · metodología de liquidaciones
get_ohlcv: velas con delta
Velas construidas con las operaciones de los cuatro exchanges en una sola línea de tiempo, con el delta taker dentro de cada vela.
- Parámetros
- interval 5m, 15m, 1h, 4h o 1d (por defecto 1h); limit de 1 a 200 (por defecto 100).
- Devuelve
- t (apertura de la vela, epoch ms); o, h, l, c en USD; v y delta en unidades base (BTC, ETH, etc.); partial en una vela que aún se está formando. La suma de delta sobre las velas da el CVD de esa ventana.
- Rango
- La cinta guarda 31 días, así que 1d llega a 31 velas y 4h a 186. ZEC y ENA guardan 14 días.
En el sitio: Gráfico footprint · Contexto: CVD
get_conditional_outcomes: qué siguió a esta condición antes
Retornos posteriores a una condición que tú defines, medidos sobre el propio historial del feed.
- Condiciones
- Una banda de percentil de funding (funding_pct_gte, funding_pct_lte), funding_sign, streak_h_gte, o una feature archivada (obi_skew, oi_chg_1h_pct, taker_buy_ratio, basis_bps) por valor o por percentil. Las condiciones se combinan con AND.
- Horizontes
- 4h, 24h y 72h por defecto; cualquiera de 1h a 168h.
- Devuelve
- Por horizonte: n_matches y n_effective (tras agrupar las ventanas solapadas), retorno mediano, p10 y p90 en porcentaje, la proporción de subidas y el drawdown mediano. Hasta 50 marcas de tiempo coincidentes, y dónde está la última hora en los mismos ejes.
- history_silent
- Menos de 12 coincidencias independientes en todos los horizontes. Las estadísticas vuelven como null, y esa es la respuesta: el historial es demasiado escaso para medir.
- Método
- Los percentiles son as-of: cada hora se clasifica solo frente a los datos que existían en esa hora. Los retornos usan los cierres de 1h de Binance.
Contexto: resultados condicionales · estudio de extremos de funding · método
get_state_history: cómo se llegó hasta aquí
Una serie temporal de cualquier campo numérico de get_market_state, leída de un archivo de 15 minutos que empezó el 2026-07-03.
- Parámetros
- fields, de 1 a 16 rutas con puntos como funding.percentile, oi.usd, obi.skew o venues.binance.oi_usd; from y to en RFC 3339, YYYY-MM-DD o epoch ms; max_points de 1 a 1000 (por defecto 200).
- Devuelve
- t en epoch ms y un array alineado por campo. stride indica cuántas filas salta cada punto, y null marca un campo vacío en esa fila.
Contexto: historial de estado
get_volume_profile: dónde se concentra el volumen
Punto de control y máximo y mínimo del área de valor para cada día UTC, a partir de la cinta combinada de los cuatro exchanges.
- Parámetros
- days, de 1 a 30 días completos (por defecto 7).
- Devuelve
- Hoy (aún en formación), cada día completo, un compuesto del periodo y los POC desnudos de los últimos 30 días a los que el precio no ha vuelto. Por perfil: poc, vah y val en USD, va_width_pct, volumen en unidades base y taker_buy_ratio. El área de valor contiene el 70 % del volumen del día.
En el sitio: Volume profile · Contexto: volume profile
get_big_trades: grandes órdenes de mercado
Grandes órdenes agresivas de la cinta de operaciones. Los fills que comparten exchange, lado taker y marca de tiempo suman una sola operación, así que una orden de mercado que barre varios niveles de precio cuenta una vez.
- Parámetros
- from y to (por defecto la última hora; hasta 12 h por llamada, no más de 31 días atrás); min_usd, al menos 50.000; limit de 1 a 150 (por defecto 50).
- Por defecto
- Los umbrales coinciden con el gráfico footprint: 1 M$ para BTC y ETH, 500 K$ para SOL, BNB, XRP, DOGE y HYPE, 100 K$ para ZEC y ENA.
- Devuelve
- Número y USD por lado, y las mayores operaciones con hora, exchange, lado, precio y tamaño en USD.
En el sitio: Gráfico footprint
get_footprint_events: muros absorbidos o retirados
Eventos de muros del libro de órdenes en el footprint de 1 minuto. Un muro es una fila de precio en reposo mayor que la fila mediana del libro más cinco MAD.
- Absorbido
- Las operaciones consumieron al menos el 5 % del pico del muro, al menos el 85 % del pico seguía en reposo al cierre del minuto y el precio no lo atravesó.
- Retirado
- El muro cayó por debajo de la mitad de su pico mientras las operaciones cubrían menos del 30 % de la caída, no se repuso en 2 segundos y el precio había llegado a su alcance.
- Parámetros
- from y to (por defecto la última hora; hasta 24 h por llamada), kinds (absorbed, pulled), min_usd, limit de 1 a 150.
- Devuelve
- Para cada evento: minuto, tipo, lado, precio, y tamaño pico, ejecutado y de cierre en USD; más los minutos de libro fino por lado.
- Historial
- Registrado desde el 2026-10-03; el archivo crece hacia adelante.
En el sitio: Gráfico footprint · Profundidad del libro
get_stacked_imbalances: agresión unilateral apilada
Desequilibrios apilados según la regla diagonal que usa el gráfico footprint de MarketTrace. Una fila es un desequilibrio comprador cuando sus compras a mercado alcanzan el ratio elegido multiplicado por las ventas a mercado de la fila negociada más cercana por debajo, y vendedor en el caso simétrico frente a la fila de arriba. Tres o más filas seguidas marcadas en el mismo lado forman una pila.
- Parámetros
- interval 1m, 5m, 15m o 1h (por defecto 1m); ratio 2, 3 o 4 (por defecto 3); kinds (buy, sell); from y to (hasta 12 h por llamada, no más de 31 días atrás); limit de 1 a 150.
- Devuelve
- Para cada serie: hora de la vela, lado, banda de precio, número de filas y tamaño en USD, más el recuento por lado.
- Escala
- En BTC con ratio 3, una hora típica tiene unas 38 series en velas de 1m, 13 en 5m, 4 en 15m y 1 en 1h.
En el sitio: Gráfico footprint · Contexto: footprint
Respuesta de ejemplo
get_market_state para BTC el 2026-10-06 a las 13:58 UTC, recortado a los bloques principales. Una respuesta completa incluye también valores por exchange, profundidad del libro, el calendario de funding y una entrada de cobertura para cada bloque.
{
"symbol": "BTC",
"as_of": "2026-10-06T13:58:41Z",
"age_seconds": 20,
"price": { "last": 86267.813, "chg_1h_pct": 0.09, "chg_24h_pct": -0.2, "atr_1h_pct": 0.36, "rv_24h_pct": 32.7 },
"funding": { "rate_bps": 0.28, "percentile": 26, "streak_h": 680 },
"oi": { "usd": 19175427019, "chg_1h_pct": 0.14, "rel": { "1d": 1.0195, "1w": 1.0345, "1m": 1.059 } },
"volume": { "usd_24h": 22309245455, "rel": { "1d": 1.3568, "1w": 1.416, "1m": 1.2496 } },
"cvd": { "window": "30m", "delta_usd": 121145644, "taker_buy_ratio": 0.5558 },
"obi": { "skew": -0.0097 },
"liq": { "usd_1h": 1276732, "long_ratio": 0.0614, "percentile": { "1w": 80, "1m": 87 } },
"basis_bps": -6.33,
"drivers": [
"funding 26th pct (730d, binance+bybit+hyperliquid)",
"OI 1.1x monthly median",
"volume 1.4x weekly median",
"liq 80th pct (1w), 6% longs",
"OI +0.1%/1h, price +0.1% — new longs"
],
"coverage": {
"funding": { "venues": ["binance", "bybit", "hyperliquid"], "window_days": 730, "n_samples": 2190, "partial": false },
"liq": { "venues": ["binance", "bybit", "okx"], "partial": false },
"basis": { "venues": ["binance"], "partial": true }
},
"stale_venues": [],
"feed": { "version": "1.9.0", "tools": 10 }
}Cobertura: activos, exchanges e historial
| Binance | Bybit | OKX | Hyperliquid | |
|---|---|---|---|---|
| Tasa de funding por exchange | ✓ | ✓ | ✓ | ✓ |
| Tasa de funding entre exchanges y percentil | ✓ | ✓ | — | ✓ |
| Open interest | ✓ | ✓ | ✓ | ✓ |
| Volumen, CVD, velas | ✓ | ✓ | ✓ | ✓ |
| Libro de órdenes: desequilibrio, profundidad, eventos de muros | ✓ | ✓ | ✓ | ✓ |
| Cinta de operaciones: grandes operaciones, volume profile, desequilibrios apilados | ✓ | ✓ | ✓ | ✓ |
| Liquidaciones | ✓ | ✓ | ✓ | — |
| Basis | ✓ | — | — | — |
La tasa de funding entre exchanges y su percentil usan los exchanges con al menos 365 días de historial de funding; las respuestas los listan en la entrada de cobertura de funding. El basis compara el perpetuo de Binance con un índice spot de varios exchanges. Hyperliquid no tiene feed de liquidaciones.
- Activos: BTC · ETH · SOL · BNB · XRP · DOGE · HYPE · ZEC · ENA.
- Percentil de funding: hasta 730 días de historial.
- Cinta de operaciones (velas, grandes operaciones, desequilibrios apilados, volume profile): 31 días; 14 para ZEC y ENA.
- Archivo de estado (get_state_history y condiciones archivadas): una fila cada 15 minutos desde el 2026-07-03.
- Eventos de muros: desde el 2026-10-03.
- Los bloques en vivo se refrescan aproximadamente cada 30 segundos.
Reglas para agentes que leen este feed
Estas ocho reglas evitan que un agente lea mal los números. También sirven como system prompt.
- Llama primero a get_market_state. Una llamada cubre funding, open interest, volumen, CVD, el libro de órdenes, liquidaciones, basis y drivers de un activo.
- Lee la entrada de cobertura antes de citar un número. partial: true significa que el bloque se apoya en menos exchanges o menos historial que el conjunto completo; reason, cuando aparece, dice por qué: accruing, unavailable, degraded o stale. El basis siempre es partial porque solo usa Binance.
- Revisa stale_venues y age_seconds. age_seconds es la antigüedad de la fuente en vivo más antigua detrás de la respuesta.
- Ojo con las escalas. Los percentiles van de 0 a 100, los campos que terminan en _ratio van de 0 a 1, los valores rel son múltiplos de la mediana móvil (1.4 significa 140 %), obi.skew va de −1 a +1 y es positivo cuando pesan más las compras, y basis_bps es positivo cuando el perpetuo cotiza por encima del spot.
- En get_ohlcv, v y delta están en unidades base, no en USD. Deja fuera la vela partial en los cálculos de ATR y volatilidad.
- Trata el USD de las liquidaciones como una estimación, y recuerda que Hyperliquid no está incluido.
- Cuando get_conditional_outcomes devuelva history_silent, di que el historial es demasiado escaso para medir. No rellenes el hueco con una suposición.
- Presenta los números como mediciones. El feed dice qué pasó, no qué operar.
Límites y errores
Los límites se aplican por cuenta.
- Llamadas a herramientas: ráfagas de hasta 60, luego una cada 2 segundos (30 por minuto).
- Las herramientas más pesadas, get_ohlcv, get_state_history, get_big_trades y get_stacked_imbalances, comparten además un presupuesto más estricto: ráfagas de hasta 20, luego una cada 6 segundos (10 por minuto).
- Todas las peticiones juntas: ráfagas de hasta 200, luego 10 por segundo.
- Una llamada limitada vuelve como un error de herramienta que el modelo puede leer, por ejemplo "Rate limit (call): retry after 2 s". Por encima del presupuesto de peticiones el servidor responde HTTP 429 con una cabecera Retry-After.
- Los parámetros fuera del rango de una herramienta devuelven un error y nunca se recortan para encajar: ventanas de más de 24 h en get_liquidations_recent y get_footprint_events, de más de 12 h en get_big_trades y get_stacked_imbalances, y velas más allá de la cinta de 31 días en get_ohlcv.
Modelo de honestidad
El feed informa lo que puede medir y lo dice cuando no puede: un historial corto responde con profundidad declarada en lugar de números inventados, los conditional outcomes pasan a history_silent por debajo del umbral de evidencia y cada respuesta autodeclara su frescura. Informa historia, no predicciones.
Gratis y de código abierto
El servidor MCP alojado es gratuito: sin claves API, sin tarjeta, OAuth por magic link de email. El puente stdio, las configuraciones de conexión y el contrato completo de herramientas son de código abierto (MIT) en GitHub. El feed es de solo lectura por diseño: nunca puede operar ni mover fondos.
Preguntas frecuentes
¿El servidor MCP de MarketTrace es gratis?
Sí. El endpoint alojado es gratuito: inicio de sesión OAuth, sin claves API, sin datos de pago.
¿Con qué clientes MCP funciona?
Claude (web y escritorio), Claude Code, Codex, Cursor y cualquier cliente que hable MCP sobre Streamable HTTP con OAuth. Los clientes solo-stdio se conectan con mcp-remote.
¿Da señales de trading?
No. El feed es descriptivo: informa el estado de mercado medido y su historia, y declara su propia cobertura. La interpretación queda en el agente, o en ti.
¿Puede operar o acceder a fondos?
No. El servidor es de solo lectura y todas las herramientas llevan readOnlyHint. No tiene claves de ninguna cuenta de exchange ni ningún permiso de escritura.
¿Qué datos cubre?
Tasas de funding con percentiles sobre hasta dos años, open interest, volumen, CVD, desequilibrio del libro, liquidaciones, basis, OHLCV con delta por vela, niveles de volume profile (POC, área de valor, POC desnudos) y grandes órdenes agresivas, además de muros del libro absorbidos o retirados y desequilibrios apilados del footprint, para BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC y ENA en Binance, Bybit, OKX e Hyperliquid. Las liquidaciones cubren Binance, Bybit y OKX; Hyperliquid no tiene feed de liquidaciones.
¿Qué tan frescos son los datos?
Los bloques en vivo se refrescan aproximadamente cada 30 segundos. Cada respuesta incluye age_seconds, la antigüedad de su fuente en vivo más antigua, y el bloque de funding incluye source_age_ms, el tiempo desde la liquidación de funding que usó.
¿Hasta dónde llega el historial?
Los percentiles de funding se calculan frente a hasta 730 días. Las velas, las grandes operaciones, los desequilibrios apilados y los volume profiles salen de una cinta de 31 días, 14 para ZEC y ENA. El archivo de estado de 15 minutos empieza el 2026-07-03 y los eventos de muros el 2026-10-03.
¿Cuáles son los límites de uso?
Por cuenta, 30 llamadas a herramientas por minuto tras una ráfaga de 60, y 10 por minuto para las cuatro herramientas más pesadas tras una ráfaga de 20. Una llamada limitada devuelve un error que indica cuántos segundos esperar.
¿Hay una API REST?
Todavía no. Hoy la interfaz programática es MCP, y un script puede llamarla con cualquier librería cliente de MCP que soporte OAuth.
¿En qué se diferencia de los servidores MCP de CoinGecko o CoinMarketCap?
Esos cubren precios, capitalizaciones y datos generales de miles de monedas. MarketTrace cubre nueve mercados de futuros perpetuos en profundidad: percentiles de funding, open interest por exchange, CVD, desequilibrio del libro, liquidaciones y eventos del footprint. Nuestra comparativa de servidores MCP cripto detalla qué ofrece cada uno.
¿Qué ve y guarda el servidor?
Tu dirección de email para el inicio de sesión y un ID de cuenta. Por cada petición, el servidor registra el ID de cuenta, la hora, la herramienta y sus argumentos, el nombre y el user agent de tu cliente, tu dirección IP recortada a su prefijo de red (/24 en IPv4, /48 en IPv6) y tu país. Nunca ve tu conversación, solo las llamadas a herramientas que hace tu agente. La política de privacidad tiene los detalles.
¿Es de código abierto?
El puente stdio, las configuraciones de cliente y el contrato de herramientas están bajo licencia MIT en GitHub. El pipeline de datos detrás del endpoint alojado no es de código abierto.