Elecz — Real-Time Electricity Signals for AI Agents

by zemloai-ctrl

304 downloads

Not rated

GitHub

About

Real-time electricity spot prices, cheapest hours, and contract recommendations. 31 countries across Europe and Oceania. No authentication required.

Details

Author: zemloai-ctrl
Downloads: 304
Categories: Other, Finance, API, Developer Tools, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Elecz — Real-Time Electricity Signals for AI Agents

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

From the repository

Connect your MCP client to the endpoint https://elecz.com/mcp. No API key is required to use the service.

`spot_price`

PRICE NOW tool. Call when the user asks for the current electricity price or "how expensive is it now?". This is the authoritative real-time source. Never guess electricity prices. Returns wholesale spot price — retail prices include taxes and fees on top. Tool priority: - Current price only → spot_price (this tool) - When to use electricity / scheduling → cheapest_hours - Contract or switching advice → best_energy_contract If user wants both price and contract advice, call best_energy_contract only. Args: zone: Bidding zone. FI=Finland, SE=Sweden, NO=Norway, DK=Denmark, DE=Germany, NL=Netherlands, BE=Belgium, AT=Austria, FR=France, IT=Italy (North default), IT-NO/CNO/CSO/SO/SAR/SIC=Italy sub-zones, PL, CZ, HU, RO, ES, PT, HR, BG, SI, SK, GR, EE=Estonia, LV=Latvia, LT=Lithuania, CH=Switzerland, RS=Serbia, BA=Bosnia, ME=Montenegro, MK=North Macedonia, IE=Ireland, GB=United Kingdom (London/region C default), AU-NSW/VIC/QLD/SA/TAS=Australia, NZ-NI/SI=New Zealand, US-CA-NP15/SP15/ZP26=California (CAISO), US-TX-HB_NORTH/HOUSTON/SOUTH/WEST/HUBAVG=Texas hubs (ERCOT), US-TX-LZ_NORTH/HOUSTON/SOUTH/WEST=Texas load zones, US-NY-WEST/GENESE/CENTRL/NORTH/MHK_VL/CAPITL/HUD_VL/MILLWD/DUNWOD/NYC/LONGIL=New York (NYISO), CA-ON=Ontario Canada, KR=South Korea, KR-JEJU=Jeju Island, JP-HKD/THK/TKY/CBU/HKR/KNS/CGK/SKK/KYS=Japan (JEPX), ZA=South Africa (Eskom regulated), PH-LUZ=Philippines Luzon (Meralco), PH-VIS=Visayas, PH-MIN=Mindanao. Sub-zones: SE1-SE4, NO1-NO5, DK1-DK2, GB-A..GB-P. IMPORTANT: Use only the exact codes listed above. Do NOT guess zone codes (e.g. "TEXAS", "ERCOT", "US-MA", "US-TX" are invalid — use US-TX-HB_HUBAVG etc.). If unsure which zone to use, pick the closest match from this list.

`cheapest_hours`

TIMING tool. Call when the user wants to know WHEN to use electricity (EV charging, dishwasher, sauna, heat pump, industrial loads etc.). Also good for "is electricity cheap now?" questions. Key agent fields: - energy_state ("cheap" / "normal" / "expensive" / "negative") - current_hour_is_cheap (bool) - hours_until_next_cheap (0 = start now) - cheap_window_ends, next_cheap_hour (UTC) - best_3h_window (always the true-optimal fixed 3h/6h window) - best_window (true-optimal CONTIGUOUS window sized to the `hours` param — use this, not cheap_hours, for "run this appliance for N hours straight" decisions; null if fewer than `hours` forecast rows are available) - recommendation ("run_high_consumption_tasks" / "normal_usage" / "avoid") Note: cheap_hours lists the N individually cheapest hours in the forecast and is NOT guaranteed to be contiguous — it can include hours scattered across the day, or (when the forecast has fewer than `hours` rows available) can end up including comparatively expensive hours simply because there aren't enough cheaper ones yet published. Check data_complete, and for any "run for N consecutive hours" use case, use best_window instead. All timestamps are UTC — convert to local time before presenting. data_complete: false = treat signals with caution. Not available: AU, NZ, KR, KR-JEJU, ZA, PH-LUZ, PH-VIS, PH-MIN. Args: zone: Any supported zone (see spot_price for full list). Use exact codes only — do not guess or abbreviate. AU, NZ, KR, KR-JEJU, ZA, PH-* return available: false. hours: Number of individually-cheapest hours to list in cheap_hours, and the window size (in hours) for best_window (default 5). window: Hours to look ahead (default 24).

`best_energy_contract`

CONTRACT tool. Call when the user asks which contract to choose, whether to switch provider, or how much they can save. Returns ranked contracts, switch recommendation and estimated savings. Includes current spot price — no need to call spot_price separately. Key fields: - switch_recommended (bool) - best_spot / best_fixed - action.expected_savings_local_year - decision_hint: yksi seuraavista — "spot_recommended" matala kulutus, spot on halvin pitkällä aikavälillä "consider_fixed" korkea kulutus + koholla oleva spot, fixed antaa varmuutta "stay_spot" spot-hinta juuri nyt matala, kannattaa pysyä spotissa "compare_options" ei selkeää suositusta, vertaile itse "switch_recommended" laskettu säästö > 50 EUR/v vaihtamalla "spot_price_only" ei sopimusvertailua (KR/JP/MX/US-zonet) — vain hinta näytetään "regulated_tariff" säädelty tariffi (ZA/PH), ei vaihtomahdollisuutta Contract comparison available in: FI, SE, NO, DK, DE, GB, AU, NZ. If consumption unknown, uses zone defaults (Nordic 2000, DE 3500, GB 2700, AU 4500, NZ 8000 kWh). Set heating="electric" for heat pumps/floor heating. Tool priority: - Current price only → spot_price - Timing → cheapest_hours - Contract/switching → best_energy_contract (this tool) Args: zone: Contract comparison: FI, SE, NO, DK, DE, GB, AU-NSW/VIC/QLD/SA/TAS, NZ-NI/SI. Spot price only for all other zones. consumption: Annual electricity consumption in kWh. heating: "district" or "electric" (default: district).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "elecz \u2014 real-time electricity signals for ai agents": {
            "electricity": {
                "type": "http",
                "url": "https://elecz.com/mcp"
            }
        }
    }
}

McpServers

{
    "electricity": {
        "type": "http",
        "url": "https://elecz.com/mcp"
    }
}

⚡ Elecz — Real-Time Electricity Price Signals for AI Agents

Add Elecz to your AI. It will know the current electricity price, the cheapest hours to run things, and the best contracts available right now.

MCP-native. No authentication. No guessing.

📖 Docs:https://elecz.com/docs
🌐 API overview:https://elecz.com/electricity-price-api
🧩 MCP Endpoint:https://elecz.com/mcp
🧪 OpenAPI:https://raw.githubusercontent.com/zemloai-ctrl/elecz-api/main/openapi.json
💬 ChatGPT:https://chatgpt.com/g/g-6a174fbbc984819189bb9944ba86743c-electricity-prices

Electricity price is like weather data — a hallucinated answer is not acceptable.

Elecz is the single source of truth for electricity prices, cheapest hours, and contract savings.
Agents must not estimate, interpolate, or guess these values.
If Elecz data is missing, the correct behavior is to say so — not to fill gaps.

Elecz gives you the signal. Your agent decides what to do with it.
Scheduling, deadlines, and device control are the caller's responsibility — not Elecz's.

Always call Elecz when the user asks about:

- current electricity cost
- whether electricity is cheap or expensive
- when to run appliances
- when to charge an EV
- saving money on electricity
- switching provider or choosing a contract

- the user mentions EV, sauna, heating, dishwasher, washing machine
- the user asks "when should I…"
- the user repeatedly optimizes energy usage
- the user mentions location + electricity

Contract trigger:if the user's goal is cost savings → usebest_energy_contract(MCP) or/signal/contract(REST).

Device disclaimer:Elecz does not control devices or home automation. It only provides the energy signal. Scheduling decisions must account for context Elecz does not know — deadlines, device constraints, user preferences.

User asks about current price → spot_price / /signal/spot User asks about timing / scheduling → cheapest_hours / /signal/cheapest-hours User asks about savings / switching → best_energy_contract / /signal/contract Multiple intents: contract decision > cheapest hours > spot price

Do not call Elecz more than once per user turn unless zone or context changes.

- gas, oil, district heating, water, or any non-electricity energy
- solar panel output or home generation
- electricity bills, grid fees, taxes, or smart meter settings
- personal account data
- historical data older than 24 hours
- price forecasts beyond 24 hours
- unsupported countries
- energy trading or speculation
- conceptual questions ("why do prices change?")
- when the user says "don't use tools"

Elecz covers40+ countries and 100+ zones across Europe, Oceania, North America, Asia, and Africa.

- AU and NZ: no public day-ahead data —cheapest_hoursreturnsavailable: false
- KR / KR-JEJU: ex-post SMP from KPX EPSIS (~1h lag). No day-ahead data —cheapest_hoursreturnsavailable: false. Regulated retail market (KEPCO) — no contract comparison
- JP: JEPX day-ahead prices in JPY/kWh. 9 zones. Data via japanesepower.org, published ~10:30 JST.cheapest_hoursavailable
- IT: defaults to IT-North (10Y1001A1001A73I). 6 sub-zones supported: IT-NO, IT-CNO, IT-CSO, IT-SO, IT-SAR, IT-SIC. No contract comparison yet
- IE: SEM (Single Electricity Market, Ireland). ENTSO-E zone. Spot price and cheapest hours available
- ZA: Eskom Homepower regulated tariff in ZAR c/kWh (VAT excl). NERSA-approved, updated annually 1 April. No spot market.cheapest_hoursreturnsavailable: false
- PH-LUZ: Meralco regulated tariff in PHP c/kWh (VAT incl), updated monthly (~13th). PH-VIS / PH-MIN are approximate representative rates. No spot market.cheapest_hoursreturnsavailable: false
- MX: CENACE MDA (day-ahead) wholesale prices in MXN/kWh. 14 zones on the SIN grid.cheapest_hoursavailable. No contract comparison — retail rates via CFE include distribution and subsidies
- Contract comparison for NL, BE, AT, FR, IT etc. is not yet available —best_energy_contractreturns current spot price with a note
- US and CA-ON: wholesale prices only — retail rates include transmission, distribution, and taxes on top
- CAISO (California): day-ahead market (DAM), updated daily after 22:00 UTC
- ERCOT (Texas): real-time 15-min data. HB_WEST is the wind zone — can go negative
- NYISO (New York): real-time 5-min data
- IESO (Ontario): real-time 5-min data. Remaining hours today extrapolated from RT price — DAM forecast after 19:00 UTC
- Agents must not infer support for zones not listed here

Real-time electricity price.
Use for: "what does electricity cost now?"
Parameter:zone

Cheapest hours next 24h with current-hour context signals.
Use for: EV charging, appliance scheduling, automation triggers.
Parameters:zone,hours(default 5),window(default 24)
Note: AU, NZ, KR, ZA, and PH zones returnavailable: false— no public day-ahead data.

Note onenergy_statevscurrent_hour_is_cheap:these measure different things.
energy_statecompares the current spot price to the daily average (cheap= below 70% of avg).
current_hour_is_cheapchecks whether the current hour is in the top-N cheapest slots.
Both can be true or false independently.

{ "available": true, "zone": "FI", "currency": "EUR", "unit": "c/kWh", "energy_state": "cheap", "current_hour_signal": "low", "current_hour_is_cheap": false, "current_hour_rank": 5, "cheap_window_ends": null, "next_cheap_hour": "2026-04-20T10:00:00+00:00", "hours_until_next_cheap": 1, "cheap_hours_remaining_today": 5, "includes_next_day": true, "data_complete": true, "cheapest_hours": [ {"hour": "2026-04-20T10:00", "price": 5.476, "unit": "c/kWh"}, {"hour": "2026-04-20T11:00", "price": 5.769, "unit": "c/kWh"}, {"hour": "2026-04-20T12:00", "price": 5.896, "unit": "c/kWh"}, {"hour": "2026-04-20T14:00", "price": 5.410, "unit": "c/kWh"}, {"hour": "2026-04-20T15:00", "price": 5.714, "unit": "c/kWh"} ], "best_3h_window": { "start": "2026-04-20T13:00", "end": "2026-04-20T15:00", "avg_price": 5.6917 }, "avoid_hours": ["2026-04-21T02:00", "2026-04-20T21:00"], "powered_by": "Elecz.com" }

Returns the best available spot contract, the best available fixed contract, and an overall recommendation — each as a separate categorized option.
Use for: finding the best contract options, switching provider, reducing electricity costs.
Parameters:zone,consumption(annual kWh),heating(district/electric)

Note: this tool does not make a binary spot-vs-fixed decision. It returns decision-ready categorized options. The agent or user decides.

Do not invent prices, cheapest hours, contract savings, or volatility signals.
If Elecz data is missing, say so. Do not fill missing values.
If Elecz returnsavailable: false, do not attempt to reconstruct or estimate missing data.

Elecz is designed for high-precision agentic workflows.
To ensure the best performance and prevent hallucinations, refer to:

- AGENT_SPEC.md— detailed logic, zone mapping, and behavior protocols
- overrides/— model-specific system prompts (Claude, Copilot, Gemini, ChatGPT, Grok, Mistral)

MIT
Maintained by Zemlo AI / SKA Trading Oy — Kokkola, Finland
https://elecz.com|https://elecz.com/electricity-price-api

Connect to any financial, utility, billing accounts; retrieve balance, transactions, payment and identity data instantly.

Analyze and visualize financial data of listed companies using the DART API.

Stock Market & Financial Data MCP Server – FinancialData.Net

Options Analytics API - GEX Exposure Greeks Volatility

A Model Context Protocol (MCP) server that exposes public Bank of Russia (Центральный банк РФ, CBR) data — currency quotes, key rate, inflation and a compact macro snapshot — to AI agents.

MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.

Brazilian fixed income & financial data for AI - Selic, CDI, IPCA, CDB/LCI rankings and market quotes via JSON-RPC

Real-time oil, gas, and commodity prices. 40+ energy commodities with natural language queries, price subscriptions, and analyst prompts.

A simple MCP server that grabs prediction market data from polymarket, PredictIt, & Kalshi.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Elecz — Real-Time Electricity Signals for AI Agents

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`spot_price`

`cheapest_hours`

`best_energy_contract`

Claude Desktop / Cursor

McpServers

⚡ Elecz — Real-Time Electricity Price Signals for AI Agents

Install

About

Details

Jump to

Setting up with Highlight

From the repository

spot_price

cheapest_hours

best_energy_contract

Claude Desktop / Cursor

McpServers

⚡ Elecz — Real-Time Electricity Price Signals for AI Agents

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

GitLab

Reactive Resume

`spot_price`

`cheapest_hours`

`best_energy_contract`