GridHub Electricity Market Data MCP server
Commit Sep 27, 2026Provides live and historical electricity prices, demand, and carbon intensity data across 25 global grid zones for AI agents.
Also known as jalcodev/gridhub-mcp, gridhub-mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Sep 27, 2026
- License
- MIT
What is GridHub Electricity Market Data MCP?
GridHub Electricity Market Data provides live and historical electricity prices, demand, and carbon intensity data across 25 global grid zones for AI agents. It exposes 6 tools, such as get_zone_brief, get_latest, get_history.
Summary generated from the project's README
About GridHub Electricity Market Data MCP server
GridHub Electricity Market Data provides real-time and historical electricity metrics to AI agents through the Model Context Protocol. It covers 25 global grid zones, including US ISOs like ERCOT and CAISO, 12 European bidding zones, Great Britain, and five Australian NEM regions. The server aggregates data from sources such as EIA, ENTSO-E, and AEMO into a single normalized JSON schema.
Developers can connect to the hosted endpoint via Streamable HTTP using clients like Claude Code, Cursor, or Claude Desktop. Access begins with a sample mode that requires no credentials, while a free tier offers 500 requests per day via an API key. For higher volume needs, a pay-per-call model using USDC on Base is available. The server includes specific tools like get_zone_brief for quick status checks, get_history for time series data up to 31 days, and get_map_snapshot to compare all zones simultaneously.
What you can do with it
- 1Analyze regional electricity costsAsk the agent to determine if electricity prices are currently low in a specific grid zone.
Written from the project's README. Every use case is checked against a quote from it.
How to install GridHub Electricity Market Data MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall GridHub Electricity Market Data MCP in Claude Code
$ claude mcp add --transport http gridhub-mcp https://api.grid-hub.app/mcpInstall GridHub Electricity Market Data MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gridhub-mcp": {
"url": "https://api.grid-hub.app/mcp"
}
}
}Install GridHub Electricity Market Data MCP in VS Code
.vscode/mcp.json
{
"servers": {
"gridhub-mcp": {
"type": "http",
"url": "https://api.grid-hub.app/mcp"
}
}
}Install GridHub Electricity Market Data MCP in VS Code CLI
$ code --add-mcp '{"name":"gridhub-mcp","type":"http","url":"https://api.grid-hub.app/mcp"}'Install GridHub Electricity Market Data MCP in Codex
$ codex mcp add gridhub-mcp --url https://api.grid-hub.app/mcpInstall GridHub Electricity Market Data MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.gridhub-mcp] url = "https://api.grid-hub.app/mcp"
Install GridHub Electricity Market Data MCP in Gemini CLI
$ gemini mcp add -s user --transport http gridhub-mcp https://api.grid-hub.app/mcpInstall GridHub Electricity Market Data MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gridhub-mcp": {
"url": "https://api.grid-hub.app/mcp",
"type": "http"
}
}
}GridHub Electricity Market Data MCP tools 6
Detected from the READMEget_zone_briefget_latestget_historyget_map_snapshotlist_zonesget_status
| get_zone_brief | — | |
| get_latest | — | |
| get_history | — | |
| get_map_snapshot | — | |
| list_zones | — | |
| get_status | — |
Configuration
GRIDHUB_API_KEY
| Name | Description | |
|---|---|---|
| GRIDHUB_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablejalcodev/gridhub-mcp is public and reachablegithub.com/jalcodev/gridhub-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-27github.com/jalcodev/gridhub-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 133 msPass
README
View on GitHubGridHub 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/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
- 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).
GridHub Electricity Market Data MCP questions
How do I add GridHub Electricity Market Data MCP to Claude Code?
Run claude mcp add --transport http gridhub-mcp https://api.grid-hub.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add GridHub Electricity Market Data MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does GridHub Electricity Market Data MCP provide?
It exposes 6 tools, including get_zone_brief, get_latest, get_history, get_map_snapshot, list_zones.
Do I need to sign up to use GridHub?
No, you can start immediately using sample mode with no credentials, which returns real but truncated data.
What kind of electricity data is available?
The server provides live and historical electricity prices, demand, and carbon intensity for 25 grid zones including US ISOs, European bidding zones, Great Britain, and Australian NEM regions.