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)

  1. En Claude: Settings → Connectors → Add custom connector.
  2. Pega la URL del servidor: https://api.markettrace.ai/mcp
  3. Autoriza cuando se te pida y abre el enlace que te enviamos por email.
  4. 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

  1. Añade el servidor:
    claude mcp add --transport http markettrace https://api.markettrace.ai/mcp
  2. 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

  1. Añade el servidor:
    codex mcp add markettrace --url https://api.markettrace.ai/mcp
  2. 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.

Add to Cursor

{
  "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.

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

BinanceBybitOKXHyperliquid
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.

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. Trata el USD de las liquidaciones como una estimación, y recuerda que Hyperliquid no está incluido.
  7. Cuando get_conditional_outcomes devuelva history_silent, di que el historial es demasiado escaso para medir. No rellenes el hueco con una suposición.
  8. 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.

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.

Política de privacidad · Términos del servicio