GridHub Electricity Market Data

GridHub MCP 服务

通过 Model Context Protocol 为 AI Agent 提供实时和历史电力市场数据。

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

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

工具

工具	返回内容
get_zone_brief	当前电价／需求（以及 GB 的碳强度）相对于该区域过去 30 天数据的排名（百分位数、与中位数的差值、最小值／最大值）、24 小时趋势、发电结构（GB、US-CAISO），以及一句话摘要。最适合回答“X 地区现在的电力价格便宜吗，或者更清洁吗？”
get_latest	某个区域发布的每项指标的最新值，以及单位和时间戳
get_history	某项指标在起止时间范围内的时间序列（每次调用最多 31 天）
get_map_snapshot	一次返回全部 25 个区域的主要数据——可比较或排列各区域
list_zones	区域 ID、名称、数据源、货币、许可证（免费）
get_status	各数据源和区域的数据采集新鲜度（免费）

访问方式

无需注册即可开始使用，共有三个级别：

1. 示例模式 — 无需凭据即可连接。工具会返回真实的当前数据，但内容会截断（历史记录最多 50 行；摘要返回一个上下文块）。结果会明确标注。
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 官方注册表条目：io.github.jalcodev/gridhub

许可证

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