Добавить сервер
PaulieB14/graph-polymarket-mcp
  1. Каталог MCP
  2. PaulieB14/graph-polymarket-mcp

PaulieB14/graph-polymarket-mcp

от paulieb14
MCP сервер для запроса данных рынка предсказаний Polymarket через The Graph и REST API. Дает AI агентам 31 инструмент: поиск рынков, цены, стаканы, P&L, open interest и статусы разрешения. Часть да...
GithubNPMСайт сервера

graph-polymarket-mcp

npm version MCP Registry smithery badge

MCP server for querying Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs.

Exposes 31 tools that AI agents (Claude, Cursor, etc.) can use to search markets, get real-time CLOB prices and order books, query on-chain data, trader P&L, positions, activity, open interest, market resolution status, and trader profiles.

v2.0.0 — adds 10 new tools powered by Polymarket's Gamma and CLOB APIs (inspired by polymarket-cli): market search, event browsing, live prices, spreads, order books, price history, and more. No API key needed for these tools — they hit Polymarket's public REST endpoints directly.

Published to the MCP Registry as io.github.PaulieB14/graph-polymarket-mcp

Prerequisites

You need a free Graph API key (takes ~2 minutes):

  1. Go to The Graph Studio
  2. Connect your wallet (MetaMask, WalletConnect, etc.)
  3. Click "API Keys" in the sidebar and create one
  4. Free tier includes 100,000 queries/month

Installation

npm install -g graph-polymarket-mcp
Инструменты были проиндексированы:
check_subgraph_freshness

Сообщает, насколько сабграф отстаёт от вершины цепочки, читая его блок _meta. Стоит вызывать перед тем, как доверять любому числу 'current' или 'latest', потому что отстающий сабграф возвращает устаревшие данные, а не ошибку: он успешно выполняется, просто отвечает о прошлом.

Параметры
  • subgraphenumобязательный

    Какой подграф проверить

get_account_pnl

Получает P&L трейдера и метрики производительности из Beefy P&L subgraph

Параметры
  • accountstringобязательный

    Адрес Ethereum трейдера (в нижнем регистре)

get_builder_activity

Последние заполнения, направленные одним кодом сборщика Polymarket CLOB V2, с общими итогами этого сборщика. Сначала используйте get_builder_leaderboard, чтобы найти идентификатор сборщика. Только для эпохи V2.

Параметры
  • builderIdstringобязательный

    Код билдера (bytes32 hex, как возвращает get_builder_leaderboard)

  • limitinteger

    Сколько последних сделок (по умолчанию 20)

get_builder_leaderboard

Ранжирует билдеров Polymarket CLOB V2 по объему проведенного трафика, количеству ордеров или комиссиям. «Билдер» — это фронтенд/бот/интегратор, чей код прикреплен к заполнению: это отвечает на вопрос «кто на самом деле направляет трафик», на что не способен ни один subgraph V1, потому что контракты V1 никогда не передавали эту информацию. Только эра V2 (начиная с блока 84902353, миграция 2026-04-28).

Параметры
  • limitinteger

    Сколько сборщиков возвращать (по умолчанию 10)

  • orderByenum

    Метрика ранжирования (по умолчанию scaledVolume)

get_clob_market

Получает детали рынка CLOB по condition ID. Возвращает идентификаторы токенов (token_id) с актуальными ценами, минимальными размерами ордеров/тиков и статусом рынка. Служит мостом между on-chain condition ID и торговыми данными CLOB. Используйте полученные значения token_id с get_live_prices, get_live_spread, get_live_orderbook, get_price_history или get_market_positions.

Параметры
  • conditionIdstringобязательный

    ID состояния рынка (hex-строка)

get_daily_stats

Получает ежедневную статистику платформы из сабграфа Beefy P&L: объём, комиссии, количество трейдеров и активность рынка за день. Используйте это для анализа трендов и исторической производительности.

Параметры
  • daysnumber

    Количество последних дней для возврата (1-90)

get_disputed_markets

Получает рынки Polymarket, которые были оспорены в процессе разрешения оракула UMA. Споры возникают, когда кто-то оспаривает предложенный исход — это события с высокой информативностью.

Параметры
  • firstnumber

    Количество оспариваемых рынков для возврата.

get_global_open_interest

Получает общий открытый интерес по всем рынкам Polymarket - совокупный USDC, заблокированный в открытых позициях на всей платформе.

Параметры

Без параметров.

get_global_stats

Получает агрегированную статистику платформы Polymarket. Объединяет количество рынков из Main subgraph с точными данными об объёме/комиссиях/сделках из Orderbook subgraph.

Параметры

Без параметров.

get_last_trade

Получает последнюю цену сделки для токена исхода Polymarket из CLOB.

Параметры
  • tokenIdstringобязательный

    Идентификатор токена CLOB.

get_live_orderbook

Получает полную книгу заявок в реальном времени (заявки на покупку и продажу) для токена исхода Polymarket из CLOB. Показывает все лимитные ордера, находящиеся в ожидании, с ценами и объёмами.

Параметры
  • tokenIdstringобязательный

    Идентификатор токена CLOB.

get_live_prices

Получает цены CLOB в реальном времени для токенов исходов Polymarket. Возвращает текущую лучшую цену на покупку или продажу. Идентификаторы токенов берутся из: clobTokenIds в search_markets/get_market_info, или token_id в get_clob_market.

Параметры
  • sideenum

    Сторона цены: покупка или продажа

  • tokenIdsstring[]обязательный

    Массив идентификаторов токенов CLOB (получите их из search_markets или из поля clobTokenIds в get_market_info)

get_live_spread

Получает спред bid-ask в реальном времени для токена исхода Polymarket. Возвращает лучшую цену покупки, лучшую цену продажи и спред. Полезен для оценки ликвидности рынка и торговых издержек.

Параметры
  • tokenIdstringобязательный

    Идентификатор токена CLOB.

get_market_data

Получает данные рынка/условий Polymarket, включая исходы и объемы, из Main subgraph.

Параметры
  • firstnumber

    Сколько рынков вернуть (1-100)

  • orderBystring

    Поле для сортировки

  • orderDirectionenum

    Направление сортировки

get_market_info

Получает детальную информацию о рынке Polymarket по идентификатору slug или condition ID. Возвращает полные метаданные рынка из Gamma API, включая описание, цены, исходы и CLOB token IDs. Используйте возвращённый conditionId для запроса get_clob_market для получения текущих данных CLOB, get_market_open_interest для OI или get_market_resolution для статуса оракула.

Параметры
  • conditionIdstring

    ID состояния рынка (hex-строка)

  • slugstring

    Слаг рынка (например, 'will-trump-win-2024')

get_market_open_interest

Получает топовые рынки Polymarket, отсортированные по открытому интересу (USDC, заблокированный в открытых позициях). Эти данные уникальны для сабграфа Open Interest — никакой другой сабграф Polymarket не отслеживает OI.

Параметры
  • firstnumber

    Сколько рынков вернуть (1-100)

  • orderByenum

    Поле, по которому ранжируются рынки.

  • orderDirectionenum

    Направление сортировки

get_market_positions

Получает топ позиций для конкретного рыночного токена из P&L подграфа Beefy. Показывает, кто держит крупнейшие позиции и их P&L.

Параметры
  • firstnumber

    Количество возвращаемых позиций

  • orderByenum

    Поле для сортировки

  • tokenIdstringобязательный

    Идентификатор токена исхода: то же значение, что и clobTokenIds из search_markets/get_market_info, token_id из get_clob_market или makerAssetId/takerAssetId из get_orderbook_trades.

get_market_resolution

Получает статус разрешения оракула UMA для рынков Polymarket. Показывает, инициализирован ли рынок, предложен, оспорен или разрешён, а также предложенные/окончательные цены и историю споров.

Параметры
  • firstnumber

    Сколько рынков вернуть (1-100)

  • orderByenum

    Поле для сортировки

  • orderDirectionenum

    Направление сортировки

  • statusenum

    Необязательно: фильтр по статусу решения.

get_market_revisions

Получает ревизии/обновления модераторов для рынков Polymarket. Показывает, когда и как модераторы вмешивались в разрешение рынка.

Параметры
  • firstnumber

    Количество возвращаемых ревизий

  • questionIdstring

    Опционально: фильтровать ревизии для конкретного questionId по рынку.

get_oi_history

Получает почасовые снимки открытого интереса для конкретного рынка Polymarket. Использует их для построения графика трендов OI с течением времени. Идентификатор conditionId можно получить из get_market_open_interest или основного подграфа.

Параметры
  • conditionIdstringобязательный

    conditionId (шестнадцатеричная строка) рынка

  • firstnumber

    Количество почасовых снимков для возврата (по умолчанию 168 = 1 неделя)

  • orderDirectionenum

    Направление сортировки по временной метке.

get_orderbook_trades

Получает последние исполнения ордеров из подграфа Orderbook.

Параметры
  • firstnumber

    Количество возвращаемых сделок.

  • makerstring

    Необязательно: фильтр по адресу maker

  • takerstring

    Необязательно: фильтровать по адресу тейкера.

get_polymarket_event

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

Параметры
  • eventIdstringобязательный

    ID события или slug

get_price_history

Получает исторические данные о ценах для токена исхода Polymarket. Возвращает точки цен временного ряда для построения графиков и анализа трендов.

Параметры
  • fidelitynumber

    Количество возвращаемых точек данных (1-500)

  • intervalenum

    Интервал времени: 1m, 5m, 1h, 6h, 1d, 1w или max

  • tokenIdstringобязательный

    Идентификатор токена CLOB.

get_recent_activity

Получает последние сплиты, слияния и погашения из Activity subgraph

Параметры
  • accountstring

    Необязательно: фильтровать по адресу Ethereum

  • firstnumber

    Количество возвращаемых событий.

get_subgraph_schema

Получает полную схему GraphQL (introspection) для сабграфа Polymarket

Параметры
  • subgraphenumобязательный

    Идентификатор подграфа: main, beefy_pnl, slimmed_pnl, activity или orderbook.

get_top_traders

Получает список лучших трейдеров Polymarket, отсортированных по реализованному P&L, проценту побед или объему из подграфа Beefy P&L.

Параметры
  • firstnumber

    Количество возвращаемых трейдеров (1-100)

  • minTradesnumber

    Минимальное количество сделок для отсеивания неактивных аккаунтов.

  • orderByenum

    Метрика для ранжирования трейдеров.

get_trader_profile

Получает ончейн-профиль трейдера из подграфа Traders: когда они впервые появились, их недавние события CTF (разделения, слияния, переводы) и потоки USDC.

Параметры
  • addressstringобязательный

    Ethereum-адрес трейдера

  • eventLimitnumber

    Количество последних событий для возврата.

get_trader_usdc_flows

Получает историю депозитов и выводов USDC для трейдера. Показывает входящие и исходящие переводы USDC, полезно для отслеживания момента, когда трейдеры пополняют или выводят средства с Polymarket.

Параметры
  • addressstringобязательный

    Ethereum-адрес трейдера

  • directionenum

    Фильтрует по направлению передачи.

  • firstnumber

    Количество возвращаемых переводов.

get_user_positions

Получает текущие позиции пользователя из подграфа Slimmed P&L. Корректно откатывается, если индексаторы отстают.

Параметры
  • accountstringобязательный

    Ethereum-адрес пользователя (в нижнем регистре)

get_v2_top_traders

Лучшие реальные трейдеры на Polymarket CLOB V2 по объёму или количеству сделок, исключая контракты биржи. Используйте этот инструмент вместо прямого запроса аккаунтов: биржа V2 сама выступает в роли taker, когда ордер совпадает с книгой заявок — она накапливает строку Account и превосходит любого человека на порядок. Только эра V2 (начиная с блока 84902353).

Параметры
  • limitinteger

    Сколько трейдеров (по умолчанию 10)

  • orderByenum

    Метрика ранжирования (по умолчанию scaledCollateralVolume)

list_polymarket_events

Перечисляет события Polymarket (группы связанных рынков). События объединяют несколько рынков Yes/No под одной темой (например, 'US Presidential Election 2024' содержит множество рынков кандидатов). Использует API Gamma.

Параметры
  • activeboolean

    Фильтр: только активные события

  • ascendingboolean

    Сортирует по возрастанию.

  • closedboolean

    Фильтр: только закрытые события

  • limitnumber

    Количество событий (1-100)

  • orderByenum

    Поле сортировки

  • tagstring

    Фильтрует по тегу (например, 'politics', 'crypto', 'sports')

list_subgraphs

Перечисляет все доступные подграфы Polymarket с описаниями и ключевыми сущностями.

Параметры

Без параметров.

query_subgraph

Выполняет пользовательский GraphQL-запрос к подграфу Polymarket.

Параметры
  • querystringобязательный

    Строка GraphQL-запроса

  • subgraphenumобязательный

    Идентификатор подграфа: main, beefy_pnl, slimmed_pnl, activity или orderbook.

  • variablesobject

    Необязательные переменные GraphQL в виде пар ключ-значение.

search_markets

Ищет рынки предсказаний Polymarket по текстовому запросу. Возвращает метаданные рынка: вопрос, цены, объём, ликвидность и идентификаторы токенов CLOB. Использует Gamma API для поиска рынков в реальном времени. Объединяйте с: get_clob_market(conditionId) для получения книги ордеров в реальном времени, get_live_prices(clobTokenIds) для токен-уровневых цен, get_market_open_interest для заблокированного капитала или get_market_resolution для статуса оракула.

Параметры
  • activeboolean

    Фильтр: только активные рынки

  • ascendingboolean

    Сортировать по возрастанию (по умолчанию: по убыванию)

  • closedboolean

    Фильтр: только закрытые/разрешенные рынки

  • limitnumber

    Количество результатов

  • orderByenum

    Поле сортировки

  • querystringобязательный

    Ищет текст (например, «Trump», «Bitcoin», «World Cup»).

search_markets_enriched

Мощный инструмент: ищет рынки Polymarket, затем автоматически обогащает каждый результат актуальными ценами CLOB и статусом разрешения в сети. Объединяет Gamma API + CLOB API + The Graph в одном вызове — не нужно вручную объединять инструменты.

Параметры
  • activeboolean

    Фильтр: только активные рынки

  • closedboolean

    Фильтр: только закрытые/разрешенные рынки

  • limitnumber

    Количество результатов (1–20, поддерживается небольшим для скорости обогащения)

  • querystringобязательный

    Ищет текст (например, «Trump», «Bitcoin», «World Cup»).

2.1.2основная
2.1.1
2.1.0
1.7.0
2.0.0
1.6.1
1.6.0
1.5.0
1.4.0
1.3.1
1.3.0
1.2.3
1.2.2
1.2.1
1.2.0
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.1
1.0.0

Выберите клиент, чтобы установить PaulieB14/graph-polymarket-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"paulieb14-graph-polymarket-mcp-2j9lw0efyz\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"graph-polymarket-mcp\"],\"env\":{\"GRAPH_API_KEY\":\"your-api-key-here\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add paulieb14-graph-polymarket-mcp-2j9lw0efyz --env GRAPH_API_KEY=your-api-key-here -- npx -y graph-polymarket-mcp

Либо через JSON-конфиг:

claude mcp add-json paulieb14-graph-polymarket-mcp-2j9lw0efyz "{\"command\":\"npx\",\"args\":[\"-y\",\"graph-polymarket-mcp\"],\"env\":{\"GRAPH_API_KEY\":\"your-api-key-here\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add paulieb14-graph-polymarket-mcp-2j9lw0efyz --env GRAPH_API_KEY=your-api-key-here -- npx -y graph-polymarket-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.paulieb14-graph-polymarket-mcp-2j9lw0efyz]
command = "npx"
args = ["-y", "graph-polymarket-mcp"]

[mcp_servers.paulieb14-graph-polymarket-mcp-2j9lw0efyz.env]
GRAPH_API_KEY = "your-api-key-here"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите PaulieB14/graph-polymarket-mcp, а в поле команды запуска — строку ниже:
npx -y graph-polymarket-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например paulieb14-graph-polymarket-mcp-2j9lw0efyz.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: paulieb14-graph-polymarket-mcp-2j9lw0efyz
    command: npx
    args:
      - "-y"
      - "graph-polymarket-mcp"
    env:
      GRAPH_API_KEY: your-api-key-here
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "paulieb14-graph-polymarket-mcp-2j9lw0efyz": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Похожие MCP-сервера

demwick/polymarket-agent-mcp

demwick/polymarket-agent-mcp

от demwick

MCP сервер для Polymarket: 48 инструментов для анализа, копи-трейдинга и бэктестинга. Используется трейдерами и аналитиками для автоматизации работы на рынках предсказаний.

TypeScript⭐ 16
Liquidiction/liquidiction-mcp

Liquidiction/liquidiction-mcp

от liquidiction

MCP сервер Liquidiction даёт AI-агентам прямой доступ к живым данным прогнозных рынков HIP-4 на Hyperliquid. Через 10 инструментов можно получить котировки, стаканы, историю сделок — без API-ключа. Идеально для Claude, GPT и кастомных агентов.

TypeScript⭐ 6
tamasPetki/HeadlessTracker

tamasPetki/HeadlessTracker

от tamaspetki

MCP сервер для агрегации крипто-портфеля: читает балансы бирж, кошельков и рынков предсказаний в режиме read-only. API-ключи хранятся локально и не передаются ИИ-хосту. Полезен инвесторам и трейдер...

TypeScript⭐ 6
@iiatlas/hledger-mcp

@iiatlas/hledger-mcp

от iiatlas

MCP-сервер для интеграции AI-ассистентов с бухгалтерской системой hledger. Позволяет запрашивать балансы, формировать отчёты (баланс, P&L, cash flow), добавлять проводки и анализировать данные чере...

TypeScript⭐ 65
kukapay/polymarket-predictions-mcp

kukapay/polymarket-predictions-mcp

от kukapay

С MCP-сервером вы получаете реальные рыночные шансы Polymarket. AI-агенты и аналитики могут искать события, сравнивать вероятности и анализировать децентрализованные предсказания – всё в чистых таб...

Python⭐ 5
PaulieB14/graph-aave-mcp

PaulieB14/graph-aave-mcp

от paulieb14

MCP-сервер для AAVE V2-V4 с 50+ инструментами через 17 сабграфов и Aave V4 API. Охватывает lending-рынки, позиции пользователей и health factor. Включает кросчейн-мониторинг ликвидаций, управление ...

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин