CryptoConduit-MCP

Un servidor MCP que otorga a los agentes de IA acceso directo a los mercados de predicción cripto de Polymarket, enriquecido con precios spot en vivo. Descubre mercados, analiza libros de órdenes, simula estrategias de trading, rastrea actividad y ejecuta operaciones en vivo.

GitHub

Prueba este MCPPatrocinado

Documentación

CryptoConduit MCP

Un servidor MCP que brinda a los agentes de IA acceso directo a los mercados de predicción de criptomonedas de Polymarket, enriquecidos con precios spot en vivo. Descubre mercados, analiza libros de órdenes, haz paper trading de estrategias, rastrea actividad y ejecuta operaciones en vivo, todo mediante lenguaje natural.

Construido en Rust. 22 herramientas. Probado en mainnet.

Úsalo como servidor MCP con cualquier cliente compatible con MCP, o importa la librería core/ directamente en tus propios bots y pipelines de Rust, sin dependencia de MCP.

Qué hace

Inteligencia de mercado — Descubre y monitorea mercados de predicción en 6 activos (BTC, ETH, SOL, XRP, DOGE, BNB) y 8 tipos de mercado (de 5 minutos a mensuales). Precios spot de Binance en tiempo real superpuestos sobre los libros de órdenes de Polymarket, con puntuación de operabilidad, análisis de spread y perfilado de profundidad.

Análisis cuantitativo — Momentum del spot, dinámica del libro de órdenes (tendencias de spread, cambios de profundidad, desequilibrio), detección de divergencia entre probabilidad y spot, y análisis de flujo de ballenas, combinados en un único informe por mercado. Cuando no hay historial local disponible, el análisis recurre a consultar mercados resueltos en Gamma para obtener contexto de volumen y actividad históricos.

Paper trading — Simulación de P&L ajustada por comisiones usando el modelo de tarifas de Polymarket. Paper trading con seguimiento completo de cartera, ejecución autónoma de auto-trading, salida anticipada y gestión de posiciones. Prueba estrategias sin riesgo antes de comprometer capital real.

Trading en vivo — Coloca y gestiona órdenes reales en Polymarket mediante el SDK oficial. Triple barrera de seguridad: dry run por defecto, confirmación explícita requerida y un gestor de riesgo con límites de pérdida diarios, seguimiento de drawdown y paradas por pérdidas consecutivas.

Monitoreo — Sistema de fondo siempre activo: detección de ballenas en el flujo de operaciones en vivo de Polymarket, alertas de estrechamiento de spread, detección de picos de profundidad y notificaciones de ventanas próximas a expirar. No requiere configuración manual.

Herramientas

Descubrimiento y datos

Herramienta	Qué hace
`search_crypto_markets`	Busca en Polymarket mercados de predicción de criptomonedas. Filtra por activo, tipo de mercado (5m, diario, mensual, etc.) y ordena por spread o volumen. Devuelve mercados activos con precios actuales, spreads y liquidez.
`get_active_window`	Instantánea de la ventana de predicción actual de 5m o 15m: tiempo restante, precio spot, ambos lados UP/DOWN con mejor bid/ask, spread y profundidad.
`get_window_briefing`	Versión más completa de la ventana activa: añade movimiento del spot desde la apertura, perfil de volatilidad de 1 hora, cálculos de punto de equilibrio con comisiones y puntuación de operabilidad por lado.
`get_spot_price`	Precio spot actual de Binance para cualquier activo compatible, con indicador de antigüedad de los datos.
`get_order_book`	Libro de órdenes completo para un token de mercado específico: todos los niveles de bid/ask, profundidad total, análisis de concentración y estimaciones de slippage a distintos tamaños de operación.
`get_market_analysis`	La herramienta de análisis principal. Combina 5 dimensiones: momentum del spot (tendencias de 1m/5m/15m, aceleración, volatilidad), dinámica del libro de órdenes (tendencias de spread, asimetría de profundidad, estadísticas históricas), divergencia de probabilidad (modelo empírico vs precio de mercado), flujo de ballenas y alertas recientes. Recurre a consultar mercados resueltos en Gamma cuando no hay historial local disponible. Funciona en mercados de 5m, 15m, diarios y mensuales.
`get_whale_activity`	Operaciones grandes recientes ($5k+) en mercados diarios y mensuales del flujo de operaciones en vivo de Polymarket. Filtra el ruido de micro-mercados y los canjes posteriores a la liquidación.
`get_alerts`	Alertas generadas por el monitor de fondo: estrechamiento de spread, picos de profundidad, operaciones de ballenas y ventanas próximas a expirar.

Simulación y paper trading

Herramienta	Qué hace
`simulate_trade`	Calculadora de P&L ajustada por comisiones. Introduce un tamaño de posición y precio, y verás la ganancia/pérdida exacta para escenarios de ganar y perder, con las tarifas de taker de Polymarket, reembolsos de maker y matemática de liquidación. Muestra la tasa de ganancia de punto de equilibrio.
`paper_trade`	Abre una posición simulada a los precios actuales del mercado. Registra precio de entrada, comisiones y marcas de tiempo. Las posiciones se liquidan automáticamente cuando el mercado se resuelve en Polymarket.
`get_paper_portfolio`	Vista completa de la cartera: posiciones abiertas con cuenta regresiva en vivo, resultados liquidados, tasa de ganancia por activo y rango de precio de entrada, P&L total y seguimiento de comisiones.
`paper_close`	Cierra una posición de paper trading anticipadamente al precio bid actual, pagando la tarifa de taker al salir. Muestra el P&L realizado incluyendo comisiones de entrada y salida.
`set_auto_paper_trade`	Configura paper trading autónomo. Establece un activo, tamaño de posición y condiciones de entrada: el servidor monitorea los mercados y abre posiciones automáticamente cuando se cumplen las condiciones.
`get_auto_paper_trade_status`	Consulta qué auto-traders están activos, sus operaciones recientes y estadísticas agregadas.

Trading en vivo

Requiere configuración de wallet. Consulta Configuración de wallet más abajo.

Herramienta	Qué hace
`approve_exchange`	Configuración on-chain única. Aprueba transferencias de tokens USDC y CTF para los 3 contratos de intercambio de Polymarket. Cuesta ~$0.001 en gas de POL. Debe ejecutarse antes de colocar cualquier orden.
`get_balance`	Saldo de USDC.e de la wallet en Polygon, más el estado del gestor de riesgo (pérdida diaria restante, pérdidas consecutivas, drawdown).
`place_order`	Coloca una orden de compra o venta. Dry run por defecto: muestra lo que sucedería sin enviarla. Requiere `confirm=true` explícito para ejecutar. El gestor de riesgo está activo.
`cancel_order`	Cancela una orden específica por ID, o cancela todas las órdenes abiertas de una vez.
`get_positions`	Posiciones en vivo actuales en tu wallet.
`redeem_winnings`	Canjea tokens CTF ganadores on-chain después de que un mercado se liquide. Funciona con mercados estándar y NegRisk.

Sistema

Herramienta	Qué hace
`set_data_logging`	Activa o desactiva el registro JSONL en segundo plano de precios spot, libros de órdenes e instantáneas de mercado. Útil para crear conjuntos de datos o depurar.
`get_data_logging_status`	Comprueba si el registro está activo, dónde se guardan los archivos y el uso actual de disco.

Ejemplo de salida

Informe de ventana

## BTC 5m Briefing (2:25 AM ET)

Time: 9% elapsed (26s / 300s), 274s remaining
Spot: $70822 -> $70843 (+0.03%)
Volatility (1h): avg 5m move: 0.051% | max: 0.146% | moves >0.05%: 5/12
UP:   ask=0.660 bid=0.650 spread=1.5% | good (depth: $755, slippage $100: 2.0%)
DOWN: ask=0.350 bid=0.340 spread=2.9% | good (depth: $127, slippage $100: 2.3%)
Fees (taker): UP at 0.660: fee=1.3%, breakeven WR=67.3%
              DOWN at 0.350: fee=1.3%, breakeven WR=36.3%

Análisis de mercado (diario)

## BTC Market Analysis (daily)

### Spot Momentum
  Price           $70795    Trend        Down
  1m move         -0.085%   5m vol       0.055%
  5m move         -0.039%   Accel        decel (-0.078)
  15m move        -0.167%

$70795 — downtrend, decelerating. High volatility.

### Order Book Dynamics
  ATM strike: $70000 (spot: $70795)

  Side     Spread   Median       Trend    BidDep$    AskDep$  Imbalance
  ------------------------------------------------------------------------
  YES        1.3%     1.3%      stable       $169       $221  Mild ask pressure
  NO         3.9%     3.9%      stable        $74        $59  Mild bid pressure

YES side has better liquidity (tighter spread, deeper book).

### Probability Divergence
  Side     Market  Fair Est.  Divergence           Method       Conf
  --------------------------------------------------------------------
  YES       0.750     0.842   +0.092 (underpriced) vol-CDF      high
  NO        0.260     0.158   -0.102 (overpriced)  vol-CDF      high

YES looks underpriced (+9.2%). NO looks overpriced (-10.2%).

Cartera de paper trading

## Paper Portfolio

Trades: 9 | Wins: 5 | Win rate: 55.6%
Total P&L: $11.66 | Avg P&L: $1.30
Volume: $55.00 | Fees paid: $1.69

By Asset:
  BTC:  4 trades, 50.0% WR, $3.71 P&L
  ETH:  2 trades, 50.0% WR, $3.40 P&L
  SOL:  1 trades, 100.0% WR, $5.04 P&L
  XRP:  1 trades, 100.0% WR, $4.65 P&L

By Entry Price:
  0.30-0.50: 3 trades, 66.7% WR, $9.86 P&L
  0.50-0.70: 6 trades, 50.0% WR, $1.80 P&L

Requisitos

Plataforma: Windows, macOS, Linux
Red: Se requiere acceso a las APIs de Polymarket y Binance.

No se requieren claves de API. Las APIs de datos de mercado de Polymarket y Binance son públicas. El servidor funciona de inmediato: sin cuentas, sin registro, sin tokens. Las claves de API solo se necesitan si activas el trading en vivo (consulta Configuración de wallet).

Inicio rápido

Opción A: Descargar binario precompilado

Descarga el último binario para tu plataforma desde Releases y colócalo en algún lugar de tu PATH (o anota la ruta completa para la configuración de abajo).

Opción B: Instalar desde crates.io

Requiere Rust 1.85+.

cargo install crypto-conduit-mcp

Conéctalo a tu cliente MCP

Añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "crypto-predict": {
      "command": "crypto-conduit-mcp"
    }
  }
}

Si el binario no está en tu PATH, usa la ruta completa en su lugar (p. ej. "/path/to/crypto-conduit-mcp" o "C:\\Users\\you\\crypto-conduit-mcp.exe").

El servidor se comunica a través de stdio usando el Model Context Protocol.

Primer arranque: El servidor necesita ~30-45 segundos para descubrir todos los mercados activos de Polymarket. Durante esta ventana, algunas herramientas pueden mostrar datos limitados. Después del ciclo inicial de descubrimiento, todo se actualiza continuamente.

Una vez en ejecución, el servidor automáticamente:

Descubre nuevos mercados cada 4 minutos
Consulta libros de órdenes (cada 5s para corto plazo, 30s para diarios/mensuales)
Transmite precios spot de Binance cada 3s
Monitorea el flujo de operaciones en vivo de Polymarket para detectar actividad de ballenas
Genera alertas (estrechamiento de spread, picos de profundidad, ventanas próximas)

Todo esto se ejecuta en segundo plano: las herramientas leen de este estado en caché, por lo que las respuestas son instantáneas.

Configurar (opcional)

El servidor funciona sin ningún archivo de configuración. Para personalizarlo, crea una configuración en la ubicación adecuada para tu plataforma:

Windows: %APPDATA%\crypto-conduit\config.toml
macOS: ~/Library/Application Support/crypto-conduit/config.toml
Linux: ~/.config/crypto-conduit/config.toml

[logging]
enabled = false          # background data logging (JSONL files)

# [trading]              # uncomment for live trading — see Wallet Setup below
# private_key = "..."
# max_order_size_usd = 100

Configuración de wallet (trading en vivo)

El trading en vivo requiere una wallet configurada. El paper trading funciona sin nada de esto.

1. Crea o usa una wallet EOA

Necesitas una cuenta de propiedad externa (EOA) en Polygon. Puede ser una wallet de MetaMask, una wallet dedicada al trading o cualquier wallet compatible con Ethereum. No uses tu wallet principal: crea una dedicada para el trading.

2. Fondea la wallet

USDC.e (USDC puenteado) en Polygon: este es el token de garantía que usa Polymarket. Contrato: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174. No USDC nativo (0x3c499...).
Una pequeña cantidad de POL para tarifas de gas (las aprobaciones on-chain cuestan ~$0.001).

3. Añade tu clave privada a la configuración

[trading]
private_key = "abc123..."   # 64 hex characters, no 0x prefix
wallet_type = "eoa"
max_order_size_usd = 100    # safety cap per order
daily_loss_limit_usd = 50   # risk manager halts trading if exceeded

Seguridad: Tu clave privada nunca se registra: el servidor usa una implementación Debug redactada. Aun así, mantén este archivo de configuración con permisos restringidos.

4. Aprueba los contratos de intercambio

Antes de colocar tu primera orden, ejecuta la herramienta approve_exchange. Esta es una transacción on-chain única que aprueba transferencias de tokens USDC y CTF para los 3 contratos de intercambio de Polymarket (CTF Exchange, Neg Risk CTF Exchange, Neg Risk Adapter).

5. Coloca órdenes

Todas las órdenes usan modo dry run por defecto: muestran lo que sucedería sin enviar nada. Para ejecutar una orden real, establece confirm=true. El gestor de riesgo verifica los límites de pérdida diarios, las pérdidas consecutivas y el drawdown antes de cada orden.

Ejemplos de prompts

Una vez conectado vía MCP, prueba estos con tu agente de IA:

Descubrimiento y análisis

"¿Qué mercados diarios de BTC están activos? Ordena por spread más ajustado"
"Dame un informe de la ventana actual de ETH 5m"
"Ejecuta un análisis completo de mercado en BTC diario"
"Muéstrame el libro de órdenes para el strike de BTC $70k"

Simulación

"Si compro BTC diario YES a 0.75 con $50, ¿cuál es mi P&L en caso de ganar vs perder?"
"¿Qué tasa de ganancia necesito para alcanzar el punto de equilibrio entrando a 0.65?"

Paper trading

"Haz paper trading de $10 en BTC 5m UP"
"Muestra mi cartera de paper trading: ¿hay posiciones liquidadas?"
"Cierra la posición #3"
"Configura paper trading automático en ETH 5m: tamaño $5, entra por debajo de 0.45, solo cuando el spot se haya movido 0.1%+"

Trading en vivo

"Revisa mi saldo de wallet y estado de riesgo"
"Dry run: compra $10 de ETH diario YES a 0.52"
"Cancela todas mis órdenes abiertas"

Monitoreo

"¿Hay operaciones de ballenas o alertas en los últimos 30 minutos?"
"Muestra actividad reciente de ballenas en todos los activos"

Uso como librería de Rust

El módulo core/ no tiene ninguna dependencia de MCP: es una librería independiente. Impórtala directamente para bots personalizados, pipelines de datos o interfaces alternativas:

use crypto_conduit::core::providers::binance;
use crypto_conduit::core::analysis::fees;
use crypto_conduit::core::paper::portfolio;

Activos compatibles

Activo	Par de Binance	5m	15m	Horario	Diario	Mensual
BTC	BTCUSDT	Sí	Sí	Sí	Sí	Sí
ETH	ETHUSDT	Sí	Sí	Sí	Sí	Sí
SOL	SOLUSDT	Sí	Sí	Sí	Sí	Sí
XRP	XRPUSDT	Sí	Sí	Sí	Sí	Sí
DOGE	DOGEUSDT	Sí	Sí	Sí	Sí	Sí
BNB	BNBUSDT	Sí	Sí	Sí	Sí	No

Arquitectura

src/
├── main.rs              ← MCP server entry point
├── mcp/                 ← MCP tool layer (thin wrappers)
│   ├── mod.rs           ← Tool registration
│   ├── tools_*.rs       ← Tool handlers by category
│   └── formatter.rs     ← Response formatting
└── core/                ← Standalone library (no MCP dependency)
    ├── types.rs          ← Shared types
    ├── providers/        ← API clients (Polymarket, Binance, Chainlink)
    ├── analysis/         ← Fee model, momentum, book dynamics, divergence
    ├── paper/            ← Paper trading engine
    ├── execution/        ← Live trading (Polymarket SDK, risk manager)
    └── monitor/          ← Background polling, alerts, whale tracking, auto-trade

Licencia

AGPL-3.0: consulta LICENSE para más detalles.