GridPulse Energy

БесплатноНе проверен

MCP server for real-time electricity prices, carbon intensity, and energy analytics across 41+ zones in Europe, Great Britain, the United States, and Australia.

автор: DevTee-dot

GitHub Embed

Описание

MCP server for real-time electricity prices, carbon intensity, and energy analytics across 41+ zones in Europe, Great Britain, the United States, and Australia. Query live prices, compare zones, check gas storage levels, get green scores, find optimal charging windows, and access advanced analytics. Free Basic tier requires no API key. Install via npx gridpulse-mcp or connect directly via Streamab

README

The electricity price API for developers and AI agents. Real-time and historical wholesale electricity prices, carbon intensity, generation mix, gas storage, weather, and analytics for 41+ bidding zones across Europe, Great Britain, the United States, and Australia — plus monthly carbon intensity for 70+ countries worldwide.

API Status npm License: MIT

🔑 Get an API Key

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

👉 Get your API key on RapidAPI

Plan	Price	Requests/month	Rate Limit
Basic	Free	500	1 req/sec
Pro	$29/mo	10,000	10 req/sec
Ultra	$99/mo	60,000	25 req/sec
Mega	$299/mo	250,000	50 req/sec

🌐 Links

Website: gridpulse.network
API: api.gridpulse.network
Documentation: gridpulse.network/docs
RapidAPI: rapidapi.com/devtee000/api/gridpulse-energy
npm (MCP): npmjs.com/package/gridpulse-mcp
Status: stats.uptimerobot.com/J5zSXoBKy5

🤖 MCP Support for AI Agents

GridPulse is MCP-native. Connect Claude Desktop, Cursor, VS Code, Claude Code, or any AI agent in seconds.

Quick Start (no API key needed)

npx gridpulse-mcp

Claude Desktop

No API key needed for Basic tier:

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

With API key (get one here):

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

Or connect directly via Streamable HTTP:

{
  "mcpServers": {
    "gridpulse": {
      "url": "https://api.gridpulse.network/mcp",
      "headers": {
        "X-API-Key": "your_key_here"
      }
    }
  }
}

Claude Code

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

Ask your AI assistant

"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 and what does it mean for prices?"
"Find the greenest grid in Europe to run my batch job tonight"
"What's the GB electricity market doing — is the system long or short?"
"Schedule my workload across DE, FR, and NO — find the cheapest and greenest window before midnight"

Available MCP 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

⚡ Quick Start (REST API)

No API key needed for Basic tier:

# Current electricity price in Germany
curl "https://api.gridpulse.network/v1/prices/current?zone=DE"

# Carbon intensity in Great Britain
curl "https://api.gridpulse.network/v1/carbon/current?zone=GB"

# Compare prices across Europe — ranked cheapest first
curl "https://api.gridpulse.network/v1/compare/prices?zones=DE,FR,NO,SE,DK,AT,NL,BE,ES"

# Gas storage in Germany
curl "https://api.gridpulse.network/v1/fuels/gas-storage?country=DE"

# Carbon intensity for Japan (global coverage)
curl "https://api.gridpulse.network/v1/carbon/global?country=JP"

# GB market — day-ahead vs system price spread
curl "https://api.gridpulse.network/v1/prices/gb-market"

# Green score comparison across regions
curl "https://api.gridpulse.network/v1/compare/green?zones=DE,FR,NO,GB,CAISO"

With API key (Pro+):

# Price history
curl "https://api.gridpulse.network/v1/prices/history?zone=DE&from=2025-01-01&to=2025-01-31" \
  -H "X-API-Key: your_key_here"

# Generation mix
curl "https://api.gridpulse.network/v1/generation/current?zone=DE" \
  -H "X-API-Key: your_key_here"

# Price volatility analytics
curl "https://api.gridpulse.network/v1/analytics/volatility?zone=DE&days=30" \
  -H "X-API-Key: your_key_here"

📡 Live Coverage

Region	Zones	Update Frequency
Europe	DE, AT, FR, NL, BE, ES, NO, SE, DK + 16 more	Every 15-30 min
Great Britain	GB — day-ahead + system prices + interconnectors + wind forecast	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 worldwide	Monthly

📋 Endpoints (48 total)

🟢 Basic — Free

Endpoint	Description
`GET /v1/prices/current`	Latest spot price for any zone
`GET /v1/prices/day-ahead`	Next 24-48h prices
`GET /v1/prices/gb-market`	GB day-ahead vs system price spread
`GET /v1/compare/prices`	Compare prices across up to 10 zones
`GET /v1/compare/carbon`	Compare carbon intensity across up to 10 zones
`GET /v1/compare/green`	Compare green scores across up to 10 zones
`GET /v1/carbon/current`	Real-time carbon intensity (gCO₂/kWh)
`GET /v1/carbon/forecast`	48h carbon forecast (GB)
`GET /v1/carbon/global`	Monthly carbon for 70+ countries
`GET /v1/green/score`	0-100 cleanliness score
`GET /v1/fuels/gas-storage`	EU gas storage levels
`GET /v1/fuels/gas-storage/history`	Historical gas storage
`GET /v1/fuels/lng`	LNG terminal data
`GET /v1/fuels/summary`	EU-wide gas market summary
`GET /v1/fuels/henry-hub`	Henry Hub gas prices
`GET /v1/fuels/carbon-price`	EU ETS carbon allowance prices
`GET /v1/weather/current`	Wind, solar, temperature
`GET /v1/weather/forecast`	48h weather forecast
`GET /v1/zones`	All supported zone codes
`GET /v1/stats`	Database statistics
`GET /v1/plans`	Plan details and limits

🔵 Pro — $29/month

Everything in Basic, plus:

Endpoint	Description
`GET /v1/prices/history`	Full price history with date range
`GET /v1/prices/cheapest`	Cheapest N-hour window finder
`GET /v1/prices/consumer`	Consumer retail prices DE/AT
`GET /v1/generation/current`	Generation mix by fuel type
`GET /v1/generation/forecast`	Wind and demand forecast
`GET /v1/fuels/henry-hub/history`	Full Henry Hub history
`GET /v1/fuels/carbon-price/history`	Full EUA carbon price history
`GET /v1/fuels/retail-prices`	US retail prices by state
`POST /v1/webhooks`	Create price/carbon alert
`GET /v1/webhooks`	List your webhooks
`DELETE /v1/webhooks/:id`	Delete a webhook

🟣 Ultra — $99/month

Everything in Pro, plus:

Endpoint	Description
`GET /v1/analytics/volatility`	Price volatility metrics
`GET /v1/analytics/negative-prices`	Historical negative price events
`GET /v1/analytics/negative-risk`	Negative price probability score (0-100)
`GET /v1/analytics/correlation`	Zone price correlation
`GET /v1/analytics/peak-hours`	Peak demand patterns
`GET /v1/analytics/grid-stress`	Grid stress indicator
`GET /v1/analytics/carbon-optimal`	Optimal low-carbon scheduling windows
`GET /v1/fuels/winter-readiness`	Winter gas risk score
`GET /v1/fuels/gas-power-correlation`	Gas/power price correlation
`GET /v1/fuels/lng-dependency`	LNG import dependency score

⚫ Mega — $299/month

Everything in Ultra, plus:

Endpoint	Description
`GET /v1/analytics/hydro`	Hydro reservoir analytics for NO, CH, AT, SE, FI

🧪 Testing

# Run all tests
npm test

# Run API endpoint audit (71 tests)
npm run audit --workspace=@gridpulse/api

# Run specific workspace tests
npm test --workspace=@gridpulse/api

📦 MCP Package

The apps/mcp-package/ directory contains the standalone npm MCP server published as gridpulse-mcp.

# Run without installing
npx gridpulse-mcp

# Install globally
npm install -g gridpulse-mcp

# With API key
GRIDPULSE_API_KEY=your_key npx gridpulse-mcp

Published at: npmjs.com/package/gridpulse-mcp

🗺️ Roadmap

Japan (JEPX) — 9 regional zones + national system price in JPY
Price forecasting — 24-72h XGBoost model for DE, GB, NO
Direct API key registration on gridpulse.network
Python SDK
JavaScript/TypeScript SDK
Expanded US zone coverage

📄 License

MIT — see LICENSE

📧 Support

Email: [email protected]
Website: gridpulse.network
Docs: gridpulse.network/docs
API Status: stats.uptimerobot.com/J5zSXoBKy5
RapidAPI: rapidapi.com/devtee000/api/gridpulse-energy

from github.com/DevTee-dot/grid-pulse

Установка GridPulse Energy

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/DevTee-dot/grid-pulse

FAQ