GridPulse MCP Server

Real-time electricity prices, carbon intensity, and energy analytics for 41+ zones across Europe, Great Britain, the United States, and Australia — via the Model Context Protocol.

🔑 Get an API Key

Basic tier is free — no API key needed for 500 requests/month.

For higher limits, get a key in 60 seconds:

👉 Get your API key on RapidAPI

| Plan | Price | Requests/month | |------|-------|----------------| | Basic | Free | 500 — no key needed | | Pro | $29/mo | 10,000 | | Ultra | $99/mo | 60,000 | | Mega | $299/mo | 250,000 |

Once you have a key, set it as an environment variable:

export GRIDPULSE_API_KEY=your_key_here

Or pass it inline:

GRIDPULSE_API_KEY=your_key npx gridpulse-mcp

Quick Start

No API key needed for Basic tier:

npx gridpulse-mcp

With a Pro/Ultra/Mega API key:

GRIDPULSE_API_KEY=your_key npx gridpulse-mcp

Optional: set GRIDPULSE_PLAN (basic, pro, ultra, or mega) if your key’s tier differs from the default (mega is used for client-side tool gating when a key is present).

Installation

Claude Desktop

Add to your config file. No API key needed for Basic tier:

{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": ["-y", "gridpulse-mcp"]
    }
  }
}

With a Pro/Ultra/Mega key (get one here):

{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": ["-y", "gridpulse-mcp"],
      "env": {
        "GRIDPULSE_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add gridpulse --command "npx" --args "-y,gridpulse-mcp"

With API key:

GRIDPULSE_API_KEY=your_key claude mcp add gridpulse --command "npx" --args "-y,gridpulse-mcp"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": ["-y", "gridpulse-mcp"],
      "env": {
        "GRIDPULSE_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "gridpulse": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gridpulse-mcp"],
      "env": {
        "GRIDPULSE_API_KEY": "your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": ["-y", "gridpulse-mcp"],
      "env": {
        "GRIDPULSE_API_KEY": "your_key_here"
      }
    }
  }
}

Available Tools (16)

| Tool | Description | Plan | |------|-------------|------| | get_current_price | Latest spot price for any zone | Basic | | get_day_ahead_prices | Full hourly day-ahead price curve | Basic | | get_carbon_intensity | Real-time carbon intensity (gCO₂/kWh) | Basic | | get_green_score | 0-100 green score combining renewables and carbon | Basic | | get_supported_zones | List all 41+ supported zone codes | Basic | | compare_prices | Compare prices across up to 10 zones | Basic | | compare_carbon | Compare carbon intensity across up to 10 zones | Basic | | compare_green | Compare green scores across up to 10 zones | Basic | | get_gas_storage | EU gas storage level and price risk signal | Basic | | get_global_carbon | Monthly carbon intensity for 70+ countries | Basic | | get_gb_market | GB day-ahead vs system price spread | Basic | | get_weather | Wind, solar, temperature for any zone | Basic | | get_cheapest_window | Cheapest N contiguous hours before deadline | Pro | | get_price_history | Historical prices between two dates | Pro | | get_optimal_schedule | Multi-zone ranking by price, carbon, or balanced | Pro |

Example Questions

• "What is the current electricity price in Germany?"
• "Which European country has the cheapest electricity right now?"
• "Find the cheapest 4-hour window to charge my EV in Norway before 7am"
• "Compare the carbon intensity of Germany, France, and Norway"
• "What is Germany's gas storage level?"
• "What is Japan's carbon intensity?"
• "What's the GB electricity market doing right now?"
• "Find the greenest grid in Europe for my batch job tonight"

Coverage

| Region | Zones | Update Frequency | |--------|-------|-----------------| | Europe | DE, AT, FR, NL, BE, ES, NO, SE, DK + 16 more | Every 15-30 min | | Great Britain | GB | Every 30 min | | United States | CAISO, ERCOT, NYISO, PJM, SPP, MISO, ISONE | Every 5 min | | Australia | AU-NSW, AU-QLD, AU-VIC, AU-SA, AU-TAS | Every 5 min | | Global Carbon | 70+ countries | Monthly |

Pricing & Support

• 🌐 Website: gridpulse.network
• 🔑 Get API key: rapidapi.com/devtee000/api/gridpulse-energy
• 📖 Full API docs: gridpulse.network/docs
• 📧 Support: [email protected]
• 📊 API Status: stats.uptimerobot.com/J5zSXoBKy5

License

MIT