GridHub MCP Server

面向 AI 代理的实时和历史电力市场数据，基于 Model Context Protocol。

Endpoint: https://api.grid-hub.app/mcp — 托管式、Streamable HTTP、无状态。无需安装。

覆盖 25 个电网区域——美国 ISO（CAISO、ERCOT、PJM、MISO、NYISO、ISO-NE、SPP）、12 个欧洲竞价区、英国以及澳大利亚 NEM 的五个地区——统一为一个 JSON schema。数据来源包括 EIA、ENTSO-E、NESO、Elexon 和 AEMO；每个响应都附带其许可证和署名。

工具

Related MCP server: Energy Grid MCP Server

访问

三个级别，无需注册即可开始：

1. 示例模式 — 无需凭据即可连接。工具返回真实、当前的数据，但会被截断（历史记录最多 50 行；brief 返回一个上下文块）。结果会明确标记。

2. 免费 API 密钥 — 每天 500 次请求。在 grid-hub.app/developers 通过电子邮件即时注册，或使用 {"email": "..."} 发送 POST https://api.grid-hub.app/v1/keys/signup。以 Authorization: Bearer <ghk_key> 形式发送。

3. x402 按次付费 — 基于 Base 的 USDC，每次调用 $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 一条 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 Registry 条目：io.github.jalcodev/gridhub

许可证

本仓库中的代码采用 MIT 许可证。服务返回的数据受各数据源许可证的约束，每个响应中都会注明（license 和 attribution 字段）。