Koskamo

GridHub Electricity Market Data MCP

An MCP server providing AI agents with access to real-time and historical electricity market data across 25 grids in the US, UK, Australia, and Europe. It supports tools to list zones, get status, retrieve latest snapshots, zone briefs, historical data (demand, generation, price, carbon intensity, interchange, capacity), and map snapshots. It supports free API keys, x402 pay-per-call, or sample mode.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

GridHub Electricity Market Data MCP logo, by GridHubCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by GridHub
You need:Free API key — POST https://api.grid-hub.app/v1/keys/signup with {"email": "..."}; 500 requests/day; send as 'Authorization: Bearer '. No card, no wallet.x402 pay-per-call (USDC on base, chain eip155:8453). Request any paid endpoint without credentials to receive a 402 with payment requirements, then retry with a signed X-PAYMENT header.Free sample mode — append ?sample=true to any endpoint for real, truncated data with no credentials at all.
MCP endpoint (Streamable HTTP)
https://api.grid-hub.app/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

6 of 6 have a description · 6 of 6 declare behavior hints · 4 of 4 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Retrieve real-time electricity prices and demand for specific grid zones
  • Access historical generation mix and carbon intensity data
  • Get zone briefs with historical context and trend analysis
  • List all covered zones and their boundaries

Source and maintenance

Community listingRegistry 1.0.2
mcp-registry: io.github.jalcodev/gridhub@1.0.2Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
gridhub v1
MCP protocol negotiated in check
2025-11-25
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

GridHub provides live and historical electricity market data — wholesale prices, demand, interconnector flows and installed capacity — for 25 grid zones across the US, Europe, Great Britain and Australia, in one normalised JSON schema. Generation mix is published for GB and US-CAISO only and carbon intensity for GB only; other zones omit those metrics. Every response carries its source attribution and licence; repeat them when presenting data. Start with get_zone_brief for 'right now' questions and get_history for time series. 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.

Tools

6 advertised

list_zones — List zones
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

list_zones input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_zones output schema
{
  "type": "object",
  "properties": {
    "zones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "tz": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "attribution": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
list_zones annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_status — Data freshness
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_status input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_status output schema
{
  "type": "object",
  "properties": {
    "now": {
      "type": [
        "number",
        "null"
      ]
    },
    "sources": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "zone": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_ok": {
            "type": [
              "number",
              "null"
            ]
          },
          "last_error": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
get_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_latest — Latest values for a zone
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_latest input schema
{
  "type": "object",
  "required": [
    "zone"
  ],
  "properties": {
    "zone": {
      "enum": [
        "US-CAISO",
        "US-ERCOT",
        "US-PJM",
        "US-MISO",
        "US-NYISO",
        "US-ISONE",
        "US-SPP",
        "DE-LU",
        "FR",
        "ES",
        "IT-NO",
        "NL",
        "BE",
        "PL",
        "SE-3",
        "NO-2",
        "DK-1",
        "AT",
        "CH",
        "GB",
        "AU-NSW",
        "AU-QLD",
        "AU-VIC",
        "AU-SA",
        "AU-TAS"
      ],
      "type": "string",
      "description": "Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences."
    },
    "api_key": {
      "type": "string",
      "description": "Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output)."
    }
  },
  "additionalProperties": false
}
get_latest output schema
{
  "type": "object",
  "properties": {
    "zone": {
      "type": [
        "string",
        "null"
      ]
    },
    "license": {
      "type": [
        "string",
        "null"
      ]
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "ts": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "resolution": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "updated": {
      "type": [
        "number",
        "null"
      ]
    },
    "attribution": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
get_latest annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_zone_brief — Zone brief (current state in context)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_zone_brief input schema
{
  "type": "object",
  "required": [
    "zone"
  ],
  "properties": {
    "zone": {
      "enum": [
        "US-CAISO",
        "US-ERCOT",
        "US-PJM",
        "US-MISO",
        "US-NYISO",
        "US-ISONE",
        "US-SPP",
        "DE-LU",
        "FR",
        "ES",
        "IT-NO",
        "NL",
        "BE",
        "PL",
        "SE-3",
        "NO-2",
        "DK-1",
        "AT",
        "CH",
        "GB",
        "AU-NSW",
        "AU-QLD",
        "AU-VIC",
        "AU-SA",
        "AU-TAS"
      ],
      "type": "string",
      "description": "Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences."
    },
    "api_key": {
      "type": "string",
      "description": "Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output)."
    }
  },
  "additionalProperties": false
}
get_zone_brief output schema
{
  "type": "object",
  "properties": {
    "zone": {
      "type": [
        "string",
        "null"
      ]
    },
    "as_of": {
      "type": [
        "number",
        "null"
      ]
    },
    "context": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "max": {
            "type": [
              "number",
              "null"
            ]
          },
          "min": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "median": {
            "type": [
              "number",
              "null"
            ]
          },
          "percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "sample_count": {
            "type": [
              "number",
              "null"
            ]
          },
          "vs_median_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "window_days_actual": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    },
    "current": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "ts": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    },
    "license": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "zone_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "attribution": {
      "type": [
        "string",
        "null"
      ]
    },
    "coverage_note": {
      "type": [
        "string",
        "null"
      ]
    },
    "context_window_requested_days": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
get_zone_brief annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_history — Historical time series
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_history input schema
{
  "type": "object",
  "required": [
    "zone",
    "metric"
  ],
  "properties": {
    "end": {
      "type": "integer",
      "description": "Window end, Unix seconds. Default: now."
    },
    "zone": {
      "enum": [
        "US-CAISO",
        "US-ERCOT",
        "US-PJM",
        "US-MISO",
        "US-NYISO",
        "US-ISONE",
        "US-SPP",
        "DE-LU",
        "FR",
        "ES",
        "IT-NO",
        "NL",
        "BE",
        "PL",
        "SE-3",
        "NO-2",
        "DK-1",
        "AT",
        "CH",
        "GB",
        "AU-NSW",
        "AU-QLD",
        "AU-VIC",
        "AU-SA",
        "AU-TAS"
      ],
      "type": "string",
      "description": "Zone id. US ISOs: US-CAISO, US-ERCOT, US-PJM, US-MISO, US-NYISO, US-ISONE, US-SPP. Europe: DE-LU, FR, ES, IT-NO, NL, BE, PL, SE-3, NO-2, DK-1, AT, CH. Great Britain: GB. Australia (NEM): AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS. Call list_zones for names, sources, currencies and licences."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Max rows (default 200, max 1000 via MCP; sample mode caps at 50)."
    },
    "start": {
      "type": "integer",
      "description": "Window start, Unix seconds. Default: end minus 24h."
    },
    "metric": {
      "enum": [
        "price",
        "demand",
        "generation",
        "carbon-intensity",
        "interchange",
        "capacity"
      ],
      "type": "string",
      "description": "Which series to fetch."
    },
    "api_key": {
      "type": "string",
      "description": "Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output)."
    }
  },
  "additionalProperties": false
}
get_history output schema
{
  "type": "object",
  "properties": {
    "end": {
      "type": [
        "number",
        "null"
      ]
    },
    "data": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "ts": {
            "type": [
              "number",
              "null"
            ]
          },
          "fuel": {
            "type": [
              "string",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "metric": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "resolution": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "zone": {
      "type": [
        "string",
        "null"
      ]
    },
    "count": {
      "type": [
        "number",
        "null"
      ]
    },
    "start": {
      "type": [
        "number",
        "null"
      ]
    },
    "metric": {
      "type": [
        "string",
        "null"
      ]
    },
    "license": {
      "type": [
        "string",
        "null"
      ]
    },
    "attribution": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
get_history annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_map_snapshot — All zones right now
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_map_snapshot input schema
{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Optional GridHub API key (ghk_...). Prefer sending it as an 'Authorization: Bearer <key>' HTTP header on the MCP connection; use this argument only if your client cannot set headers. Without a key the tool runs in free sample mode (truncated output)."
    }
  },
  "additionalProperties": false
}
get_map_snapshot output schema
{
  "type": "object",
  "properties": {
    "zones": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "zone": {
            "type": [
              "string",
              "null"
            ]
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "metrics": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "ts": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "unit": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "resolution": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "updated": {
            "type": [
              "number",
              "null"
            ]
          },
          "attribution": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "generated": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
get_map_snapshot annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-07: 1 of 1 checks answered
  2. 2026-11-09: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
194 ms
95th percentile latency
194 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 194 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http gridhub-electricity-market-data-mcp https://api.grid-hub.app/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add gridhub-electricity-market-data-mcp --url https://api.grid-hub.app/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable gridhub-electricity-market-data-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "gridhub-electricity-market-data-mcp": {
      "url": "https://api.grid-hub.app/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "gridhub-electricity-market-data-mcp": {
      "type": "streamableHttp",
      "url": "https://api.grid-hub.app/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start gridhub-electricity-market-data-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "gridhub-electricity-market-data-mcp": {
      "type": "http",
      "url": "https://api.grid-hub.app/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http gridhub-electricity-market-data-mcp https://api.grid-hub.app/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.grid-hub.app/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "gridhub-electricity-market-data-mcp": {
      "serverUrl": "https://api.grid-hub.app/mcp"
    }
  }
}

Let your agent find its tools

Find servers like GridHub Electricity Market Data MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 7,097