{
  "markdown": "# GridHub MCP Server\n\nLive and historical electricity market data for AI agents, over the [Model Context Protocol](https://modelcontextprotocol.io).\n\n**Endpoint:** `https://api.grid-hub.app/mcp` — hosted, Streamable HTTP, stateless. Nothing to install.\n\nCovers 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.\n\n## Tools\n\n| Tool | What it returns |\n|---|---|\n| `get_zone_brief` | Current 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?\" |\n| `get_latest` | Most recent value of every metric one zone publishes, with unit and timestamp |\n| `get_history` | Time series for one metric over a start/end window (up to 31 days per call) |\n| `get_map_snapshot` | Headline values for all 25 zones at once — compare or rank zones |\n| `list_zones` | Zone ids, names, sources, currencies, licences (free) |\n| `get_status` | Ingestion freshness per source and zone (free) |\n\n## Access\n\nThree levels, no signup needed to start:\n\n1. **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.\n2. **Free API key** — 500 requests/day. Instant email signup at [grid-hub.app/developers](https://grid-hub.app/developers#free-key), or `POST https://api.grid-hub.app/v1/keys/signup` with `{\"email\": \"...\"}`. Send as `Authorization: Bearer <ghk_key>`.\n3. **x402 pay-per-call** — USDC on Base, $0.001–$0.02 per call, via the `X-PAYMENT` header. See [the x402 flow](https://grid-hub.app/developers).\n\n## Setup\n\n**Claude Code**\n```bash\nclaude mcp add --transport http gridhub https://api.grid-hub.app/mcp \\\n  --header \"Authorization: Bearer YOUR_KEY\"\n```\n\n**Cursor / Windsurf / VS Code** (`mcp.json`)\n```json\n{\n  \"mcpServers\": {\n    \"gridhub\": {\n      \"url\": \"https://api.grid-hub.app/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_KEY\" }\n    }\n  }\n}\n```\n\n**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.\n\n**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.\n```json\n{\n  \"mcpServers\": {\n    \"gridhub\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"github:jalcodev/gridhub-mcp\"],\n      \"env\": { \"GRIDHUB_API_KEY\": \"YOUR_KEY\" }\n    }\n  }\n}\n```\nOr with Docker: `docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp`. Omit the key for sample mode.\n\n**Any client, no key** — omit the header. You'll get sample-mode data and a note on how to upgrade.\n\n## Protocol\n\n- Streamable HTTP, stateless: one JSON-RPC message per POST, JSON response. No sessions, no SSE.\n- Speaks MCP `2026-07-28` (header-mirrored requests, no handshake) and `2025-03-26` through `2025-11-25` (`initialize` handshake).\n- Tool results include `structuredContent` alongside the text block.\n- Rate limits and quotas are those of the underlying [REST API](https://api.grid-hub.app/llms.txt); the MCP layer adds none of its own.\n\n## Related\n\n- REST API docs: https://grid-hub.app/developers\n- OpenAPI: https://api.grid-hub.app/openapi.json\n- `llms.txt`: https://api.grid-hub.app/llms.txt\n- Official MCP Registry entry: `io.github.jalcodev/gridhub`\n\n## License\n\nThe 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).\n",
  "bytes": 3946,
  "sha": "41b8c1948f0f5733014b47bc9bafa491a38216354f166a0a8f6777a4c5dc98b7",
  "repo_slug": "jalcodev/gridhub-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jalcodev_gridhub_69ecd2b2/readme"
}