MCP-сервер

MCP-сервер PolyTest (Model Context Protocol) позволяет ИИ-инструменту напрямую читать рыночные данные PolyTest. Он работает в Claude Code, Cursor, VS Code, Codex, Gemini CLI, Claude Desktop и других MCP-клиентах. Все его инструменты работают только на чтение.

Подключение

Размещённый сервер доступен по адресу https://mcp.polytest.io/mcp и использует Streamable HTTP. Команда для Claude Code добавляет сервер без ключа, а после этого вы входите через свой аккаунт PolyTest. Остальные примеры отправляют API-ключ из переменной окружения POLYTEST_KEY. Оба способа описаны в разделе Аутентификация.

claude mcp add --transport http polytest https://mcp.polytest.io/mcp

Строки для Claude Code и Gemini CLI выполняются в терминале. Блок для Cursor добавьте в ~/.cursor/mcp.json, для VS Code в .mcp.json, для Codex в ~/.codex/config.toml.

Аутентификация

Если ваш клиент поддерживает OAuth, войдите через аккаунт PolyTest. В Claude Code выполните /mcp, выберите polytest, а затем пункт «Authenticate». Если команда /mcp недоступна (например, в Claude Code внутри настольного приложения), выполните в терминале claude mcp login polytest из папки, в которой вы добавили сервер. Другие клиенты просят войти при подключении или при первом вызове инструмента.

Браузер откроет ссылку для входа на qpzofvjvtdvdnvgpxplg.supabase.co. Это адрес Supabase Auth, сервиса, через который PolyTest выполняет вход. Затем вход продолжится на www.polytest.io, где вы подтвердите подключение. Позже его можно удалить в Настройках, в разделе «Подключённые приложения».

Можно также отправлять API-ключ в заголовке Authorization: Bearer <key>. Заголовок X-API-Key тоже подходит. Создайте ключ на странице API-ключей и никогда не указывайте его в URL.

В Claude Code ключ передаётся в параметре --header:

Claude Code
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"

Локальный запуск

npx -y @polytest/mcp запускает сервер на вашем компьютере из npm-пакета @polytest/mcp. Ему нужен Node 20 или новее, а ваш ключ он читает из переменной окружения POLYTEST_KEY.

claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp

Блок для Claude Desktop добавьте в claude_desktop_config.json. Замените pt_live_... своим ключом.

Инструменты

У сервера пять инструментов. В последнем столбце указано, сколько запросов к API стоит один вызов.

ИнструментВозвращаетЗапросы к API
polytest_list_marketsРынки одного market_type для одной монеты, сначала новые. В каждой строке есть окно, status, спотовая цена на открытии и закрытии, победитель и объём.1
polytest_get_marketОдин рынок по market_id или slug, включая идентификаторы токенов и поля разрешения.1
polytest_get_snapshotsСнимки одного рынка, сначала старые, в каждом есть time, spot_price, price_up и price_down. С include_orderbook в каждой строке есть ещё и оба стакана.1
polytest_get_price_seriesТочки цены через равные интервалы по всему рынку, сначала старые.1 и ещё по одному на каждую точку, 21 по умолчанию
polytest_get_limitsЛимиты вашего тарифа: уровень, лимиты запросов, предел одновременных запросов, доступ к данным, предел числа ключей и пробный бюджет.1

price_up — самый низкий аск в стакане Up, то есть цена, которую вы заплатили бы за покупку Up в этот момент. price_down — то же самое для Down. Оба значения лежат в диапазоне от 0 до 1 и равны null, когда на эту сторону никто не выставил заявок на продажу. Это не средняя цена и не цена последней сделки. Поскольку оба значения — аски, сумма Up и Down обычно немного больше 1.

Обычно сессия вызывает polytest_list_markets, чтобы найти рынок, затем polytest_get_price_series, чтобы увидеть его динамику, а потом polytest_get_snapshots для тиковых данных или стакана в конкретный момент.

Покрытие и актуальность

В PolyTest есть рынки btc, eth и sol для 5m, 15m и 1hr, а для 4hr и 24hr — только btc.

PolyTest загружает новые рынки партиями, поэтому самые новые рынки могут отставать от реального времени на часы или дни. Отставание зависит от монеты и типа рынка.

В каждой строке рынка есть поле status:

  • upcoming: окно ещё не началось.
  • open: окно ещё идёт.
  • resolved: победитель известен.
  • ended_no_result: окно закрылось, а результата по нему в PolyTest нет.

Если вы запрашиваете самые новые рынки без end_time, а самый новый из них начался задолго до текущего момента, polytest_list_markets добавляет об этом примечание. Для рынка, который ещё идёт, polytest_get_price_series останавливается на текущем моменте, а не берёт точки из будущего. Если последние интервалы ряда приходят пустыми, он сообщает, где заканчиваются данные. Диапазон, который начинается после текущего момента, например у рынка, который ещё не начался, возвращает ошибку.

Лимиты и стоимость

Каждый вызов инструмента выполняет обычные запросы к API, поэтому учитывается в тех же лимитах тарифа, что и вызовы REST.

  • Лимиты запросов считаются по ключу, поэтому создайте отдельный ключ для MCP-сервера.
  • Одновременные запросы считаются вместе со всем остальным, что работает в вашем аккаунте. Если свободного слота нет, сервер недолго повторяет попытку.
  • polytest_get_limits возвращает trial_budget для любого аккаунта, включая платные. Это общий объём запросов, записей и байтов, который можно израсходовать за 3 дня бесплатного пробного периода, и действует он только во время пробного периода. Инструменты не показывают остаток: REST API сообщает оставшиеся объёмы только в заголовках ответа, а MCP-клиенты их не видят.
  • Размер результатов рассчитан на контекстное окно ИИ: страницы небольшие, а стаканы обрезаются до выбранной глубины. Для массовой выгрузки или бэктестов попросите ИИ написать код с TypeScript SDK или REST API.

Попробуйте

Когда сервер подключён, задавайте вопросы обычным языком. Например:

  • Покажи пять последних рынков BTC 5m на PolyTest и как менялась цена Up в самом новом из них.

  • Найди последний разрешившийся рынок BTC 15m на PolyTest и покажи оба стакана за тридцать секунд до закрытия.

  • Проверь лимиты моего тарифа PolyTest и скажи, сколько запросов к API стоит ценовой ряд из 40 точек.

Устранение неполадок

Ошибка инструмента сообщает, что API-ключ не указан или отклонён
В ошибке сказано, как это исправить в вашей конфигурации: задайте POLYTEST_KEY, добавьте заголовок Authorization или войдите заново. Ваши ключи находятся на странице API-ключей.
В ошибке инструмента упоминается ваш тариф
Этот запрос не входит в тариф. Попросите ИИ вызвать polytest_get_limits, чтобы увидеть, что в него входит.
Клиент сообщает, что серверу нужна аутентификация
Войдите, когда клиент это предложит, или добавьте заголовок Authorization из раздела Аутентификация.
Ошибка инструмента сообщает, что достигнут лимит запросов
В ошибке сказано, сколько ждать перед повторной попыткой.