GridHub MCP Server

Live- und historische Strommarktdaten für KI-Agenten über das Model Context Protocol.

Endpunkt: https://api.grid-hub.app/mcp — gehostet, Streamable HTTP, zustandslos. Nichts zu installieren.

Umfasst 25 Netzgebiete — US-ISOs (CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12 europäische Gebotszonen, Großbritannien und die fünf australischen NEM-Regionen — normalisiert zu einem einheitlichen JSON-Schema. Die Daten stammen von EIA, ENTSO-E, NESO, Elexon und AEMO; jede Antwort enthält ihre Lizenz und Quellenangabe.

Tools

Related MCP server: Energy Grid MCP Server

Zugriff

Drei Stufen, keine Anmeldung erforderlich für den Einstieg:

1. Beispielmodus — verbinden Sie sich ohne Anmeldedaten. Die Tools geben echte, aktuelle Daten zurück, gekürzt (history auf 50 Zeilen begrenzt; brief gibt einen Kontextblock zurück). Die Ergebnisse sind deutlich gekennzeichnet.

2. Kostenloser API-Schlüssel — 500 Anfragen/Tag. Sofortige Anmeldung per E-Mail unter grid-hub.app/developers oder POST https://api.grid-hub.app/v1/keys/signup mit {"email": "..."}. Senden Sie den Schlüssel als Authorization: Bearer <ghk_key>.

3. x402 Pay-per-Call — USDC auf Base, $0.001–$0.02 pro Aufruf, über den X-PAYMENT-Header. Siehe den x402-Flow.

Einrichtung

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 — fügen Sie https://api.grid-hub.app/mcp als benutzerdefinierten Connector hinzu. Diese Clients senden keine benutzerdefinierten Header; übergeben Sie den Schlüssel als optionales api_key-Tool-Argument oder nutzen Sie den Beispielmodus.

Lokale stdio-Brücke — für Clients, die nur lokale (stdio) Server unterstützen. Sie leitet über mcp-remote an den gehosteten Endpunkt weiter; lokal läuft nichts außer der Brücke.

{
  "mcpServers": {
    "gridhub": {
      "command": "npx",
      "args": ["-y", "github:jalcodev/gridhub-mcp"],
      "env": { "GRIDHUB_API_KEY": "YOUR_KEY" }
    }
  }
}

Oder mit Docker: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. Lassen Sie den Schlüssel für den Beispielmodus weg.

Beliebiger Client, kein Schlüssel — lassen Sie den Header weg. Sie erhalten Daten im Beispielmodus und einen Hinweis, wie Sie upgraden können.

Protokoll

• Streamable HTTP, zustandslos: eine JSON-RPC-Nachricht pro POST, JSON-Antwort. Keine Sitzungen, kein SSE.

• Unterstützt MCP 2026-07-28 (Header-gespiegelte Anfragen, kein Handshake) und 2025-03-26 bis 2025-11-25 (initialize-Handshake).

• Tool-Ergebnisse enthalten structuredContent neben dem Textblock.

• Ratenlimits und Kontingente entsprechen denen der zugrunde liegenden REST-API; die MCP-Ebene fügt keine eigenen hinzu.

Weiterführendes

• REST-API-Dokumentation: https://grid-hub.app/developers

• OpenAPI: https://api.grid-hub.app/openapi.json

• llms.txt: https://api.grid-hub.app/llms.txt

• Offizieller MCP-Registry-Eintrag: io.github.jalcodev/gridhub

Lizenz

Der Code in diesem Repository ist unter der MIT-Lizenz lizenziert. Daten, die der Dienst zurückgibt, unterliegen der Lizenz der jeweiligen Quelle, die in jeder Antwort angegeben ist (Felder license und attribution).