Servidor MCP de Polymarket Gamma

Servidor MCP para trabajar con la API de Polymarket Gamma Markets: obtención de datos sobre mercados de predicción, eventos y análisis.

🚀 Características

📊 Funciones principales:

• Mercados en tendencia - obtención de mercados populares con alto volumen

• Búsqueda de mercados - búsqueda por texto en preguntas y descripciones

• Filtrado por categorías - mercados por etiquetas (Politics, Sports, Crypto)

• Detalles de mercados - información completa sobre un mercado específico

• Eventos - obtención de eventos con mercados asociados

• Uso de API - seguimiento del uso de solicitudes

🔧 Características técnicas:

• Sin claves API - acceso público a la API Gamma

• TypeScript - tipado estricto y validación de datos

• Lógica de reintentos - reintentos automáticos ante errores de red

• Salida formateada - visualización conveniente de datos en ruso

• Seguimiento de límites - monitoreo del uso de la API

Related MCP server: Polymarket MCP Server

📦 Instalación

# Клонировать и установить зависимости
npm install

# Собрать проект
npm run build

# Запустить тесты
npm test

🛠️ Herramientas disponibles

1. get_trending_markets

Obtención de mercados en tendencia con alto volumen de negociación.

Parámetros:

• limit (número, por defecto: 20) - cantidad de mercados

Ejemplo de respuesta:

{
  "summary": "Найдено 5 трендовых рынков",
  "apiUsage": "4/1000 запросов использовано, 996 осталось",
  "markets": "1. Will Joe Biden get Coronavirus before the election?\n   💰 Объём: $32,257 | 💧 Ликвидность: $0\n   🏷️ Теги: US-current-affairs\n   📊 Цены: Yes: 0.0% | No: 0.0%",
  "rawData": [...]
}

2. get_markets_by_category

Obtención de mercados por categorías/etiquetas.

Parámetros:

• tags (matriz de cadenas, obligatorio) - categorías para filtrar

• limit (número, por defecto: 50) - cantidad de mercados

Ejemplo:

{
  "tags": ["Politics", "US Election"],
  "limit": 20
}

3. search_markets

Búsqueda de mercados por consulta de texto.

Parámetros:

• query (cadena, obligatorio) - consulta de búsqueda

• limit (número, por defecto: 30) - cantidad de resultados

4. get_market_details

Obtención de información detallada sobre un mercado específico.

Parámetros:

• marketId (cadena, obligatorio) - ID del mercado

5. get_events

Obtención de eventos con mercados asociados.

Parámetros:

• limit (número, por defecto: 20) - cantidad de eventos

• active (booleano, por defecto: true) - solo eventos activos

• orderBy (cadena) - ordenación: volume, liquidity, endDate, createdAt

6. get_event_details

Obtención de información detallada sobre un evento.

Parámetros:

• eventId (cadena, obligatorio) - ID del evento

7. get_api_usage

Obtención de estadísticas de uso de la API.

🔗 Endpoints de API

El servidor utiliza los siguientes endpoints de la API Gamma:

• GET /markets - lista de mercados

• GET /markets/{id} - detalles del mercado

• GET /events - lista de eventos

• GET /events/{id} - detalles del evento

URL base: https://gamma-api.polymarket.com

📊 Estructura de datos

ProcessedMarket

{
  id: string;
  question: string;
  description?: string;
  outcomes: string[];
  prices: number[];
  volume: number;
  liquidity: number;
  endDate: string;
  tags: string[];
  active: boolean;
  closed: boolean;
  resolved: boolean;
  negRisk: boolean;
  spread?: number;
  slug: string;
  tokens: Array<{
    id: string;
    outcome: string;
    price: number;
    winner?: boolean;
  }>;
}

ProcessedEvent

{
  id: string;
  title: string;
  description?: string;
  slug: string;
  tags: string[];
  startDate?: string;
  endDate?: string;
  active: boolean;
  closed: boolean;
  volume?: number;
  liquidity?: number;
  marketsCount: number;
  topMarkets?: ProcessedMarket[];
}

🧪 Pruebas

# Основные тесты
npm test

# Отладка API структуры
node test/debug-api.js

⚠️ Limitaciones

1. API pública - sin claves, pero con límites razonables

2. Solo lectura - no se pueden realizar órdenes (para eso se necesita la API CLOB)

3. Búsqueda simplificada - aún sin búsqueda de texto completo

4. Datos con retraso - no son cotizaciones en tiempo real

🔄 Integración con Windsurf

Agregue a mcp_config.json:

{
  "mcpServers": {
    "polymarket-gamma": {
      "command": "node",
      "args": ["C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server/dist/index.js"],
      "cwd": "C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server"
    }
  }
}

📈 Uso

Este servidor es ideal para:

• Análisis de mercados - investigación de tendencias y volúmenes

• Monitoreo de eventos - seguimiento de nuevos mercados

• Investigaciones - recopilación de datos para análisis

• Detección de oportunidades - búsqueda de mercados interesantes

Para operaciones reales, use un servidor CLOB MCP separado.

🚀 Próximos pasos

1. ✅ Servidor API Gamma - listo y probado

2. 🔄 Servidor API CLOB - para operaciones comerciales

3. 🔄 Servidor WebSocket - para datos en tiempo real

4. 🔄 Servidor unificado - combinación de todas las funcionalidades