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 整合