English Français العربية

GridHub Electricity Market Data

Registre officiel E-commerce

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http gridhub-electricity-market-data 'https://api.grid-hub.app/mcp' --header 'Authorization: <Optional. '\''Bearer <ghk_key>'\'' for full data (free key: https://grid-hub.app/developers). Without it, tools run in free sample mode.>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "gridhub-electricity-market-data": {
            "type": "http",
            "url": "https://api.grid-hub.app/mcp",
            "headers": {
                "Authorization": "<Optional. 'Bearer <ghk_key>' for full data (free key: https://grid-hub.app/developers). Without it, tools run in free sample mode.>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. GridHub MCP Server
  2. Tools
  3. Access
  4. Setup
  5. Protocol
  6. Related
  7. License

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

ToolWhat it returns
get_zone_briefCurrent 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_latestMost recent value of every metric one zone publishes, with unit and timestamp
get_historyTime series for one metric over a start/end window (up to 31 days per call)
get_map_snapshotHeadline values for all 25 zones at once — compare or rank zones
list_zonesZone ids, names, sources, currencies, licences (free)
get_statusIngestion freshness per source and zone (free)

Access

Three levels, no signup needed to start:

  1. 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.
  2. 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>.
  3. 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

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

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

Questions fréquentes

Qu'est-ce que GridHub Electricity Market Data ?

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

Comment installer GridHub Electricity Market Data ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http gridhub-electricity-market-data 'https://api.grid-hub.app/mcp' --header 'Authorization: <Optional. '\''Bearer <ghk_key>'\'' for full data (free key: https://grid-hub.app/developers). Without it, tools run in free sample mode.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour GridHub Electricity Market Data ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

GridHub Electricity Market Data est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient GridHub Electricity Market Data ?

Il est publié par jalcodev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.