Pgiq MCP server

PowerGridIQ MCP server

Exposes the PGIQ Rating as tools any MCP-capable agent (Claude Desktop, Claude Code, Cursor, custom agents) can call: "where should I site or schedule a large electricity load, and how is a given market rated." It wraps the read-only REST API at https://powergridiq.com/api/v1, covering 67 global power markets with a reasoned, cited decision, not just raw feeds.

Tools

default|cost|carbon|momentum.

• pgiq_markets - list every rated market (id, tier, score, outlook). Start here.
• pgiq_rating(market) - full five-pillar rating + evidence for one market (e.g. quebec).
• pgiqbest(lens?, group?, mintier?, limit?) - the ranked best-market decision. lens is

peak stress. Merges live signals where available, else a clearly labelled modelled baseline.

• pgiq_developments(market?) - recent cited grid developments.
• pgiq_grid(market) - grid snapshot: carbon intensity, price, fuel mix, demand, firm headroom,

shape, local time). Omit market for the cheapest grids ranked.

• pgiqcheapestwindow(market?) - cheapest hours to run a flexible load (modelled daily price

Install & run

cd pgiq-mcp
npm install
node index.js   # speaks MCP over stdio

Configure in Claude Desktop

Add to claudedesktopconfig.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "powergridiq": {
      "command": "node",
      "args": ["/absolute/path/to/pgiq-mcp/index.js"],
      "env": { "PGIQ_KEY": "pk_live_optional_key_for_higher_limits" }
    }
  }
}

Restart Claude Desktop, then ask things like "Use PowerGridIQ to find the best carbon-light market for a 100 MW AI cluster in Europe" or "What's the PGIQ rating for Ireland and why?"

Authentication & limits

Request a key at hello@powergridiq.com.

• No key needed for the free tier: 100 requests/day per IP.
• For a higher monthly quota, set PGIQKEY=pklive_... (developer 25,000/mo, pro 500,000/mo).

• Override the API base with PGIQ_API if needed.

Notes

real gate. Every market carries a confidence level, treat lower confidence with more caution.

• The rating is a directional screen, not a connection guarantee; the interconnection queue is the

forecasts are next.

• Live grid signals, rating-change webhooks, and metered keys are available now; short-horizon

• A hosted remote MCP server (no local install) is planned; for now this runs locally via stdio.

Links

• API spec: https://powergridiq.com/openapi.json
• Agent map: https://powergridiq.com/llms.txt
• Developer page: https://powergridiq.com/build