MCP: статистика RealmPulse в вашем ИИ-ассистенте

RealmPulse публикует статистику игроков по протоколу MCP (Model Context Protocol) — ваш ИИ-ассистент сможет отвечать вопросы о классах, уровнях, зонах и конкретных игроках прямо во время чата. Доступ бесплатный; для полного набора инструментов нужен бесплатный API-ключ.

Подключение

Сервер работает по HTTP без сессий — укажите его URL в любом MCP-клиенте. Например, для Claude Code:

claude mcp add --transport http realmpulse https://foragerstats.com/mcp

Или универсальный JSON-конфиг (Claude Desktop, Cursor и другие):

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp" } } }

Гостевой доступ (без ключа)

Без регистрации доступен один инструмент — get_class_distribution: распределение игроков по классам и фракциям с фильтром по игровому режиму. Лимит — 30 запросов в минуту.

Бесплатный API-ключ

1. Зарегистрируйтесь: кнопка «Регистрация» вверху страницы.
2. Откройте профиль и создайте API-ключ — он покажется один раз, сохраните его.
3. Добавьте заголовок Authorization: Bearer <ключ> в запросы к /mcp (в большинстве клиентов это поле headers конфига).

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp", "headers": { "Authorization": "Bearer rp_..." } } } }

Инструменты

• get_class_distribution — распределение игроков по классам и фракциям (доступен без ключа).
• search_players — поиск игроков по имени, классу и зоне — доступен после регистрации.
• get_level_distribution — количество игроков по уровням 1–60 — после регистрации.
• get_zone_stats — самые населённые зоны — после регистрации.
• upload_saved_variables — загрузить свой файл NearbySpy.lua в общий сбор данных (нужен API-ключ)

Фильтр mode принимает ровно три значения: pve, pvp, hardcore. Другое значение — явная ошибка с перечислением допустимых; без mode возвращаются данные по всем режимам.

Пример запроса

POST /mcp MCP-Protocol-Version: 2026-07-28 Mcp-Method: tools/call Mcp-Name: get_class_distribution { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_class_distribution", "arguments": { "mode": "pve" } } }

Лимиты: 30 запросов в минуту без ключа, 120 — с ключом. При превышении сервер отвечает 429 — повторите позже.