English Français العربية

io.github.powergridiq/pgiq-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.powergridiq/pgiq-mcp؟

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

كيف أثبّت io.github.powergridiq/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.powergridiq/pgiq-mcp إلى مفتاح API؟

نعم. يتطلب PGIQ_KEY، وتضبطها في إعداداته.

هل io.github.powergridiq/pgiq-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.powergridiq/pgiq-mcp؟

ينشره powergridiq. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.