Real-time electricity prices, carbon intensity, and energy analytics for 41+ zones across Europe, GB, US, and Australia. Query live prices, compare zones, check gas storage, get green scores, and access advanced analytics via MCP.
Scored across 15 tools
Tools are mostly distinct with clear scopes; compare_* tools each target a different metric (carbon vs green vs price), and get_carbon_intensity vs get_global_carbon differ by temporal and geographic scope. Minor confusion possible between get_cheapest_window and get_optimal_schedule but descriptions clarify single vs multi-zone.
All tools follow a consistent verb_noun pattern using get_ or compare_, with no mixed conventions. Nouns are descriptive and predictable.
15 tools is at the upper bound of the ideal range but each serves a distinct function for an energy API covering prices, carbon, scheduling, and market insights. No redundancy or bloat.
Covers price (current, day-ahead, history), carbon (current, global, comparative), green scores, scheduling optimization, weather, and market specifics. Missing historical carbon intensity for zones and renewable generation mix, but core workflows are supported.
Compare carbon intensity (gCO2/kWh) across multiple zones in one call, ranked cleanest first. Use when the user asks which grid is cleanest, or wants to find the lowest-carbon location to run a workload. Labels: very clean (0-100), clean (100-200), moderate (200-300), high (300-450), very high (450+).
Inputs: zones (required).
Compare green scores (0-100) across multiple zones in one call, ranked greenest first. Green score combines renewables percentage (60% weight) and carbon intensity (40% weight). Labels: excellent (80-100), good (60-80), moderate (40-60), below average (20-40), poor (0-20). Use when the user wants to find the greenest grid for scheduling workloads.
Inputs: zones (required).
Compare current electricity spot prices across multiple zones in one call and get a ranked list cheapest first. Use when the user asks 'which country has the cheapest electricity right now?' or wants to compare prices across regions. Supports up to 10 zones. EU zones ranked in EUR, US zones in USD, AU zones in AUD, GB in GBP.
Inputs: zones (required), currency.
Current grid electricity carbon intensity for a zone in gCO2/kWh. Lower values mean cleaner power — use for carbon-aware workload routing or comparing cleanliness across times or regions.
Inputs: zone (required).
Find the cheapest N contiguous hours to run a flexible load (EV charging, battery, batch job) before a deadline. Calls the API cheapest endpoint, then refines using day-ahead hourly prices so the window respects the given UTC deadline (HH:MM interpreted as UTC — if that moment already passed today, tomorrow is used).
Inputs: zone (required), hours (required), before (required).
Get the latest available electricity spot / current market price for one bidding zone (EUR/MWh). Use when the user asks what power costs right now, or needs a fresh price snapshot. Optionally bundle carbon intensity (gCO2/kWh) and/or renewables share (%) for the same moment.
Inputs: zone (required), include.
Get tomorrow's (and near-future) hourly day-ahead electricity prices for a zone — typically used to show the full daily price curve, find low-price hours visually, or debug scheduling. Returns a time series in EUR/MWh.
Inputs: zone (required).
Get current natural gas storage level for any EU country as a percentage of capacity, with trend (injecting/withdrawing), comparison to 5-year seasonal average, and electricity price risk signal. Gas storage directly affects electricity prices in Europe — low storage means higher gas prices means higher power prices. Updated daily.
Inputs: country (required).
Get the Great Britain electricity market summary showing day-ahead price vs real-time system buy/sell prices from the Elexon balancing mechanism, plus the spread between them and whether the system is long (surplus) or short (deficit). Essential for GB battery storage operators and flexible demand managers.
Inputs: no named parameters.
Get monthly carbon intensity (gCO2/kWh) for any country worldwide using ISO2 country codes. Covers 70+ countries including Japan, China, India, Brazil, South Africa, South Korea, Australia, New Zealand, Mexico, Egypt, Nigeria, and more. Use for Scope 2 emissions calculations or comparing carbon intensity of electricity globally.
Inputs: country (required).
Single 0–100 'green score' for a zone: 100 ≈ very renewable / low carbon, 0 ≈ fossil-heavy. Use as a compact signal for ‘should I run compute now?’ when a numeric score is easier than raw carbon + mix.
Inputs: zone (required).
Given multiple zones where flexible compute or charging could run, find the best contiguous hour block before a UTC deadline. Returns a ranked list using day-ahead prices per zone and each zone’s current green score. Optimise for lowest price, highest green score, or a balanced blend.
Inputs: hours (required), zones (required), deadline_utc (required), optimise_for.
Historical electricity prices between two ISO 8601 dates (inclusive range as implemented by the API). Use for backtesting, charts, or ‘what did power cost last week?’. Requires API plan that allows /v1/prices/history in production.
Inputs: to (required), from (required), zone (required).
List all bidding-zone codes supported by GridPulse with friendly country names. Call this when the user’s zone is ambiguous or after a ZONE_NOT_FOUND error.
Inputs: no named parameters.
Get current wind speed (m/s), solar radiation (W/m²), and temperature (°C) for any supported zone. Useful for understanding why electricity prices are high or low (e.g. low wind = less renewable generation = higher prices), or for correlating weather with generation mix.
Inputs: zone (required), forecast.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Add one secure layer between your agents and this server.