GridHub MCP Server
Live and historical electricity market data for AI agents, over the Model Context Protocol.
Endpoint: https://api.grid-hub.app/mcp — hosted, Streamable HTTP, stateless. Nothing to install.
Covers 25 grid zones — US ISOs (CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12 European bidding zones, Great Britain, and the five Australian NEM regions — normalised into one JSON schema. Sourced from EIA, ENTSO-E, NESO, Elexon and AEMO; every response carries its licence and attribution.
Tools
Access
Three levels, no signup needed to start:
- Sample mode — connect with no credentials. Tools return real, current data, truncated (history capped at 50 rows; brief returns one context block). Results are clearly marked.
- Free API key — 500 requests/day. Instant email signup at grid-hub.app/developers, or
POST https://api.grid-hub.app/v1/keys/signup with {"email": "..."}. Send as Authorization: Bearer <ghk_key>.
- x402 pay-per-call — USDC on Base, $0.001–$0.02 per call, via the
X-PAYMENT header. See the x402 flow.
Setup
Claude Code
Cursor / Windsurf / VS Code (mcp.json)
Claude Desktop / claude.ai — add https://api.grid-hub.app/mcp as a custom connector. These clients don't send custom headers; pass the key as the optional api_key tool argument, or use sample mode.
Local stdio bridge — for clients that only support local (stdio) servers. It proxies to the hosted endpoint via mcp-remote; nothing runs locally except the bridge.
Or with Docker: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. Omit the key for sample mode.
Any client, no key — omit the header. You'll get sample-mode data and a note on how to upgrade.
Protocol
- Streamable HTTP, stateless: one JSON-RPC message per POST, JSON response. No sessions, no SSE.
- Speaks MCP
2026-07-28 (header-mirrored requests, no handshake) and 2025-03-26 through 2025-11-25 (initialize handshake).
- Tool results include
structuredContent alongside the text block.
- Rate limits and quotas are those of the underlying REST API; the MCP layer adds none of its own.
Related
License
The code in this repository is MIT licensed. Data returned by the service is subject to each source's licence, stated in every response (license and attribution fields).