MCP Server

Overview

Your AI assistant can connect to our official MCP server to access real-time grid data, including system state, generation mix, grid stress index, and more.

Connect your client

Choose your client and follow the setup instructions. Interactive clients sign you in automatically — no API key required.

Works for both claude.ai (web) and the Claude Desktop app.

Go to Settings → Connectors
Click Add and enter the server URL: https://mcp.powersignals.co.za/mcp/
Click Add custom connector and complete sign-in
In any new chat, click + and enable Power Signals under Connectors

Run this in your terminal:

claude mcp add --transport http power-signals https://mcp.powersignals.co.za/mcp/

Then type /mcp inside Claude Code and complete sign-in in your browser. Verify anytime with claude mcp list.

Run these commands in your terminal:

codex mcp add power-signals --url https://mcp.powersignals.co.za/mcp/
codex mcp login power-signals

Complete sign-in in your browser. The server is then available in the Codex app, CLI, and IDE extension. Verify anytime with codex mcp list or type /mcp in Codex.

Add the following to your ~/.cursor/mcp.json file, then save and restart Cursor:

"mcpServers": {
    "power-signals": {
        "url": "https://mcp.powersignals.co.za/mcp/"
    }
}

Cursor automatically discovers all available tools and invokes the appropriate one whenever you ask grid-related questions in chat.

Add the server to ~/.hermes/config.yaml:

mcp_servers:
    power-signals:
        url: "https://mcp.powersignals.co.za/mcp/"
        auth: oauth

Then run OAuth sign-in from a fresh terminal (don’t start it from inside an already-running Hermes session — the auto-reload timeout is too short for browser auth):

hermes mcp login power-signals

Complete sign-in in your browser. In an active Hermes session, reload MCP tools with /reload-mcp, or start a new chat:

hermes chat

See Hermes’ MCP docs for filtering, re-auth, and troubleshooting.

Add the Power Signals MCP server to OpenClaw, then sign in with OAuth:

openclaw mcp add power-signals \
    --url https://mcp.powersignals.co.za/mcp/ \
    --transport streamable-http \
    --auth oauth

openclaw mcp login power-signals

OpenClaw prints an authorization URL — approve in your browser, then finish with:

openclaw mcp login power-signals --code <code>

Verify the connection anytime with:

openclaw mcp probe power-signals

Prefer configuring it manually? Add this under mcp.servers in ~/.openclaw/openclaw.json, then run the same openclaw mcp login flow:

{
 "mcp": {
    "servers": {
        "power-signals": {
            "url": "https://mcp.powersignals.co.za/mcp/",
            "transport": "streamable-http",
            "auth": "oauth"
        }
    }
 }
}

See OpenClaw’s MCP docs for full CLI and config reference.

Available tools

Browse all tools

Grid

get_system_state: Get grid system state records. Filters records by date range (YYYY-MM-DD) and returns the most recent entries first. Optional limit parameter sets the maximum number of records to retrieve.

Generation

get_generation_mix: Get generation mix records by fuel type. Filters records by date range (YYYY-MM-DD) and returns the most recent entries first. Optional limit parameter sets the maximum number of records to retrieve.

Features

get_grid_stress_index: Get grid stress index records. Filters records by date range (YYYY-MM-DD) and returns the most recent entries first. Optional limit parameter sets the maximum number of records to retrieve.

Example prompts

Once connected, try asking your AI assistant questions like:

Show me the grid system state from 2026-07-01 to today.
Get the last 20 system state readings since 2026-06-01.
What was the generation mix by fuel type over the last week?
How much wind and solar were generated between 2026-07-01 and 2026-07-10?
Show me the grid stress index from 2026-07-01 to today.
Get the last 10 grid stress index readings since 2026-06-01.
What’s the grid stress index been since 2026-07-20?

Getting Started

Integrations

API Reference

Guides

Overview

Connect your client

Available tools

Grid

Generation

Features

Example prompts

​Overview

​Connect your client

​Available tools

​Grid

​Generation

​Features

​Example prompts

Overview

Connect your client

Available tools

Grid

Generation

Features

Example prompts