MCP 服务器

Polymarket Gamma MCP Server

Enables discovery and analytics of Polymarket prediction markets, including trending markets, category filtering, text search, market/event details, and API usage tracking.

README

Polymarket Gamma MCP Server

MCP Server для работы с Polymarket Gamma Markets API - получение данных о рынках предсказаний, событиях и аналитике.

🚀 Возможности

📊 Основные функции:

Трендовые рынки - получение популярных рынков с высоким объёмом
Поиск рынков - поиск по тексту в вопросах и описаниях
Фильтрация по категориям - рынки по тегам (Politics, Sports, Crypto)
Детали рынков - полная информация о конкретном рынке
События - получение событий с связанными рынками
API Usage - отслеживание использования запросов

🔧 Технические особенности:

Без ключей API - публичный доступ к Gamma API
TypeScript - строгая типизация и валидация данных
Retry логика - автоматические повторы при сетевых ошибках
Форматированный вывод - удобное отображение данных на русском языке
Отслеживание лимитов - мониторинг использования API

📦 Установка

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

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

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

🛠️ Доступные инструменты

1. `get_trending_markets`

Получение трендовых рынков с высоким объёмом торгов.

Параметры:

limit (число, по умолчанию: 20) - количество рынков

Пример ответа:

{
  "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`

Получение рынков по категориям/тегам.

Параметры:

tags (массив строк, обязательно) - категории для фильтрации
limit (число, по умолчанию: 50) - количество рынков

Пример:

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

3. `search_markets`

Поиск рынков по текстовому запросу.

Параметры:

query (строка, обязательно) - поисковый запрос
limit (число, по умолчанию: 30) - количество результатов

4. `get_market_details`

Получение детальной информации о конкретном рынке.

Параметры:

marketId (строка, обязательно) - ID рынка

5. `get_events`

Получение событий с связанными рынками.

Параметры:

limit (число, по умолчанию: 20) - количество событий
active (булево, по умолчанию: true) - только активные события
orderBy (строка) - сортировка: volume, liquidity, endDate, createdAt

6. `get_event_details`

Получение детальной информации о событии.

Параметры:

eventId (строка, обязательно) - ID события

7. `get_api_usage`

Получение статистики использования API.

🔗 API Endpoints

Сервер использует следующие эндпоинты Gamma API:

GET /markets - список рынков
GET /markets/{id} - детали рынка
GET /events - список событий
GET /events/{id} - детали события

Базовый URL: https://gamma-api.polymarket.com

📊 Структура данных

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[];
}

🧪 Тестирование

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

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

⚠️ Ограничения

Публичный API - без ключей, но с разумными лимитами
Только чтение - нельзя размещать ордера (для этого нужен CLOB API)
Упрощённый поиск - пока без полнотекстового поиска
Данные с задержкой - не real-time котировки

🔄 Интеграция с Windsurf

Добавьте в 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"
    }
  }
}