polymarket-mcp

Inteligencia de mercado de predicción para agentes de IA. Puntuaciones de billeteras, detección de arbitraje, análisis de liquidez y feeds de precios en tiempo real para Polymarket, respaldados por datos propietarios de más de 195 billeteras on-chain seleccionadas.

¿Qué puede hacer?

Pregúntale a tu agente de IA:

• "Encuentra todos los mercados de Polymarket donde los precios de SÍ + NO no suman el 100%"

• "¿Cuál es el deslizamiento si compro $500 de SÍ en el mercado de Bitcoin a $100k?"

• "Muéstrame las 20 mejores billeteras en Polymarket por puntuación y PnL"

• "¿Qué billeteras operan junto a esta ballena? Encuentra la red en la sombra."

• "¿Cuál es el grado de liquidez para este mercado? ¿Es seguro entrar?"

• "Calcula el riesgo de mi cartera en estas 5 posiciones"

• "¿Cuál es la probabilidad de que Bitcoin alcance los $150k para junio?"

• "Escanea las noticias cripto de hoy y compáralas con los mercados abiertos de Polymarket"

Instalación

pip install polymarket-trading-mcp

O ejecútalo directamente:

uvx --python 3.11 polymarket-trading-mcp

Configuración MCP

Añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "polymarket": {
      "command": "polymarket-mcp",
      "args": ["--stdio"]
    }
  }
}

Ejecutar como servidor SSE:

polymarket-mcp
# Starts on http://127.0.0.1:8000/sse

Ejecutar como HTTP transmitible:

polymarket-mcp --http
# Starts on http://127.0.0.1:8000/mcp

Luego apunta tu cliente a http://127.0.0.1:8000/sse o http://127.0.0.1:8000/mcp.

Comparativa

Herramientas

Herramientas gratuitas

Recorre el libro de órdenes CLOB y calcula el precio medio de ejecución para un tamaño de posición dado.

estimate_slippage(
    market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328",
    side="BUY",
    position_size_usd=500.0
)

Devuelve: best_price, avg_fill_price, slippage_pct, liquidity_available, recommendation (go/caution/no-go).

Escanea la profundidad de liquidez de un mercado con spread y profundidad al 1%/2%/5% desde el precio medio.

scan_market_liquidity(market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328")

Devuelve: best_bid, best_ask, spread_pct, cubos de profundidad, liquidity_grade (A/B/C).

Escanea todos los mercados activos de Polymarket en busca de sumas de precios SÍ + NO que no sean iguales a 1.00.

find_arbitrage_gaps(min_gap_pct=2.0)

Devuelve: mercados con brechas, tamaño de la brecha y dirección para explotar (BUY_BOTH o SELL_BOTH).

Precio cripto en tiempo real de Binance y/o CoinGecko en paralelo, con metadatos de latencia.

get_crypto_price(symbol="BTC", sources="binance,coingecko")

Devuelve: precios por fuente, promedio, desviación máxima entre fuentes.

Tiempo restante y estado de resolución para contratos activos de Polymarket. Los contratos BTC de 5 min/15 min utilizan el análisis de marca de tiempo del slug para un vencimiento exacto.

get_contract_status(market_id="btc-updown-5m-1711234567")
get_contract_status(category="crypto")  # scan all short-duration contracts

Devuelve: time_remaining_seconds, time_remaining_human, current_odds.

Estima la probabilidad de cualquier evento utilizando razonamiento estructurado. Tasas base, factores clave, análisis de marco temporal: todo en una respuesta JSON estructurada.

estimate_probability(question="Will Bitcoin reach $150k before end of 2025?")

Devuelve: estimated_probability (0-1), confidence_level, factors_for, factors_against, base_rate_note, reasoning.

Métricas de riesgo matemático puro para una cartera de posiciones en mercados de predicción. Sin llamadas a API externas.

calculate_portfolio_risk(positions='[{"market_id": "abc123", "side": "YES", "size": 200, "entry_price": 0.65}]')

Devuelve: total_exposure, max_loss, max_gain, diversification_score, kelly_warnings, rebalancing_suggestions.

Devuelve la metodología de puntuación, estadísticas actuales del conjunto de datos y precios. Llama a esto primero para evaluar si los datos de pago valen la pena. No se requiere clave API.

Herramientas de pago (se requiere clave API)

Prueba gratuita de 7 días al registrarse. Después de la prueba: pago por solicitud en USDC en Polygon. Descuento por volumen: 50% de descuento por encima de 1000 solicitudes/día.

Encuentra billeteras que operan junto a una billetera semilla en las mismas categorías de Polymarket.

get_shadow_wallets(seed_wallet="0xabc...", api_key="your-key")

Devuelve: hasta 20 billeteras en la sombra clasificadas por intensidad de co-trading, categorías compartidas, tasas de victoria.

Billeteras de Polymarket mejor clasificadas por el motor de puntuación de MoonMirror (PnL + consistencia + especialización - penalización por drawdown).

get_top_wallets(api_key="your-key", limit=50, min_score=0.5)

Desglose completo de puntuación para una dirección de billetera específica.

get_wallet_score(address="0xabc...", api_key="your-key")

Devuelve: componentes de puntuación, tasa de victoria, recuento de operaciones, frescura de los datos.

PnL realizado para una billetera con desglose por categoría. Pre-calculado a partir del subgrafo de Goldsky.

get_wallet_pnl(address="0xabc...", api_key="your-key")

Billeteras que aparecen de forma independiente junto a más de 3 billeteras de alta puntuación: una señal más fuerte que una sola coincidencia en la sombra.

get_wallet_clusters(api_key="your-key", min_co_trades=3)

Contratos activos de Polymarket de BTC de 5 min y 15 min con IDs de token y precios medios actuales. En caché, actualizado cada 60 segundos.

get_btc_short_markets(api_key="your-key")

Análisis probabilístico estructurado para una pregunta de mercado de predicción utilizando el razonamiento de Claude.

analyze_market_sentiment(question="Will Ethereum ETF hit $10B AUM by Q3 2025?", api_key="your-key")

Precios

Paquetes independientes también disponibles: polymarket-slippage, polymarket-liquidity, polymarket-arb-detector, polymarket-price-feed, polymarket-sentiment, polymarket-timer, polymarket-news, polymarket-onchain

¿Por qué este servidor?

Todos los demás servidores MCP de Polymarket consultan APIs públicas. Nosotros tenemos inteligencia de billeteras propietaria: puntuaciones seleccionadas, datos reales de PnL de Goldsky y redes de billeteras en la sombra descubiertas a través de minería de contrapartes. Datos que no puedes obtener en ningún otro lugar.

Las herramientas de billetera de pago están respaldadas por MoonMirror, un motor de inteligencia de billeteras de Polymarket. MoonMirror monitorea continuamente las billeteras on-chain, las puntúa según PnL, consistencia y especialización de mercado, y pre-calcula las relaciones de las billeteras en la sombra.

Todas las consultas de billeteras devuelven resultados en < 100ms porque todo está pre-calculado. Sin llamadas de bloqueo al subgrafo.

Configuración

Todos los ajustes a través de variables de entorno:

# Server
HOST=127.0.0.1
PORT=8000

# DB paths (for self-hosted wallet intelligence)
MOONMIRROR_DB_PATH=/path/to/moonmirror.db
SERVICES_DB_PATH=/path/to/services.db

# Pricing
PRICE_WALLET_INTEL=0.05
PRICE_MARKET_DATA=0.01
TRIAL_DAYS=7

# Rate limiting
RATE_PER_KEY=5
RATE_GLOBAL=20

# Create an API key
polymarket-mcp --create-key "customer-name"

# Top up a key's USDC balance
polymarket-mcp --top-up YOUR_KEY 10.0

github.com/whitmorelabs/polymarket-mcp — problemas, PRs y estrellas son bienvenidos.