GridHub Electricity Market Data

io.github.jalcodev由 GitHub 账号 jalcodev 发布v1.0.2更新于 Oct 24, 2026

Live and historical electricity prices and demand for 25 grids; carbon intensity for GB.

发布方自己的服务:nohumans.directory

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

托管式 MCP 服务器,让助手获取 25 个电网区域的实时与历史电价、需求和碳排放强度,并支持区域对比与数据新鲜度检查。

可以做什么
列出覆盖的 25 个电网区域及其数据来源、时区、货币和许可,并查看各来源与区域的采集新鲜度(均免费)。获取单个区域每项指标的最新值,含单位和时间戳。生成区域综合简报,将当前电价、需求和碳排放强度与该区域近约 30 天数据对比排名,并附 24 小时趋势和发电结构。按起止时间窗口拉取单个区域某项指标的时间序列。一次调用即可对比或排名全部 25 个区域的头条数值。
适用场景
适合助手回答美国各 ISO、欧洲竞价区、英国或澳大利亚 NEM 区域当前或历史电价、需求、碳排放强度、发电结构相关问题,或对多个区域进行比较和排名。
运行要求
远程 Streamable HTTP 端点,无需安装。无凭据时以样本模式运行(数据被截断)。免费 API 密钥(邮箱注册,每天 500 次请求)通过 Authorization Bearer 头传递;无法发送自定义头的客户端可作为可选 api_key 工具参数传入;使用可选的本地 stdio 桥接时通过 GRIDHUB_API_KEY 提供。按次付费模式通过 X-PAYMENT 头使用 Base 上的 USDC。
安装前请注意
Authorization 头携带 API 密钥,需妥善保管。样本模式返回截断数据,未使用密钥时得出的结论可能不完整。按次付费模式每次调用花费 0.001–0.02 美元等值 USDC(Base 网络)。数据来自第三方来源(EIA、ENTSO-E、NESO、Elexon、AEMO),每个响应都附带许可与署名要求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GridHub Electricity Market Data,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.jalcodev%2Fgridhub/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "gridhub-electricity-market-data": {
      "type": "http",
      "url": "https://api.grid-hub.app/mcp"
    }
  }
}

README

GridHub MCP Server

Live and historical electricity market data for AI agents, over the Model Context Protocol.

Endpoint: https://api.grid-hub.app/mcp — hosted, Streamable HTTP, stateless. Nothing to install.

Covers 25 grid zones — US ISOs (CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12 European bidding zones, Great Britain, and the five Australian NEM regions — normalised into one JSON schema. Sourced from EIA, ENTSO-E, NESO, Elexon and AEMO; every response carries its licence and attribution.

Tools

ToolWhat it returns
get_zone_briefCurrent price / demand (and carbon intensity for GB) ranked against the zone's own last 30 days (percentile, vs-median, min/max), 24h trend, generation mix (GB, US-CAISO), and a one-sentence summary. Best for "is electricity cheap or clean in X right now?"
get_latestMost recent value of every metric one zone publishes, with unit and timestamp
get_historyTime series for one metric over a start/end window (up to 31 days per call)
get_map_snapshotHeadline values for all 25 zones at once — compare or rank zones
list_zonesZone ids, names, sources, currencies, licences (free)
get_statusIngestion freshness per source and zone (free)

Access

Three levels, no signup needed to start:

  1. Sample mode — connect with no credentials. Tools return real, current data, truncated (history capped at 50 rows; brief returns one context block). Results are clearly marked.
  2. Free API key — 500 requests/day. Instant email signup at grid-hub.app/developers, or POST https://api.grid-hub.app/v1/keys/signup with {"email": "..."}. Send as Authorization: Bearer <ghk_key>.
  3. x402 pay-per-call — USDC on Base, $0.001–$0.02 per call, via the X-PAYMENT header. See the x402 flow.

Setup

Claude Code

bash
claude mcp add --transport http gridhub https://api.grid-hub.app/mcp \  --header "Authorization: Bearer YOUR_KEY"

Cursor / Windsurf / VS Code (mcp.json)

json
{  "mcpServers": {    "gridhub": {      "url": "https://api.grid-hub.app/mcp",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

Claude Desktop / claude.ai — add https://api.grid-hub.app/mcp as a custom connector. These clients don't send custom headers; pass the key as the optional api_key tool argument, or use sample mode.

Local stdio bridge — for clients that only support local (stdio) servers. It proxies to the hosted endpoint via mcp-remote; nothing runs locally except the bridge.

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

Or with Docker: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. Omit the key for sample mode.

Any client, no key — omit the header. You'll get sample-mode data and a note on how to upgrade.

Protocol

  • Streamable HTTP, stateless: one JSON-RPC message per POST, JSON response. No sessions, no SSE.
  • Speaks MCP 2026-07-28 (header-mirrored requests, no handshake) and 2025-03-26 through 2025-11-25 (initialize handshake).
  • Tool results include structuredContent alongside the text block.
  • Rate limits and quotas are those of the underlying REST API; the MCP layer adds none of its own.

Related

License

The code in this repository is MIT licensed. Data returned by the service is subject to each source's licence, stated in every response (license and attribution fields).

来源:README.md,提交 452883f

工具

6

list_zones

List zones

List the 25 electricity grid zones GridHub covers, with id, name, data source (EIA, ENTSO-E, NESO, AEMO), timezone, currency, licence and required attribution. Free, no credentials needed. Call this first if you are unsure which zone id to use.

无需输入参数。

get_status

Data freshness

Ingestion health per source and zone: last successful fetch timestamp and last error, if any. Free. Use it to explain stale or missing values before drawing conclusions from them.

无需输入参数。

get_latest

Latest values for a zone

The most recent value of every metric one zone publishes (price and demand for every zone; generation by fuel for GB and US-CAISO; carbon intensity for GB; interchange where available), each with unit and timestamp. This is the right tool for 'what is the price/demand/carbon intensity in X right now'. Note: some European sources publish day-ahead prices, so the price timestamp can be up to ~36h in the future; use get_zone_brief for a strictly at-or-before-now value with historical context. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.

输入参数zone必填api_key

get_zone_brief

Zone brief (current state in context)

Composite, interpretation-ready snapshot of one zone: current price / demand / carbon intensity where published (strictly at-or-before now), each ranked against that zone's own last ~30 days (percentile, vs-median %, min/max, sample count and the actual data window), a 24h trend per metric, the generation mix where published (GB, US-CAISO), and a one-sentence plain-English summary. Best tool for questions like 'is electricity cheap/clean in X right now' or 'is this a good time to run a flexible workload'. A raw price means little without this context. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.

输入参数zone必填api_key

get_history

Historical time series

Time series for one metric in one zone over a start/end window (Unix seconds). Rows are returned oldest-first and the 'limit' truncates from the OLDEST end, so a small limit over a wide window returns old data, not recent data — for 'the latest N points' set start close to now, or use get_latest / get_zone_brief for current values. Default window is the last 24h (last ~400 days for capacity, which is annual). Max window 31 days per call (400 for capacity); paginate with start/end for more. Metrics: price (wholesale, local currency per MWh), demand (MW), generation (per fuel, 'fuel' field set; % or MW depending on zone; GB and US-CAISO only), carbon-intensity (gCO2/kWh; GB only), interchange (net imports, MW), capacity (installed MW per fuel; European zones only). Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.

输入参数endzone必填limitstartmetric必填api_key

get_map_snapshot

All zones right now

Current headline values for all 25 zones in one call — the cheapest way to compare zones (e.g. 'which European zone has the lowest price right now', 'rank US ISOs by demand'). Rebuilt every 5 minutes. Authentication: send 'Authorization: Bearer <ghk_key>' on the MCP connection (free key, 500 requests/day, instant email signup at https://grid-hub.app/developers), or pay per call with x402 (USDC on Base) via the X-PAYMENT header. With no credentials, data tools run in free sample mode: real, current data but truncated (history capped at 50 rows; brief returns one context block). Sample results are clearly marked.

输入参数api_key

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Nohumans 集成