Servidor MCP

El servidor MCP (Model Context Protocol) de PolyTest permite que una herramienta de IA lea directamente los datos de mercado de PolyTest. Funciona en Claude Code, Cursor, VS Code, Codex, Gemini CLI, Claude Desktop y otros clientes MCP. Todas sus herramientas son de solo lectura.

Conectar

El servidor alojado está en https://mcp.polytest.io/mcp y usa Streamable HTTP. El comando de Claude Code añade el servidor sin clave y después inicias sesión con tu cuenta de PolyTest. Los demás fragmentos envían una clave de API tomada de la variable de entorno POLYTEST_KEY. Autenticación explica ambas opciones.

claude mcp add --transport http polytest https://mcp.polytest.io/mcp

Ejecuta las líneas de Claude Code y Gemini CLI en una terminal. El bloque de Cursor va en ~/.cursor/mcp.json, el de VS Code en .mcp.json y el de Codex en ~/.codex/config.toml.

Autenticación

Si tu cliente admite OAuth, inicia sesión con tu cuenta de PolyTest. En Claude Code, ejecuta /mcp, selecciona polytest y elige Authenticate. Si /mcp no está disponible, como en Claude Code dentro de la app de escritorio, ejecuta claude mcp login polytest en una terminal, desde la carpeta donde añadiste el servidor. Otros clientes te piden iniciar sesión al conectarse o la primera vez que llaman a una herramienta.

Tu navegador abre un enlace de inicio de sesión en qpzofvjvtdvdnvgpxplg.supabase.co, la dirección de Supabase Auth, el servicio que PolyTest usa para iniciar sesión. Después continúa en www.polytest.io, donde apruebas la conexión. Más adelante puedes eliminarla en Configuración, en Aplicaciones conectadas.

También puedes enviar una clave de API en la cabecera Authorization: Bearer <key>. X-API-Key también funciona. Crea una clave en la página de claves de API y nunca la pongas en la URL.

En Claude Code, la clave va en la opción --header:

Claude Code
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"

Ejecutarlo en local

npx -y @polytest/mcp ejecuta el servidor en tu propia máquina desde el paquete de npm @polytest/mcp. Necesita Node 20 o posterior y lee tu clave de la variable de entorno POLYTEST_KEY.

claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp

El bloque de Claude Desktop va en claude_desktop_config.json. Sustituye pt_live_... por tu clave.

Herramientas

El servidor tiene cinco herramientas. La última columna indica cuántas solicitudes a la API cuesta una llamada.

HerramientaDevuelveSolicitudes a la API
polytest_list_marketsLos mercados de un market_type para una moneda, los más nuevos primero. Cada fila trae su ventana, status, el precio spot de apertura y de cierre, el ganador y el volumen.1
polytest_get_marketUn mercado, por market_id o slug, con los ids de los tokens y los campos de resolución.1
polytest_get_snapshotsLos snapshots de un mercado, los más antiguos primero, cada uno con time, spot_price, price_up y price_down. Con include_orderbook, cada fila trae además ambos libros de órdenes.1
polytest_get_price_seriesPuntos de precio a intervalos iguales a lo largo de un mercado, los más antiguos primero.1 más una por muestra, 21 con el valor predeterminado
polytest_get_limitsLos límites de tu plan: nivel, límites de tasa, tope de concurrencia, acceso a datos, tope de claves y presupuesto de prueba.1

price_up es el ask más bajo del libro de órdenes de Up: el precio que pagarías por comprar Up en ese momento. price_down es lo mismo para Down. Ambos van de 0 a 1 y valen null cuando nadie ofrece ese lado. Ninguno es un precio medio ni el precio de la última operación. Como los dos son asks, Up más Down suele sumar algo más de 1.

Una sesión típica llama a polytest_list_markets para encontrar un mercado, a polytest_get_price_series para ver la forma de ese mercado y después a polytest_get_snapshots para el detalle tick a tick o el libro de órdenes en un momento dado.

Cobertura y actualidad de los datos

PolyTest tiene mercados de btc, eth y sol en 5m, 15m y 1hr, y solo de btc en 4hr y 24hr.

PolyTest carga los mercados nuevos por lotes, así que los más recientes pueden ir horas o días por detrás del tiempo real. El retraso varía según la moneda y el tipo de mercado.

Cada fila de mercado tiene un campo status:

  • upcoming: la ventana aún no ha empezado.
  • open: la ventana sigue en curso.
  • resolved: ya se conoce el ganador.
  • ended_no_result: la ventana ha cerrado y PolyTest no tiene un resultado para ella.

Cuando listas los mercados más recientes, sin end_time, y el más reciente empezó mucho antes de la hora actual, polytest_list_markets añade una nota que lo indica. En un mercado que sigue en curso, polytest_get_price_series se detiene en la hora actual en lugar de muestrear el futuro. Cuando los últimos buckets de una serie vuelven vacíos, indica dónde terminan los datos. Un rango que empieza después de la hora actual, como un mercado que aún no ha empezado, devuelve un error.

Límites y coste

Cada llamada a una herramienta hace solicitudes normales a la API, así que cuenta para los mismos límites del plan que las llamadas REST.

  • Los límites de tasa son por clave, así que crea una clave dedicada para el servidor MCP.
  • La concurrencia se comparte con todo lo demás que se ejecute en tu cuenta. El servidor reintenta brevemente cuando no hay un hueco libre.
  • polytest_get_limits devuelve trial_budget en todas las cuentas, también en las de pago. Son los totales de solicitudes, registros y bytes que una prueba gratuita puede usar durante sus 3 días, y solo se aplican durante la prueba. Las herramientas no muestran cuánto queda: la API REST informa de lo que resta solo en las cabeceras de respuesta, y los clientes MCP no las ven.
  • Los resultados están dimensionados para la ventana de contexto de una IA: las páginas son pequeñas y los libros de órdenes se recortan a una profundidad elegida. Para descargas masivas o backtests, pide a la IA que escriba código con el SDK de TypeScript o la API REST.

Pruébalo

Con el servidor conectado, pregunta en lenguaje natural. Por ejemplo:

  • Lista los cinco mercados BTC 5m más recientes de PolyTest y muestra cómo se movió el precio de Up en el último.

  • Busca el último mercado BTC 15m resuelto en PolyTest y muestra ambos libros de órdenes treinta segundos antes del cierre.

  • Consulta los límites de mi plan de PolyTest y dime cuántas solicitudes a la API cuesta una serie de precios de 40 muestras.

Solución de problemas

Un error de la herramienta dice que falta la clave de API o que fue rechazada
El error indica cómo arreglarlo en tu configuración: define POLYTEST_KEY, añade la cabecera Authorization o vuelve a iniciar sesión. Tus claves están en la página de claves de API.
Un error de la herramienta menciona tu plan
El plan no cubre esa solicitud. Pide a la IA que llame a polytest_get_limits para ver qué cubre.
El cliente dice que el servidor necesita autenticación
Inicia sesión cuando el cliente lo ofrezca, o añade la cabecera Authorization de Autenticación.
Un error de la herramienta dice que se alcanzó el límite de tasa
El error indica cuánto esperar antes de reintentar.