Pgiq Mcp

io.github.powergridiqPublished by GitHub account powergridiqv1.3.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that exposes PowerGridIQ's read-only ratings of global power markets to help an assistant decide where to site or schedule a large electricity.

What you can do
List every rated power market with tier, score and outlook, and get a full five-pillar rating with evidence for one market, including confidence level and cited grid developments. Rank the best markets by lens (default, cost, carbon, momentum), group and minimum tier. Read a grid snapshot per market: carbon intensity, price, fuel mix, demand, firm headroom and peak stress, merging live signals where available or a labelled modelled baseline. Find the cheapest hours to run a flexible load in a market, or the cheapest grids overall.
When to use it
Useful when comparing candidate locations or schedules for a large electricity load such as a data centre or industrial site, or when you want a cited, reasoned view of how a power market is rated rather than raw feeds.
Requirements
Runs locally as a Node.js process over stdio, installed from the npm package and started with node. Network access to the PowerGridIQ REST API. No key needed for the free tier (100 requests/day per IP); an optional PGIQ_KEY raises the quota, and PGIQ_API can override the API base.
Before you install
The rating is described as a directional screen, not a connection guarantee, and lower-confidence markets should be treated with more caution. The optional PGIQ_KEY is a secret sent to a third-party API; the free tier is rate-limited per IP. Queries and market lookups go to the external PowerGridIQ service.

Installation

In SourceWeft

  1. Open Pgiq Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
cd pgiq-mcpnpm installnode index.js   # speaks MCP over stdio

Configure in Claude Desktop

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

json
{  "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 [email protected].
  • 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.

Links

Source: README.md at commit 1c7bca2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.3.0LatestOct 5, 2026
  2. v1.1.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts