gridhub-mcp
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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 |
| 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?" |
| Most recent value of every metric one zone publishes, with unit and timestamp |
| Time series for one metric over a start/end window (up to 31 days per call) |
| Headline values for all 25 zones at once — compare or rank zones |
| Zone ids, names, sources, currencies, licences (free) |
| Ingestion freshness per source and zone (free) |
Related MCP server: Energy Grid MCP Server
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/signupwith{"email": "..."}. Send asAuthorization: Bearer <ghk_key>.x402 pay-per-call — USDC on Base, $0.001–$0.02 per call, via the
X-PAYMENTheader. See the x402 flow.
Setup
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 — 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.
{
"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) and2025-03-26through2025-11-25(initializehandshake).Tool results include
structuredContentalongside the text block.Rate limits and quotas are those of the underlying REST API; the MCP layer adds none of its own.
Related
REST API docs: https://grid-hub.app/developers
llms.txt: https://api.grid-hub.app/llms.txtOfficial 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).
Available Tools
6 toolsget_historyHistorical time seriesARead-onlyIdempotentInspect
Time series for one metric in one zone over a start/end window (Unix seconds). Rows are returned oldest-first and the 'limit' truncates from the OLDEST end, so a small limit over a wide window returns old data, not recent data — for 'the latest N points' set start close to now, or use get_latest / get_zone_brief for current values. Default window is the last 24h (last ~400 days for capacity, which is annual). Max window 31 days per call (400 for capacity); paginate with start/end for more. Metrics: price (wholesale, local currency per MWh), demand (MW), generation (per fuel, 'fuel' field set; % or MW depending on zone; GB and US-CAISO only), carbon-intensity (gCO2/kWh; GB only), interchange (net imports, MW), capacity (installed MW per fuel; European zones only). Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.
Inputs: zone (required), metric (required), end, limit, +2 more.
get_latestLatest values for a zoneARead-onlyIdempotentInspect
The most recent value of every metric one zone publishes (price and demand for every zone; generation by fuel for GB and US-CAISO; carbon intensity for GB; interchange where available), each with unit and timestamp. This is the right tool for 'what is the price/demand/carbon intensity in X right now'. Note: some European sources publish day-ahead prices, so the price timestamp can be up to ~36h in the future; use get_zone_brief for a strictly at-or-before-now value with historical context. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.
Inputs: zone (required), api_key.
get_map_snapshotAll zones right nowARead-onlyIdempotentInspect
Current headline values for all 25 zones in one call — the cheapest way to compare zones (e.g. 'which European zone has the lowest price right now', 'rank US ISOs by demand'). Rebuilt every 5 minutes. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.
Inputs: api_key.
get_statusData freshnessARead-onlyIdempotentInspect
Ingestion health per source and zone: last successful fetch timestamp and last error, if any. Free. Use it to explain stale or missing values before drawing conclusions from them.
Inputs: no named parameters.
get_zone_briefZone brief (current state in context)ARead-onlyIdempotentInspect
Composite, interpretation-ready snapshot of one zone: current price / demand / carbon intensity where published (strictly at-or-before now), each ranked against that zone's own last ~30 days (percentile, vs-median %, min/max, sample count and the actual data window), a 24h trend per metric, the generation mix where published (GB, US-CAISO), and a one-sentence plain-English summary. Best tool for questions like 'is electricity cheap/clean in X right now' or 'is this a good time to run a flexible workload'. A raw price means little without this context. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.
Inputs: zone (required), api_key.
list_zonesList zonesARead-onlyIdempotentInspect
List the 25 electricity grid zones GridHub covers, with id, name, data source (EIA, ENTSO-E, NESO, AEMO), timezone, currency, licence and required attribution. Free, no credentials needed. Call this first if you are unsure which zone id to use.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The tools are mostly distinct: list_zones covers metadata, get_map_snapshot covers cross-zone current values, get_status covers health, get_history covers time series, and get_zone_brief adds interpretation. get_latest and get_zone_brief both address current conditions, but the descriptions clearly differentiate raw latest values from contextual at-or-before-now snapshots.
All tool names follow a clear list_/ get_ verb pattern with a descriptive object, such as list_zones, get_status, and get_history. There is no mixed casing or inconsistent verb style, making the set predictable and easy to navigate.
Six tools is a well-scoped size for a read-only electricity grid data server. Each tool covers a distinct need: discovery, health, raw latest values, interpreted snapshot, history, and cross-zone comparison, so no tool feels redundant or extraneous.
The set covers the full read-only data lifecycle for this domain: zone metadata, ingestion health, current raw values, contextual interpretation, historical series, and multi-zone comparison. There are no obvious dead ends or missing operations that would block an agent from answering common questions about grid data.
Maintenance
Related MCP Connectors
Real-time electricity prices for AI agents. 40+ countries, 100+ zones. No auth required.
Real-time electricity price signals for AI agents. Spot prices, cheapest hours, and contract recommendations. 31 countries across Europe and Oceania. No authentication required.
Grid power prices and carbon, open sensors, weather alerts and forecasts, news and social signals.
Live US power market prices, load, generation, weather and permits for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for real-time electricity prices, carbon intensity, and energy analytics across 41+ zones in Europe, Great Britain, the United States, and Australia. Query live prices, compare zones, check gas storage levels, get green scores, find optimal charging windows, and access advanced analytics. Free Basic tier requires no API key. Install via npx gridpulse-mcp or connect directly via Streamab-
- AlicenseAqualityDmaintenanceProvides real-time electricity grid data including CO2 intensity, power mix, and wholesale prices, plus optimal green time windows for energy-intensive AI tasks. Supports UK, Germany, and global regions with optional API keys.9MIT

gridcarbon-mcpofficial
AlicenseAqualityFmaintenanceHourly electricity grid carbon intensity (gCO2eq/kWh) for 45 zones across Europe, the US and Great Britain, computed from ENTSO-E, EIA and NESO generation data. Four read-only tools; every value carries its interval timestamp and how stale it is. No API key, no account.4MIT- AlicenseNot gradedqualityBmaintenanceProvides real-time grid carbon intensity, power generation breakdown, and carbon-intensity forecasts for any zone or lat/lon location.101 npmMIT