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{
"mcpServers": {
"polytest": {
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${env:POLYTEST_KEY}"
}
}
}
}{
"mcpServers": {
"polytest": {
"type": "http",
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${POLYTEST_KEY}"
}
}
}
}[mcp_servers.polytest]
url = "https://mcp.polytest.io/mcp"
bearer_token_env_var = "POLYTEST_KEY"gemini mcp add --transport http --header "Authorization: Bearer $POLYTEST_KEY" polytest https://mcp.polytest.io/mcpEjecuta 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 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{
"mcpServers": {
"polytest": {
"command": "npx",
"args": ["-y", "@polytest/mcp"],
"env": {
"POLYTEST_KEY": "pt_live_..."
}
}
}
}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.
| Herramienta | Devuelve | Solicitudes a la API |
|---|---|---|
polytest_list_markets | Los 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_market | Un mercado, por market_id o slug, con los ids de los tokens y los campos de resolución. | 1 |
polytest_get_snapshots | Los 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_series | Puntos 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_limits | Los 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_limitsdevuelvetrial_budgeten 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 cabeceraAuthorizationo 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_limitspara 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
Authorizationde 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.