GridHub Electricity Market Data

by jalcodev · remote · no sign-in to list tools · v1.0.2 · published by GitHub user jalcodev

Live and historical electricity prices and demand for 25 grids; carbon intensity for GB.

Read only

Compare Registry entry

6 tools: 6 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things0Claude Code: ask
Only reads6Claude Code: allow: see these tools

5 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http gridhub https://api.grid-hub.app/mcp

Findings

Matches of fixed checks, with the text they matched.

5 info

Infolist_zones
The description mentions "credentials".
Matched text
description: "...ence and required attribution. Free, no credentials needed. Call this first if you are unsu..."
What this check looks for
Infoget_latest
The description mentions "credentials".
Matched text
description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
What this check looks for
Infoget_zone_brief
The description mentions "credentials".
Matched text
description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
What this check looks for
Infoget_history
The description mentions "credentials".
Matched text
description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
What this check looks for
Infoget_map_snapshot
The description mentions "credentials".
Matched text
description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

6 tools

Only reads 6Looks things up and changes nothing.Claude Code: allow

get_historyTime series for one metric in one zone over a start/end window (Unix seconds).1 finding
Why it is in this group
- The name "get_history" says "get": a word for reading.
Findings
- Info
  The description mentions "credentials".
  Matched text
  description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_latestThe 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 availa…1 finding
Why it is in this group
- The name "get_latest" says "get": a word for reading.
Findings
- Info
  The description mentions "credentials".
  Matched text
  description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_map_snapshotCurrent headline values for all 25 zones in one call — the cheapest way to compare zones (e.g.1 finding
Why it is in this group
- The name "get_map_snapshot" says "get": a word for reading.
Findings
- Info
  The description mentions "credentials".
  Matched text
  description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_statusIngestion health per source and zone: last successful fetch timestamp and last error, if any.No findings
Why it is in this group
- The name "get_status" says "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_zone_briefComposite, 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 las…1 finding
Why it is in this group
- The name "get_zone_brief" says "get": a word for reading.
Findings
- Info
  The description mentions "credentials".
  Matched text
  description: "...Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: re..."
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_zonesList the 25 electricity grid zones GridHub covers, with id, name, data source (EIA, ENTSO-E, NESO, AEMO), timezone, currency, licence and required attribution.1 finding
Why it is in this group
- The name "list_zones" says "list": a word for reading.
Findings
- Info
  The description mentions "credentials".
  Matched text
  description: "...ence and required attribution. Free, no credentials needed. Call this first if you are unsu..."
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.2. Values in angle brackets are yours to fill in.

claude mcp add --transport http gridhub https://api.grid-hub.app/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__gridhub__list_zones",
      "mcp__gridhub__get_status",
      "mcp__gridhub__get_latest",
      "mcp__gridhub__get_zone_brief",
      "mcp__gridhub__get_history",
      "mcp__gridhub__get_map_snapshot"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as gridhub. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.jalcodev/gridhub/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

Run the operations that matter as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry · repository. Synced Oct 21, 2026, 18:36 UTC.

For agents: Markdown · JSON · report this listing