GridHub MCP Server

Актуальные и исторические данные о рынке электроэнергии для AI-агентов через Model Context Protocol.

Конечная точка: https://api.grid-hub.app/mcp — размещённая, Streamable HTTP, без состояния. Ничего устанавливать не нужно.

Охватывает 25 энергозон — ISO США (CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12 европейских ценовых зон, Великобританию и пять австралийских регионов NEM — приведённых к единой JSON-схеме. Данные получены от EIA, ENTSO-E, NESO, Elexon и AEMO; каждый ответ содержит свою лицензию и атрибуцию.

Инструменты

Related MCP server: Energy Grid MCP Server

Доступ

Три уровня, для начала регистрация не нужна:

1. Sample mode — подключение без учётных данных. Инструменты возвращают реальные текущие данные в усечённом виде (история ограничена 50 строками; brief возвращает один блок контекста). Результаты явно помечены.

2. Бесплатный API-ключ — 500 запросов в день. Мгновенная регистрация по email на grid-hub.app/developers или через POST https://api.grid-hub.app/v1/keys/signup с телом {"email": "..."}. Передавайте как Authorization: Bearer <ghk_key>.

3. x402, оплата за вызов — USDC в сети Base, $0.001–$0.02 за вызов, через заголовок X-PAYMENT. Подробнее см. процесс x402.

Настройка

Claude Code

claude mcp add --transport http gridhub https://api.grid-hub.app/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor / Windsurf / VS Code (mcp.json)

{
  "mcpServers": {
    "gridhub": {
      "url": "https://api.grid-hub.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop / claude.ai — добавьте https://api.grid-hub.app/mcp как пользовательский коннектор. Эти клиенты не отправляют пользовательские заголовки; передавайте ключ как необязательный аргумент инструмента api_key или используйте sample mode.

Локальный stdio-мост — для клиентов, поддерживающих только локальные (stdio) серверы. Он проксирует запросы к размещённой конечной точке через mcp-remote; локально ничего не запущено, кроме самого моста.

{
  "mcpServers": {
    "gridhub": {
      "command": "npx",
      "args": ["-y", "github:jalcodev/gridhub-mcp"],
      "env": { "GRIDHUB_API_KEY": "YOUR_KEY" }
    }
  }
}

Или с помощью Docker: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. Для sample mode опустите ключ.

Любой клиент, без ключа — опустите заголовок. Вы получите данные sample mode и заметку о том, как перейти на полный доступ.

Протокол

• Streamable HTTP, без состояния: одно JSON-RPC-сообщение на один POST, ответ в JSON. Никаких сессий, никакого SSE.

• Поддерживает MCP 2026-07-28 (запросы с зеркалированием заголовков, без рукопожатия) и версии с 2025-03-26 по 2025-11-25 (рукопожатие initialize).

• Результаты инструментов включают structuredContent наряду с текстовым блоком.

• Лимиты частоты и квоты — те же, что у базового REST API; слой MCP не добавляет своих.

Связанные ресурсы

• Документация REST API: https://grid-hub.app/developers

• OpenAPI: https://api.grid-hub.app/openapi.json

• llms.txt: https://api.grid-hub.app/llms.txt

• Официальная запись в реестре MCP: io.github.jalcodev/gridhub

Лицензия

Код в этом репозитории распространяется по лицензии MIT. Данные, возвращаемые сервисом, подчиняются лицензии каждого источника, указанной в каждом ответе (поля license и attribution).