English Français العربية

io.github.powergridiq/pgiq-mcp

Official registry Other

Power-market ratings, delivered cost, claims and gaps for siting a large electricity load.

Source code Documentation

What can you do with io.github.powergridiq/pgiq-mcp?

  • 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).
  • pgiq_best(lens?, group?, min_tier?, limit?) - the ranked best-market decision. lens is
  • pgiq_developments(market?) - recent cited grid developments.
  • pgiq_grid(market) - grid snapshot: carbon intensity, price, fuel mix, demand, firm headroom,
  • pgiq_cheapest_window(market?) - cheapest hours to run a flexible load (modelled daily price

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package pgiq-mcp
Claude Code 
claude mcp add pgiq-mcp -e 'PGIQ_KEY=<your pgiq_key>' -e 'PGIQ_API=<PGIQ_API>' -- npx -y pgiq-mcp@1.3.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pgiq-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "pgiq-mcp@1.3.0"
            ],
            "env": {
                "PGIQ_KEY": "<your pgiq_key>",
                "PGIQ_API": "<PGIQ_API>"
            }
        }
    }
}

Environment variables

  • PGIQ_KEY secret Optional PowerGridIQ API key (pk_live_...) for a higher quota.
  • PGIQ_API Optional API base override.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PowerGridIQ MCP server
  2. Tools
  3. Install & run
  4. Configure in Claude Desktop
  5. Authentication & limits
  6. Notes
  7. Links

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

  • 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).
  • pgiq_best(lens?, group?, min_tier?, limit?) - the ranked best-market decision. lens is default|cost|carbon|momentum.
  • pgiq_developments(market?) - recent cited grid developments.
  • pgiq_grid(market) - grid snapshot: carbon intensity, price, fuel mix, demand, firm headroom, peak stress. Merges live signals where available, else a clearly labelled modelled baseline.
  • pgiq_cheapest_window(market?) - cheapest hours to run a flexible load (modelled daily price shape, local time). Omit market for the cheapest grids ranked.

Install & run

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

Configure in Claude Desktop

Add to claude_desktop_config.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

  • No key needed for the free tier: 100 requests/day per IP.
  • For a higher monthly quota, set PGIQ_KEY=pk_live_... (developer 25,000/mo, pro 500,000/mo). Request a key at hello@powergridiq.com.
  • Override the API base with PGIQ_API if needed.

Notes

  • The rating is a directional screen, not a connection guarantee; the interconnection queue is the real gate. Every market carries a confidence level, treat lower confidence with more caution.
  • Live grid signals, rating-change webhooks, and metered keys are available now; short-horizon forecasts are next.
  • A hosted remote MCP server (no local install) is planned; for now this runs locally via stdio.

Frequently asked questions

What is io.github.powergridiq/pgiq-mcp?

Power-market ratings, delivered cost, claims and gaps for siting a large electricity load.

How do I install io.github.powergridiq/pgiq-mcp?

It runs on your machine. In Claude Code: claude mcp add pgiq-mcp -e 'PGIQ_KEY=<your pgiq_key>' -e 'PGIQ_API=<PGIQ_API>' -- npx -y pgiq-mcp@1.3.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.powergridiq/pgiq-mcp need an API key?

Yes. It expects PGIQ_KEY, which you set in its configuration.

Is io.github.powergridiq/pgiq-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.powergridiq/pgiq-mcp?

It is published by powergridiq. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.