Elecz Electricity Price Signal API

zemloai-ctrl/elecz-api

Gives your agent real-time electricity prices across 40+ countries and 100+ pricing zones without authentication. Exposes three MCP tools: spot_price for current rates, cheapest_hours for scheduling windows (with signals like energy_state and current_hour_rank), and best_energy_contract for comparing retail plans in Nordic and UK markets. Built around a strict no-hallucination rule: if price data is missing, the agent says so instead of guessing. Covers ENTSO-E markets, CAISO, ERCOT, NYISO, IESO, JEPX, and regulated tariffs in South Africa, Philippines, and Mexico. Useful when your agent needs to answer "should I charge my EV now" or "when is electricity cheapest today" with actual market data instead of estimates.

tools: 3
transport: HTTP
last updated: Jul 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://elecz.com/mcp --name elecz

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http elecz https://elecz.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 3 tools

Verified live against the running server on Nov 6, 2026.

spot_pricePRICE 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: - Cur...1 params

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: - Cur...

Parameters* required

zonestring

Electricity market zone code. Examples: FI, DE, GB, US-NY-NYC, JP-TKY, AU-NSW, ZA, PH-LUZ, MX-CUN. Full list in tool description.default: FI

cheapest_hoursTIMING 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") - cur...3 params

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") - cur...

Parameters* required

hoursinteger

Number of cheapest hours to return. Default: 5. Range: 1–24.default: 5

windowinteger

Hours ahead to look. Default: 24. Range: 1–48.default: 24

zonestring

Electricity market zone code. AU, NZ, KR, ZA, PH-* return available: false. See spot_price for full zone list.default: FI

best_energy_contractCONTRACT tool. Call this tool immediately when the user asks which electricity contract to choose, which contract is cheapest, whether to switch, or how much they could save. Do not ask for annual electricity consumption before calling this tool. If consumption is unknown, omi...3 params

CONTRACT tool. Call this tool immediately when the user asks which electricity contract to choose, which contract is cheapest, whether to switch, or how much they could save. Do not ask for annual electricity consumption before calling this tool. If consumption is unknown, omi...

Parameters* required

consumptionvalue

Annual consumption in kWh. Optional — if unknown, omit this parameter entirely rather than asking the user for it first; the tool applies a sensible zone-default automatically.

heatingstring

Heating type: district (default) or electric (heat pumps, floor heating).default: district

zonestring

Market zone for contract comparison. Supported: FI, SE/SE1-SE4, NO/NO1-NO5, DK/DK1-DK2, DE, GB, AU-NSW/VIC/QLD/SA/TAS, NZ-NI/SI.default: FI

Readme

⚡ 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

🧠 Core Rule

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.

View the full README on GitHub

Details

Repository: github.com/zemloai-ctrl/elecz-api
Transport: HTTP
Registry: MCP registry, active
Prompts: 1
Tools verified: Nov 6, 2026