Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

claude mcp add --transport http gridhub https://api.grid-hub.app/mcp --header "Authorization: Bearer ${GRIDHUB_TOKEN}"

[mcp_servers.gridhub]
url = "https://api.grid-hub.app/mcp"
bearer_token_env_var = "GRIDHUB_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gridhub": {
      "type": "remote",
      "url": "https://api.grid-hub.app/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:GRIDHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "gridhub": {
      "type": "http",
      "url": "https://api.grid-hub.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GRIDHUB_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=gridhub&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmdyaWQtaHViLmFwcC9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtHUklESFVCX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "gridhub": {
      "type": "http",
      "url": "https://api.grid-hub.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GRIDHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "gridhub": {
      "httpUrl": "https://api.grid-hub.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GRIDHUB_TOKEN}"
      }
    }
  }
}

extensions:
  "gridhub":
    enabled: true
    name: "gridhub"
    type: streamable_http
    uri: "https://api.grid-hub.app/mcp"
    headers:
      "Authorization": "Bearer ${GRIDHUB_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${GRIDHUB_TOKEN}. The registry never accepts secret values.

Quality 92 / 100strong

protocol100 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
pass
protocol.list_ttltool list is cacheable (ttlMs 3600000)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations6 of 6 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 2,097 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes6 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

6 tools, about 2,097 tokens to load them all · tool set 3cd82af1af2e · tools last changed 2026-09-27 · checked 2026-10-19 13:37 UTC

Tool changes

2026-09-27get_map_snapshotchangedoutput schema
2026-09-27get_historychangedoutput schema
2026-09-27get_zone_briefchangedoutput schema
2026-09-27get_latestchangedoutput schema
2026-09-27get_statuschangedoutput schema
2026-09-27list_zoneschangedoutput schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90

liveness99

freshness85

hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-51d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.grid-hub.app/mcp` streamable-http	none	yes	97%	311 ms	2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05	2026-10-19

Tools (6)

`get_history`read-only	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.
`get_latest`read-only	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.
`get_map_snapshot`read-only	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.
`get_status`read-only	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.
`get_zone_brief`read-only	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.
`list_zones`read-only	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.jalcodev/gridhub",
  "title": "GridHub Electricity Market Data",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.grid-hub.app/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. 'Bearer <ghk_key>' for full data (free key: https://grid-hub.app/developers). Without it, tools run in free sample mode."
        }
      ]
    }
  ],
  "version": "1.0.2",
  "repository": {
    "url": "https://github.com/jalcodev/gridhub-mcp",
    "source": "github"
  },
  "websiteUrl": "https://grid-hub.app/developers#mcp",
  "description": "Live and historical electricity prices and demand for 25 grids; carbon intensity for GB."
}