Polymarket Scan MCP

Servidor MCP de PolymarketScan

Datos de solo lectura de los mercados de predicción de Polymarket.com para asistentes de IA. Conecta ChatGPT, Claude, Grok, Cursor, Claude Code o cualquier cliente MCP para obtener probabilidades implícitas del mercado (cuotas), historial de precios, los mayores movimientos, mercados en tendencia, operaciones grandes, flujo de compra y venta, estadísticas públicas de traders y noticias relacionadas.

• Sin cuenta, clave API ni OAuth. Cada herramienta es pública y de solo lectura.
• Solo lectura. Las herramientas no pueden colocar, modificar ni cancelar órdenes, mover fondos ni acceder a ninguna cuenta.
• Versión: 2.0.0 (octubre de 2026). Protocolo: MCP sobre Streamable HTTP (sin estado, respuestas JSON).

Endpoint

https://mcp.polymarketscan.org/mcp

La dirección original sigue funcionando y sirve al mismo servidor:

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

Herramientas (11)

Tu cliente MCP lee el esquema completo de entrada y salida de cada herramienta desde el servidor (tools/list). Toda entrada excepto las marcadas como obligatorias es opcional.

search_markets (Buscar mercados de predicción)

Busca mercados abiertos de Polymarket.com y devuelve las coincidencias más cercanas, cada una con hasta seis probabilidades implícitas del mercado de los resultados, cambio en 24 horas y volumen.

• Entradas: query (obligatorio): el evento, persona, equipo, activo o pregunta en palabras simples, hasta 200 caracteres. limit: de 1 a 10, por defecto 5.
• Notas: solo mercados abiertos. Los resultados que nombra la consulta aparecen primero, luego los líderes (o los peldaños de una escalera de precios más cercanos al 50%). Para la lista completa de resultados de un mercado, reglas y estado, usa get_market_odds.
• Prueba a preguntar: "¿Cuáles son las probabilidades para la próxima decisión de tipos de la Fed?"

get_market_odds (Obtener probabilidades de mercado)

Un mercado o evento completo: la probabilidad de cada resultado y su cambio en 24 horas (hasta 40 resultados, más el recuento total), volumen, liquidez, fecha de cierre, estado, reglas de resolución y fuente, y el resultado una vez resuelto.

• Entradas: market (obligatorio): un slug de mercado o evento, un enlace de polymarket.com o polymarketscan.org, un ID de condición (0x + 64 hex), o el mercado en palabras simples.
• Notas: funciona para mercados abiertos, cerrados y resueltos. Los resultados mutuamente excluyentes se clasifican por probabilidad. Si no hay coincidencias, devuelve hasta 3 de los mercados abiertos más cercanos en su lugar.
• Prueba a preguntar: "Muéstrame las posibilidades de cada candidato en las elecciones presidenciales de 2028."

get_price_history (Obtener historial de precios)

Cómo cambió la probabilidad de un resultado en un rango de tiempo: inicio y fin, cambio en puntos porcentuales, máximo y mínimo, y un gráfico.

• Entradas: market (obligatorio): igual que get_market_odds. outcome: el resultado a graficar, como "Sí" o el nombre de un candidato; por defecto es el resultado abierto líder de un evento de múltiples resultados, o el primer resultado de un mercado único. range: 1d, 1w, 1m, 3m o all, por defecto 1w.
• Notas: los precios provienen del historial del libro de órdenes de Polymarket.com. Los vacíos en mercados tranquilos se dejan sin rellenar. Para un mercado cerrado o resuelto, el rango termina cuando cerró la negociación.
• Prueba a preguntar: "¿Cómo han cambiado las probabilidades de una recesión en EE. UU. este mes?"

get_market_movers (Obtener mayores movimientos de mercado)

Mercados abiertos con los mayores cambios en 24 horas en probabilidad (en puntos porcentuales), con el resultado que se movió, su probabilidad actual y volumen en 24 horas; como máximo dos por evento.

• Entradas: direction: up, down o both, por defecto both. category: uno de politics, elections, geopolitics, world, economy, finance, crypto, tech, culture, sports, esports, weather o science; omítelo para todas las categorías. limit: de 1 a 20, por defecto 10.
• Notas: cubre los 300 mercados más negociados (por categoría cuando se indica una) con al menos $10K negociados en 24 horas. Los mercados con precios al 1% o menos o al 99% o más se excluyen por estar prácticamente decididos. Los juegos individuales de deportes y esports (partidos individuales y sus líneas de margen de puntos y total de puntos, próximos o en curso) se excluyen a menos que la categoría sea sports o esports; los futuros como un ganador de temporada o campeonato permanecen.
• Prueba a preguntar: "¿Qué mercados de predicción se movieron más hoy?"

get_trending_markets (Obtener mercados en tendencia)

Los eventos abiertos con más volumen de negociación en las últimas 24 horas, cada uno con hasta cuatro probabilidades de resultados (los líderes, o los peldaños de una escalera de precios más cercanos al 50%), cambio en 24 horas y volumen.

• Entradas: category: los mismos valores que get_market_movers; omítelo para todas las categorías. limit: de 1 a 20, por defecto 8.
• Notas: los eventos que ya parecen decididos (un resultado al 99% o más) y las hojas de apuestas secundarias de los juegos se excluyen. Los juegos individuales de deportes y esports (partidos individuales, próximos o en curso) se excluyen a menos que la categoría sea sports o esports; los futuros como un ganador de temporada o campeonato permanecen.
• Prueba a preguntar: "¿Qué está en tendencia en Polymarket en cripto?"

get_whale_trades (Obtener operaciones grandes)

Las operaciones recientes más grandes del feed público de operaciones de Polymarket.com, de mayor a menor, con hora, lado, resultado, tamaño en dólares, acciones, precio, mercado y la billetera y nombre público del trader.

• Entradas: min_usd: operación más pequeña en dólares estadounidenses, de 1,000 a 1,000,000, por defecto 10,000. market: limita a un mercado o evento (un slug, un enlace de polymarket.com o polymarketscan.org, un ID de condición, o unas pocas palabras); omítelo para todos los mercados. hours: cuánto tiempo hacia atrás mirar, de 1 a 168, por defecto 24. limit: de 1 a 50, por defecto 15.
• Notas: en todos los mercados, los llenados a 99¢ o más o 1¢ o menos (mercados prácticamente decididos) se excluyen. Cada llenado se cuenta una vez; los dólares son acciones por precio. Si el feed está demasiado ocupado para escanear toda la ventana, el resultado indica cuánto cubre.
• Prueba a preguntar: "Muéstrame operaciones de Polymarket superiores a $50K en las últimas 24 horas."

get_market_flow (Obtener flujo de mercado)

Quién está comprando y vendiendo un mercado: dólares comprados, vendidos y netos por resultado, el recuento de operaciones, hasta 8 operaciones más grandes y hasta 5 principales tenedores por resultado.

• Entradas: market (obligatorio): igual que get_market_odds. hours: cuánto tiempo hacia atrás mirar, de 1 a 168, por defecto 24.
• Notas: para un evento de múltiples resultados usa el resultado abierto líder (para una escalera de precios, el peldaño abierto más negociado) y lo indica. Los totales en dólares cuentan cada llenado una vez (su lado tomador), por lo que rondan la mitad del volumen bilateral que destaca Polymarket.com. En mercados muy activos, los llenados pequeños pueden omitirse para que quepa toda la ventana; el resultado lo indica.
• Prueba a preguntar: "¿Quién está comprando el mercado de Bitcoin a $150K?"

get_leaderboard (Obtener clasificación de traders)

La clasificación de traders de Polymarket.com por beneficio o volumen: rango, dirección completa de billetera, nombre público mostrado, beneficio y volumen en dólares, con un enlace al perfil.

• Entradas: metric: profit o volume, por defecto profit. period: day (desde las 00:00 UTC), week (7 días), month (30 días) o all, por defecto month. category: uno de sports, politics, crypto, economics, finance, tech, culture, esports, weather o mentions; omítelo para todos los mercados. limit: de 1 a 25, por defecto 10.
• Notas: el beneficio de día, semana y mes incluye posiciones abiertas a precios actuales; el beneficio de todos los tiempos es solo realizado. Polymarket no publica el volumen en dólares por categoría, por lo que los paneles por categoría lo dejan vacío.
• Prueba a preguntar: "¿Quiénes son los mejores traders de Polymarket por beneficio este mes?"

get_trader_profile (Obtener perfil de trader)

Las estadísticas públicas de un trader: nombre mostrado, beneficio realizado de todos los tiempos y volumen, valor de cartera, posiciones abiertas, mercados negociados, y hasta 5 posiciones más grandes y 8 operaciones más recientes.

• Entradas: trader (obligatorio): una dirección de billetera 0x completa (42 caracteres), un enlace de perfil de polymarket.com, un @usuario o un nombre de usuario.
• Notas: un nombre de usuario se compara exactamente cuando es posible; de lo contrario, se usa el perfil público más cercano y el resultado lo indica. Las operaciones recientes son aquellas de $1 o más. No indica quién controla una billetera.
• Prueba a preguntar: "Busca a este trader de Polymarket: 0x…"

get_trader_positions (Obtener posiciones de trader)

Hasta 50 posiciones abiertas de un trader con acciones, precio promedio y actual, valor y ganancia o pérdida no realizada, más el recuento total y el valor de cartera.

• Entradas: trader (obligatorio): igual que get_trader_profile. sort: value (mayor valor actual primero) o pnl (mayor ganancia no realizada primero), por defecto value. limit: de 1 a 50, por defecto 20.
• Notas: las posiciones que valen menos de $1 y las posiciones resueltas pendientes de canje se excluyen de la lista.
• Prueba a preguntar: "¿Cuáles son las posiciones abiertas más grandes de este trader?"

get_market_news (Obtener noticias de mercado)

Hasta 10 titulares de los últimos 14 días sobre un mercado o tema, con medio, hora de publicación y enlace, del feed de noticias de PolymarketScan de los principales medios.

• Entradas: market: un slug de mercado o evento, un enlace de polymarket.com o polymarketscan.org, o un ID de condición; las palabras simples se tratan como el tema. query: palabras del tema como "bitcoin etf"; con un mercado, conserva solo las noticias de ese mercado que las mencionan. limit: de 1 a 10, por defecto 5. Da un mercado, una consulta o ambos.
• Notas: no es una búsqueda web completa: no devuelve texto de artículos y puede no encontrar nada para mercados de nicho.
• Prueba a preguntar: "¿Hay noticias detrás del movimiento en el mercado de decisión de la Fed?"

Resultados

• Unidades son las mismas en cada herramienta: las probabilidades son de 0 a 1, los cambios de precio están en puntos porcentuales, los precios están en centavos, el dinero está en dólares estadounidenses y los recuentos de acciones están etiquetados como acciones. Un valor nulo significa que la cifra no está disponible, nunca cero. Las billeteras son direcciones completas en minúsculas, por lo que los resultados se pueden pasar directamente a las herramientas de traders.
• Pies de página. El texto de cada resultado termina con "Fuente: Polymarket.com vía PolymarketScan. Solo informativo, no es asesoramiento financiero." Los resultados sobre operaciones o posiciones (get_whale_trades, get_market_flow, get_leaderboard, get_trader_profile, get_trader_positions) añaden "Operar es arriesgado; puede ocurrir una pérdida del 100%." get_market_news termina con "Fuente: medios de noticias vía el feed de noticias de PolymarketScan. Solo informativo, no es asesoramiento financiero." en su lugar.
• Enlaces. Los enlaces de mercados y traders abren páginas de análisis de PolymarketScan y llevan ?ref=mcp, que marca la visita como proveniente de un asistente de IA. Ningún enlace de resultados lleva a una página de negociación en polymarket.com. Los titulares de noticias enlazan al artículo del editor.
• Errores. Si el servicio de datos de Polymarket no responde, una herramienta devuelve un mensaje breve en inglés sencillo pidiendo que lo intentes de nuevo. Nunca transmite un error bruto de origen o de base de datos.

La tarjeta

En hosts que admiten MCP Apps (como ChatGPT), los resultados se muestran en una tarjeta interactiva de PolymarketScan: probabilidades, gráficos de precios, listas clasificadas de mercados, operaciones y traders. La tarjeta no carga nada de la red por sí misma. En otros clientes, los mismos resultados llegan como datos estructurados más un resumen breve en inglés sencillo.

Añádelo a tu asistente

ChatGPT

• Directorio de plugins: una vez que PolymarketScan esté listado, abre el directorio de plugins en ChatGPT, busca "PolymarketScan" y conéctalo.
• Modo desarrollador (antes del listado, o para probar): activa Configuración → Seguridad e inicio de sesión → Modo desarrollador, ve a chatgpt.com/plugins, haz clic en +, ingresa https://mcp.polymarketscan.org/mcp y elige sin autenticación.

Claude (claude.ai y Claude Desktop)

• Directorio de conectores: una vez que PolymarketScan esté listado, añádelo desde Configuración → Conectores → Explorar conectores.
• Conector personalizado: Configuración → Conectores → Añadir conector personalizado. Nómbralo PolymarketScan, usa la URL https://mcp.polymarketscan.org/mcp y deja los campos OAuth vacíos.

Grok

Añade un conector personalizado (servidor MCP) con la URL https://mcp.polymarketscan.org/mcp y sin autenticación.

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

Añade a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

Clientes que solo ejecutan servidores locales (stdio)

Conecta con mcp-remote, por ejemplo en claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

Cualquier cliente MCP o HTTP simple

Apunta un cliente Streamable HTTP al endpoint. El servidor no tiene estado y responde JSON-RPC sobre POST /mcp con JSON:

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Fuente de datos

Las probabilidades, precios, operaciones, tenedores, clasificaciones y estadísticas de traders se obtienen de las APIs públicas de Polymarket.com cuando se llama a una herramienta. Los titulares de noticias provienen del propio feed de noticias de PolymarketScan de los principales medios. Las respuestas de Polymarket.com se almacenan en caché durante un minuto como máximo; las clasificaciones, los mercados liquidados y los nombres públicos de perfiles se almacenan en caché de 2 minutos a una hora.

Privacidad

El servidor solo recibe las llamadas a herramientas que hace un asistente, nunca tu conversación. Registra dos tipos de solicitudes: una conexión de cliente (initialize) y el uso de una herramienta (tools/call). El listado de herramientas y otros mensajes de protocolo no se registran. Cada registro contiene la acción (una conexión o el nombre de la herramienta), el tipo de cliente deducido del agente de usuario, los primeros 300 caracteres del agente de usuario, un hash con clave de la dirección IP que se conecta (HMAC-SHA-256 con un secreto del servidor, acortado) y la hora. Las entradas y resultados de las herramientas no se almacenan. Detalles: Política de privacidad, sección 3.

Aviso legal

Fuente: Polymarket.com vía PolymarketScan. Solo informativo, no es asesoramiento financiero. Las probabilidades implícitas del mercado son pronósticos de la multitud, no certezas. Los datos pueden estar retrasados o ser incorrectos; verifica las cifras importantes en la página enlazada. Operar conlleva riesgo; se puede perder el 100%.

PolymarketScan es una plataforma de análisis independiente, no Polymarket. Términos de servicio · Política de privacidad · Contacto · support@polymarketscan.org