GridHub MCP Server (Model Context Protocol)

This MCP server provides live and historical electricity market data for AI agents via the Model Context Protocol. It serves electricity prices and demand across 25 grid zones, including carbon intensity for GB, and exposes data through a single hosted HTTP endpoint. Responses are normalized into one JSON schema and include licensing attribution.

🛠️ Key Features

Live and historical electricity prices and demand
Carbon intensity for GB
Coverage for 25 grid zones (US ISOs, European bidding zones, Great Britain, Australia NEM regions)
Normalized into one JSON schema
Data sourcing with licence and attribution (EIA, ENTSO-E, NESO, Elexon, AEMO)

🚀 Use Cases

Agent workflows that need electricity price and demand context
Carbon-intensity-aware planning for Great Britain

⚡ Developer Benefits

Model Context Protocol (MCP) integration
Hosted, Streamable HTTP endpoint: https://api.grid-hub.app/mcp
Stateless access; nothing to install
Tooling count: 6

⚠️ Limitations

Tool details beyond the excerpt are not fully provided in the available source data

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

Tool	What it returns
`get_zone_brief`	Current price / demand (and carbon intensity for GB) ranked against the zone's own last 30 days (percentile, vs-median, min/max), 24h trend, generation mix (GB, US-CAISO), and a one-sentence summary. Best for "is electricity cheap or clean in X right now?"
`get_latest`	Most recent value of every metric one zone publishes, with unit and timestamp
`get_history`	Time series for one metric over a start/end window (up to 31 days per call)
`get_map_snapshot`	Headline values for all 25 zones at once — compare or rank zones
`list_zones`	Zone ids, names, sources, currencies, licences (free)
`get_status`	Ingestion freshness per source and zone (free)

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

bash

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

Cursor / Windsurf / VS Code (mcp.json)

json

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

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.

json

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

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.

REST API docs: https://grid-hub.app/developers
OpenAPI: https://api.grid-hub.app/openapi.json
llms.txt: https://api.grid-hub.app/llms.txt
Official MCP Registry entry: io.github.jalcodev/gridhub

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).

zone	string	required	Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences.
api_key	string	optional	Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output).

zone	string	required	Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences.
api_key	string	optional	Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output).

zone	string	required	Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences.
metric	string	required	Which series to fetch.
start	integer	optional	Window start, Unix seconds. Default: end minus 24h.
end	integer	optional	Window end, Unix seconds. Default: now.
limit	integer	optional	Max rows (default 200, max 1000 via MCP; sample mode caps at 50).
api_key	string	optional	Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output).

GridHub Electricity Market Data