PaulieB14/graph-polymarket-mcp

PaulieB14/graph-polymarket-mcp

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

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обязательный

    Which subgraph to check

get_account_pnl

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

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

    Ethereum address of the trader (lowercase)

get_builder_activity

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

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

    The builder code (bytes32 hex, as returned by get_builder_leaderboard)

  • limitinteger

    How many recent fills (default 20)

get_builder_leaderboard

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

Параметры
  • limitinteger

    How many builders to return (default 10)

  • orderByenum

    Ranking metric (default 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обязательный

    Market condition ID (hex string)

get_daily_stats

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

Параметры
  • daysnumber

    Number of recent days to return (1-90)

get_disputed_markets

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

Параметры
  • firstnumber

    Number of disputed markets to return

get_global_open_interest

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

Параметры

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

get_global_stats

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

Параметры

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

get_last_trade

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

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

    CLOB token ID

get_live_orderbook

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

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

    CLOB token ID

get_live_prices

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

Параметры
  • sideenum

    Price side: buy or sell

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

    Array of CLOB token IDs (get these from search_markets or get_market_info clobTokenIds field)

get_live_spread

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

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

    CLOB token ID

get_market_data

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

Параметры
  • firstnumber

    Number of markets to return (1-100)

  • orderBystring

    Field to order by

  • orderDirectionenum

    Sort direction

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

    Market condition ID (hex string)

  • slugstring

    Market slug (e.g. 'will-trump-win-2024')

get_market_open_interest

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

Параметры
  • firstnumber

    Number of markets to return (1-100)

  • orderByenum

    Field to rank markets by

  • orderDirectionenum

    Sort direction

get_market_positions

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

Параметры
  • firstnumber

    Number of positions to return

  • orderByenum

    Field to sort by

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

    The outcome token ID — same value as clobTokenIds from search_markets/get_market_info, token_id from get_clob_market, or makerAssetId/takerAssetId from get_orderbook_trades

get_market_resolution

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

Параметры
  • firstnumber

    Number of markets to return (1-100)

  • orderByenum

    Field to sort by

  • orderDirectionenum

    Sort direction

  • statusenum

    Optional: filter by resolution status

get_market_revisions

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

Параметры
  • firstnumber

    Number of revisions to return

  • questionIdstring

    Optional: filter revisions for a specific market questionId

get_oi_history

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

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

    The conditionId (hex string) of the market

  • firstnumber

    Number of hourly snapshots to return (default 168 = 1 week)

  • orderDirectionenum

    Sort direction by timestamp

get_orderbook_trades

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

Параметры
  • firstnumber

    Number of trades to return

  • makerstring

    Optional: filter by maker address

  • takerstring

    Optional: filter by taker address

get_polymarket_event

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

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

    Event ID or slug

get_price_history

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

Параметры
  • fidelitynumber

    Number of data points to return (1-500)

  • intervalenum

    Time interval: 1m, 5m, 1h, 6h, 1d, 1w, or max

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

    CLOB token ID

get_recent_activity

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

Параметры
  • accountstring

    Optional: filter by Ethereum address

  • firstnumber

    Number of events to return

get_subgraph_schema

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

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

    Subgraph identifier: main, beefy_pnl, slimmed_pnl, activity, or orderbook

get_top_traders

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

Параметры
  • firstnumber

    Number of traders to return (1-100)

  • minTradesnumber

    Minimum number of trades to filter out inactive accounts

  • orderByenum

    Metric to rank traders by

get_trader_profile

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

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

    Ethereum address of the trader

  • eventLimitnumber

    Number of recent events to return

get_trader_usdc_flows

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

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

    Ethereum address of the trader

  • directionenum

    Filter by transfer direction

  • firstnumber

    Number of transfers to return

get_user_positions

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

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

    Ethereum address of the user (lowercase)

get_v2_top_traders

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

Параметры
  • limitinteger

    How many traders (default 10)

  • orderByenum

    Ranking metric (default scaledCollateralVolume)

list_polymarket_events

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

Параметры
  • activeboolean

    Filter: only active events

  • ascendingboolean

    Sort ascending

  • closedboolean

    Filter: only closed events

  • limitnumber

    Number of events (1-100)

  • orderByenum

    Sort field

  • tagstring

    Filter by tag (e.g. 'politics', 'crypto', 'sports')

list_subgraphs

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

Параметры

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

query_subgraph

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

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

    GraphQL query string

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

    Subgraph identifier: main, beefy_pnl, slimmed_pnl, activity, or orderbook

  • variablesobject

    Optional GraphQL variables as key-value pairs

search_markets

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

Параметры
  • activeboolean

    Filter: only active markets

  • ascendingboolean

    Sort ascending (default: descending)

  • closedboolean

    Filter: only closed/resolved markets

  • limitnumber

    Number of results (1-100)

  • orderByenum

    Sort field

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

    Search text (e.g. 'Trump', 'Bitcoin', 'World Cup')

search_markets_enriched

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

Параметры
  • activeboolean

    Filter: only active markets

  • closedboolean

    Filter: only closed/resolved markets

  • limitnumber

    Number of results (1-20, kept small for enrichment speed)

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

    Search text (e.g. 'Trump', 'Bitcoin', 'World Cup')

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

Liquidiction/liquidiction-mcp

Liquidiction/liquidiction-mcp

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

TypeScript6
kukapay/polymarket-predictions-mcp

kukapay/polymarket-predictions-mcp

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

Python5
demwick/polymarket-agent-mcp

demwick/polymarket-agent-mcp

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

TypeScript16
tamasPetki/HeadlessTracker

tamasPetki/HeadlessTracker

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

TypeScript5
kukapay/thegraph-mcp

kukapay/thegraph-mcp

Сервер TheGraph MCP дает AI-агентам доступ к индексированным данным блокчейна через The Graph. Инструменты: получение схемы субграфа и выполнение GraphQL-запросов. Полезен разработчикам DeFi и аналитикам для анализа on-chain данных.

Python9
0x-devc/novai-mcp-server

0x-devc/novai-mcp-server

NOVAI MCP сервер - read-only инструмент для чтения блокчейна NOVAI через публичный JSON-RPC. Предоставляет MCP-агентам запросы статуса, блоков и AI-сущностей. Безопасен, не требует ключей. Полезен ...

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

Лука Никитин