CryptoStruct
oficialServidor MCP remoto para datos históricos de cripto y mercados de predicción: búsqueda de ~500K instrumentos, estadísticas de mercado en vivo (OHLC, volumen, diferenciales, profundidad, deslizamiento) y compra de datos de tick. Sin clave para catálogo y estadísticas; OAuth opcional para herramientas de cuenta. Endpoint: https://cryptostruct.com/mcp
¿Qué puedes hacer con CryptoStruct MCP?
- Buscar en el catálogo de instrumentos — Solicite instrumentos en 35 mercados, incluidos los mercados de predicción, usando
search_instrumentscon filtros comoclass=prediction. - Obtener instantáneas de mercado en vivo — Solicite OHLC actual, VWAP, diferenciales y profundidad de cartera para cualquier instrumento mediante
get_market_snapshot. - Analizar agregados históricos — Consulte estadísticas diarias, por hora o por minuto (p. ej.,
get_daily_stats,get_hourly_stats) para estudios de eventos o análisis de tendencias. - Verificar cobertura de archivo — Confirme la disponibilidad de datos a nivel diario para un instrumento desde 2021 usando
get_coverage. - Vista previa e inicio de compras — Use
preview_checkoutpara probar una compra de datos y luegocreate_checkoutpara obtener una URL de Stripe o activar la aprobación de crédito. - Administre su cuenta — Consulte pedidos anteriores, descargue archivos comprados y verifique el saldo de suscripción o crédito con
list_my_ordersyget_my_subscription.
Documentación
Servidor MCP CryptoStruct
Servidor MCP remoto de primera parte para cryptostruct.com — datos históricos de criptomonedas y mercados de predicción (archivos diarios a nivel de tick de 35 plataformas, incluyendo Kalshi y Polymarket) además de estadísticas de mercado en vivo, diseñado para traders, quants y agentes de IA.
Este repositorio documenta el servidor alojado. No hay nada que instalar ni ejecutar desde aquí — el servidor es operado por CryptoStruct.
- Endpoint:
https://cryptostruct.com/mcp(HTTP Streamable, sin estado, modo JSON) - Endpoint OAuth:
https://cryptostruct.com/mcp/auth(mismas herramientas; responde401+WWW-Authenticatepara activar el flujo OAuth estándar — Registro Dinámico de Clientes + PKCE) - Tarjeta del servidor:
/.well-known/mcp/server-card.json - Documentación: https://cryptostruct.com/docs/mcp · Documentación del producto: https://docs.cryptostruct.com
No se requiere clave API — el catálogo, las estadísticas de mercado y el flujo de compra de invitado funcionan sin clave. Iniciar sesión mediante OAuth (opcional) vincula tu cuenta de CryptoStruct para historial de pedidos, descargas de archivos comprados y pago con tus créditos — siempre con tu consentimiento (ver Compra de datos).
Inicio rápido
Claude Code
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth
Cursor / configuración JSON genérica
{
"mcpServers": {
"cryptostruct": {
"url": "https://cryptostruct.com/mcp"
}
}
}
claude.ai — Configuración → Conectores → Añadir conector personalizado → https://cryptostruct.com/mcp/auth
Lo que puedes hacer
- Catálogo y descubrimiento: busca ~500K instrumentos en 35 plataformas (spot, perpetuos, futuros, opciones, mercados de predicción), cobertura de archivo diario desde 2021-02-08.
- Mercados de predicción: los contratos de eventos de Kalshi y Polymarket son instrumentos de primera clase — buscables en el catálogo (
class=prediction), con cobertura, instantáneas en vivo y agregados por minuto/día como cualquier instrumento cripto. Los contratos cotizan 0..1 (USD); el volumen de negociación se normaliza a USD. - Estadísticas de mercado: instantáneas en vivo y agregados por minuto/hora/día — OHLC, VWAP, operaciones, volumen de negociación, diferenciales, profundidad del libro de órdenes; curvas de deslizamiento / impacto de mercado.
- Compra de datos: archivos de tick sin procesar — tanto instrumentos cripto como de mercados de predicción — cuestan €1 por instrumento-día. Pagos con tarjeta: el servidor entrega una URL de pago de Stripe — el pago ocurre en el navegador del usuario, el servidor nunca toca los datos de la tarjeta. Hay archivos de muestra gratuitos de día completo disponibles sin ninguna compra.
- Créditos y consentimiento del agente (inicio de sesión OAuth): los créditos de la cuenta nunca se gastan por un agente sin el consentimiento del usuario. Por defecto,
create_checkoutrespondeapproval_requiredcon una página de aprobación donde el usuario confirma (pagar con créditos o con tarjeta) o descarta el pedido; los pedidos no aprobados caducan después de 24 h sin cobrar nada. Los usuarios pueden optar por compras autónomas dentro de límites (límites por pedido y por ventana móvil de 24 horas) en https://cryptostruct.com/account/agents — entonces los pedidos totalmente cubiertos por créditos se completan inmediatamente; cualquier cosa por encima de los límites vuelve para aprobación. El agente puede además pasar su propiomax_credit_cents.preview_checkoutinforma al agente de antemano cuál de los tres resultados esperar. Estos ajustes solo se pueden cambiar en el sitio web, nunca mediante el token de un agente. - Herramientas de cuenta (inicio de sesión OAuth): listar pedidos, obtener URLs de descarga para archivos comprados, consultar suscripción, saldo de créditos y ajustes de gasto del agente.
Herramientas
| Herramienta | Descripción | Nivel |
|---|---|---|
get_data_dictionary | Diccionario de datos y referencia del producto (formato de archivo, unidades, precios) | gratis |
search_instruments | Buscar en el catálogo de instrumentos | gratis |
list_venues | Listar plataformas cubiertas | gratis |
get_instrument | Detalles del instrumento | gratis |
get_coverage | Cobertura de archivo diario para un instrumento | gratis |
list_sample_files | Archivos de muestra gratuitos de día completo | gratis |
get_price_quote | Cotización de precio para un conjunto de archivos de datos | gratis |
get_market_snapshot | Instantánea de mercado en vivo (60 min + 24 h) | gratis |
get_daily_stats | Agregados diarios (30d–180d gratis; 365d/máx Premium) | gratis |
get_hourly_stats | Agregados por hora (7d–90d gratis; 180d Premium) | gratis |
get_slippage | Curva de deslizamiento / impacto de mercado (1h gratis; 24h/7d Premium) | gratis |
get_top_instruments | Principales instrumentos por volumen de negociación en vivo de 24 h | gratis |
get_movers | Movimientos de 24 h (ganadores y perdedores) | gratis |
get_minutes_range | Serie histórica por minuto para estudios de eventos | premium |
create_checkout | Iniciar una compra — URL de Stripe (tarjeta) o approval_required / nacido-pagado (créditos, según los ajustes de consentimiento del usuario) | comercio |
get_checkout_status | Consultar un pago por session_id (tarjeta) o order_id (con sesión iniciada; pedidos de crédito/aprobación) | comercio |
get_order_files | Listar los archivos de un pedido pagado con URLs de descarga | comercio |
request_file_restore | Restaurar un archivo archivado (almacenamiento en frío) | comercio |
list_my_orders | Mis pedidos | inicio de sesión |
get_my_files | Mis archivos comprados | inicio de sesión |
get_my_subscription | Mi suscripción, saldo de créditos y ajustes de gasto del agente | inicio de sesión |
preview_checkout | Prueba de una compra: archivos propios/no disponibles, cobertura de créditos, y si create_checkout se completará, pedirá aprobación, o entregará a Stripe | inicio de sesión |
Niveles: free/commerce funcionan sin clave. sign-in requiere un inicio de sesión OAuth verificado (cualquier cuenta). Las herramientas/parámetros de premium requieren CryptoStruct Premium (€20/mes) — que también desbloquea ventanas de estadísticas más largas (diario 365d/máx, por hora 180d, deslizamiento 24h/7d), límites de búsqueda más grandes, un bloque de calidad de datos en get_market_snapshot, y un presupuesto de llamadas 5×. Las llamadas más allá de tu nivel devuelven errores estáticos AUTH_REQUIRED / PREMIUM_REQUIRED con una URL de actualización — nunca un fallo duro.
Límites de velocidad
Presupuesto ponderado por llamante: 120 unidades/min sin clave (por IP) o por usuario con sesión iniciada, 600 unidades/min para Premium. Las lecturas baratas del catálogo cuestan 1 unidad, las estadísticas pesadas de upstream 3–5, el pago 10. En errores RATE_LIMITED, espera el número de segundos indicado.
Convenciones
- Todos los tamaños de archivo son bytes comprimidos (zstd); los valores de mercado están en USD; los precios de venta en EUR.
- Los datos de granularidad por minuto se retienen ~30 días en upstream; los agregados por hora/día llegan más atrás.
- Los archivos de tick son capturas de día completo en formato JSON-lines (instantáneas y actualizaciones del libro de órdenes, operaciones, liquidaciones, financiación, mark/index incl. griegas de opciones). Referencia de formato: Protocolo de Datos de Mercado.
Relacionado
- Habilidad de Agente para analizar los archivos de tick:
cryptostruct-market-data(zip) - Índice de descubrimiento de habilidades:
/.well-known/agent-skills/index.json - Catálogo de API (RFC 9727):
/.well-known/api-catalog llms.txt: https://cryptostruct.com/llms.txt
Soporte
Preguntas o problemas: https://cryptostruct.com/contact