GridHub MCP Server

AIエージェント向けの、Model Context Protocol を介した電力市場のライブデータおよび履歴データ。

エンドポイント: 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から取得。すべてのレスポンスにはライセンスと帰属情報が含まれます。

ツール

Related MCP server: Energy Grid MCP Server

アクセス

開始にサインアップは不要、3つのレベル:

1. サンプルモード — 認証情報なしで接続。ツールは実際の現在のデータを返しますが、切り詰められます（履歴は50行まで、briefは1つのコンテキストブロックを返します）。結果は明確にマークされます。

2. 無料APIキー — 1日500リクエスト。 grid-hub.app/developers で即時メールサインアップ、または POST https://api.grid-hub.app/v1/keys/signup に {"email": "..."} を送信。 Authorization: Bearer <ghk_key> として送信します。

3. x402 従量課金 — Base上のUSDC、1コールあたり$0.001〜$0.02、X-PAYMENT ヘッダー経由。 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につき1つのJSON-RPCメッセージ、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 フィールド）に明記されています。