GridHub Electricity Market Data

GridHub MCP Server

Model Context Protocol を介して、AI エージェント向けに電力市場のリアルタイムおよび過去のデータを提供します。

エンドポイント： https://api.grid-hub.app/mcp — ホスト型、Streamable HTTP、ステートレスです。インストールは不要です。

25 のグリッドゾーンを網羅しています。米国の ISO（CAISO、ERCOT、PJM、MISO、NYISO、ISO-NE、SPP）、欧州の 12 の入札ゾーン、英国、およびオーストラリアの NEM 5 地域のデータを、1 つの JSON スキーマに正規化しています。EIA、ENTSO-E、NESO、Elexon、AEMO をデータソースとしており、すべてのレスポンスにライセンスと帰属表示が含まれます。

ツール

ツール	返されるデータ
get_zone_brief	現在の価格／需要（英国では炭素強度も含む）を、そのゾーンの直近 30 日間の値（パーセンタイル、中央値との差、最小値／最大値）と比較した順位、24 時間の傾向、発電構成（英国、米国 CAISO）、および一文の要約です。「今、X の電力は安いか、クリーンか？」を確認するのに最適です。
get_latest	あるゾーンが公開しているすべての指標の最新値。単位とタイムスタンプも含まれます。
get_history	指定した開始／終了期間の、1 つの指標の時系列データ（1 回の呼び出しにつき最大 31 日間）
get_map_snapshot	25 のゾーンすべての主要な値を一度に取得できます。ゾーンの比較や順位付けに利用できます。
list_zones	ゾーン ID、名称、データソース、通貨、ライセンス（無料）
get_status	データソースおよびゾーンごとのデータ取り込みの鮮度（無料）

アクセス

登録なしですぐに利用できる 3 つのレベルがあります。

1. サンプルモード — 認証情報なしで接続します。ツールは実際の最新データを返しますが、一部が省略されます（履歴は最大 50 行、概要はコンテキストブロック 1 件を返します）。結果にはサンプルモードであることが明示されます。
2. 無料 API キー — 1 日あたり 500 リクエスト。grid-hub.app/developers でメールアドレスを登録するとすぐに利用できます。または、{"email": "..."} を指定して POST https://api.grid-hub.app/v1/keys/signup を実行します。Authorization: Bearer <ghk_key> として送信します。
3. x402 の従量課金 — X-PAYMENT ヘッダーを使い、Base 上の USDC で 1 回の呼び出しにつき $0.001～$0.02 を支払います。x402 のフローを参照してください。

セットアップ

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 — https://api.grid-hub.app/mcp をカスタムコネクターとして追加します。これらのクライアントはカスタムヘッダーを送信しません。キーは省略可能な api_key ツール引数として渡すか、サンプルモードを使用してください。

ローカル stdio ブリッジ — ローカル（stdio）サーバーのみをサポートするクライアント向けです。mcp-remote を介してホスト型エンドポイントにプロキシします。ブリッジ以外にローカルで実行されるものはありません。

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

または Docker を使用します：docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp。サンプルモードを使用する場合は、キーを省略してください。

任意のクライアントでキーなしで使用 — ヘッダーを省略します。サンプルモードのデータと、アップグレード方法に関する案内が返されます。

プロトコル

• Streamable HTTP、ステートレス：POST ごとに JSON-RPC メッセージを 1 件送信し、JSON レスポンスを返します。セッションおよび SSE はありません。
• MCP 2026-07-28（ヘッダーをミラーリングするリクエスト、ハンドシェイクなし）と、2025-03-26 から 2025-11-25（initialize ハンドシェイク）に対応しています。
• ツールの結果には、テキストブロックに加えて structuredContent が含まれます。
• レート制限とクォータは、基盤となる REST API のものが適用されます。MCP レイヤー独自の制限はありません。

関連リンク

• REST API ドキュメント：https://grid-hub.app/developers
• OpenAPI：https://api.grid-hub.app/openapi.json
• llms.txt：https://api.grid-hub.app/llms.txt
• 公式 MCP レジストリのエントリー：io.github.jalcodev/gridhub

ライセンス

このリポジトリのコードは MIT ライセンスです。サービスから返されるデータには、各データソースのライセンスが適用されます。ライセンスはすべてのレスポンスの license および attribution フィールドに記載されています。