{
  "markdown": "# PowerGridIQ MCP server\n\nExposes the **PGIQ Rating** as tools any MCP-capable agent (Claude Desktop, Claude Code, Cursor,\ncustom agents) can call: \"where should I site or schedule a large electricity load, and how is a\ngiven market rated.\" It wraps the read-only REST API at `https://powergridiq.com/api/v1`, covering\n67 global power markets with a reasoned, cited decision, not just raw feeds.\n\n## Tools\n- `pgiq_markets` - list every rated market (id, tier, score, outlook). Start here.\n- `pgiq_rating(market)` - full five-pillar rating + evidence for one market (e.g. `quebec`).\n- `pgiq_best(lens?, group?, min_tier?, limit?)` - the ranked best-market decision. `lens` is\n  `default|cost|carbon|momentum`.\n- `pgiq_developments(market?)` - recent cited grid developments.\n- `pgiq_grid(market)` - grid snapshot: carbon intensity, price, fuel mix, demand, firm headroom,\n  peak stress. Merges live signals where available, else a clearly labelled modelled baseline.\n- `pgiq_cheapest_window(market?)` - cheapest hours to run a flexible load (modelled daily price\n  shape, local time). Omit `market` for the cheapest grids ranked.\n\n## Install & run\n```bash\ncd pgiq-mcp\nnpm install\nnode index.js   # speaks MCP over stdio\n```\n\n## Configure in Claude Desktop\nAdd to `claude_desktop_config.json` (Settings → Developer → Edit Config):\n```json\n{\n  \"mcpServers\": {\n    \"powergridiq\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/pgiq-mcp/index.js\"],\n      \"env\": { \"PGIQ_KEY\": \"pk_live_optional_key_for_higher_limits\" }\n    }\n  }\n}\n```\nRestart Claude Desktop, then ask things like \"Use PowerGridIQ to find the best carbon-light market\nfor a 100 MW AI cluster in Europe\" or \"What's the PGIQ rating for Ireland and why?\"\n\n## Authentication & limits\n- No key needed for the free tier: 100 requests/day per IP.\n- For a higher monthly quota, set `PGIQ_KEY=pk_live_...` (developer 25,000/mo, pro 500,000/mo).\n  Request a key at hello@powergridiq.com.\n- Override the API base with `PGIQ_API` if needed.\n\n## Notes\n- The rating is a directional screen, not a connection guarantee; the interconnection queue is the\n  real gate. Every market carries a confidence level, treat lower confidence with more caution.\n- Live grid signals, rating-change webhooks, and metered keys are available now; short-horizon\n  forecasts are next.\n- A hosted remote MCP server (no local install) is planned; for now this runs locally via stdio.\n\n## Links\n- API spec: https://powergridiq.com/openapi.json\n- Agent map: https://powergridiq.com/llms.txt\n- Developer page: https://powergridiq.com/build\n",
  "bytes": 2576,
  "sha": "98427e23ddda8c88c8e588201a3818acf784fe26917a21ddd58331f7a31ed340",
  "repo_slug": "powergridiq/pgiq-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_powergridiq_pgiq_mcp_e41289f8/readme"
}