Elecz

Real-time electricity spot prices and contract recommendations for AI agents — covering the Nordics and Germany.

GitHub

⚡ Elecz — Energy Decision Signal for AI Agents

Real-time electricity prices, cheapest hours, and contract recommendations for Nordic markets and Germany — in one API call.

GET https://elecz.com/signal/optimize?zone=FI
GET https://elecz.com/signal/optimize?zone=DE

No API key. No authentication. One line to integrate.

📖 Full documentation: elecz.com/docs

Why Elecz?

Electricity prices change every hour. For AI agents, home automation, EV charging, and batch workloads — when you consume energy matters as much as how much you consume.

Elecz turns complex ENTSO-E market data into a single actionable signal:

"Run now. Electricity is cheap." "Wait until 03:00. Best 3-hour window starts then." "Switch to Tibber. Save 516 NOK/year."

Quickstart — Add to your agent

{
  "mcpServers": {
    "elecz": {
      "url": "https://elecz.com/mcp"
    }
  }
}

Your agent now understands spot prices, cheapest hours, energy state, and contract decisions — for Finland, Sweden, Norway, Denmark, and Germany.

Usage Examples

Example 1 — Contract recommendation

User prompt: "Should I switch my electricity contract? I'm in Finland and use about 3 000 kWh per year."

What happens:

  • Elecz fetches live contracts and ranks top 3 by annual cost for your consumption
  • Returns expected savings vs median market price
  • Provides direct links to switch

Example 2 — EV charging

User prompt: "When is the cheapest time to charge my electric car tonight in Sweden?"

What happens:

  • Elecz returns the best 3-hour consecutive window with average price
  • Includes start/end time ready for scheduling or Home Assistant automation

Example 3 — Business savings

User prompt: "What is the cheapest electricity contract for our office in Germany? We use 12 000 kWh per year."

What happens:

  • Elecz queries DE market with consumption=12000
  • Returns top 3 Arbeitspreis-ranked contracts with annual cost estimates
  • Prices are brutto ct/kWh including MwSt (19%)

Example 4 — Batch job timing

User prompt: "When is the cheapest time to run our nightly data processing jobs in Denmark?"

What happens:

  • Elecz returns cheapest hours for the next 24h
  • Returns optimal window to minimize energy cost for compute workloads

What Elecz delivers

  • Real-time spot price — ENTSO-E day-ahead data, updated hourly
  • Cheapest hours next 24h — sorted list + best 3-hour consecutive window
  • Energy state — cheap / normal / expensive / negative with confidence score
  • One-call optimization — run_now, delay, switch_contract, or monitor
  • Contract recommendation — top 3 providers ranked for your consumption profile
  • Savings in local currency — NOK for Norway, SEK for Sweden, DKK for Denmark, EUR for Finland and Germany
  • MCP-native — one line to connect, works with Claude, ChatGPT, Copilot, LangChain, Home Assistant

Supported Markets

ZoneCountryProvidersNotes
FIFinland8Live
SE, SE1–SE4Sweden8Live
NO, NO1–NO5Norway7Live
DK, DK1–DK2Denmark8Live
DEGermany12Live — see note below

Germany note: Prices are Arbeitspreis brutto ct/kWh including MwSt (19%). Regional Netzentgelt (typically 10–15 ct/kWh) is not included — it is determined by your local grid operator, not your electricity provider, and is the same regardless of which contract you choose.

MCP Tools

ToolDescription
optimizeSingle action: run_now / delay / switch_contract / monitor
spot_priceCurrent spot price for any zone
cheapest_hoursCheapest hours next 24h + best 3h window
best_energy_contractTop 3 contracts ranked for your consumption profile
energy_decision_signalFull signal: price + contracts + state + recommendation

API Endpoints

EndpointDescription
GET /signal/optimize?zone=FIOne-call optimization — recommended
GET /signal?zone=DE&consumption=3500Full energy decision signal
GET /signal/spot?zone=NOCurrent spot price only
GET /signal/cheapest-hours?zone=SE&hours=5Cheapest hours next 24h
GET /healthHealth check

Supported zones: FI · SE · SE1–SE4 · NO · NO1–NO5 · DK · DK1–DK2 · DE

Signal Schema

/signal/optimize — one-call decision

{
  "zone": "NO",
  "action": "switch_contract",
  "is_good_time_to_use_energy": false,
  "energy_state": "expensive",
  "spot_price": { "eur": 10.86, "local": 119.5, "unit": "c/kWh" },
  "switch_recommended": true,
  "expected_savings_eur_year": 46.85,
  "action_link": "https://elecz.com/go/tibber",
  "decision_hint": "switch_recommended",
  "powered_by": "Elecz.com"
}

Action values:

  • run_now — electricity is cheap, act now
  • delay — expensive now, wait for best window
  • switch_contract — savings available by switching provider
  • monitor — normal pricing, no action needed

Home Assistant

sensor:
  - platform: rest
    name: "Electricity Signal"
    resource: "https://elecz.com/signal/optimize?zone=FI"
    value_template: "{{ value_json.action }}"
    scan_interval: 3600

automation:
  - alias: "Charge EV at cheapest hours"
    trigger:
      platform: state
      entity_id: sensor.electricity_signal
      to: "run_now"
    action:
      service: switch.turn_on
      entity_id: switch.ev_charger

Python

import httpx

signal = httpx.get("https://elecz.com/signal/optimize?zone=FI").json()

match signal["action"]:
    case "run_now":
        run_batch_job()
    case "delay":
        schedule_later(signal["spot_price"])
    case "switch_contract":
        notify_team(signal["action_link"])

🇩🇪 Deutsch

Elecz für Deutschland

Elecz vergleicht Stromtarife und liefert Echtzeit-Spotpreise für den deutschen Strommarkt — optimiert für KI-Agenten und Heimautomatisierung.

Unterstützte Anbieter: Tibber · Octopus Energy · E wie Einfach · Yello · E.ON · Vattenfall · EnBW · Naturstrom · LichtBlick · Polarstern · ExtraEnergie · Grünwelt

GET https://elecz.com/signal/optimize?zone=DE&consumption=3500

Frag deinen KI-Assistenten:

  • "Welcher Stromanbieter ist gerade am günstigsten?"
  • "Lohnt sich ein Wechsel zu Tibber?"
  • "Wann ist der Strom heute am billigsten?"
  • "Wann soll ich mein E-Auto laden?"

Hinweis: Preise sind Arbeitspreis brutto in ct/kWh inkl. MwSt (19%). Das regionale Netzentgelt ist nicht enthalten.

Data Sources

  • ENTSO-E — day-ahead spot prices, updated hourly
  • Frankfurter API — EUR → SEK / NOK / DKK conversion
  • Gemini — contract price scraping and normalization
  • Redis — real-time caching
  • Supabase — historical price storage and contract data (EU region)

Privacy

Elecz logs API endpoint, zone, timestamp, and IP prefix (first 3 octets) for monitoring purposes. No personal data is collected or sold. See elecz.com/privacy.

Support

Questions, integrations, or issues: [email protected]

Roadmap

  • ✅ Q1 2026: Nordic markets live (FI, SE, NO, DK)
  • ✅ Q1 2026: Germany live (DE) — 12 providers, ENTSO-E spot, Arbeitspreis ranking
  • 🔜 Q2 2026: United Kingdom (GB)
  • 🔜 Q2–Q3 2026: Rest of Europe — one market at a time
  • 🔜 Q4 2026: Australia, New Zealand, United States

License

MIT

Maintained by Sakari Korkia-Aho / Zemlo AI · elecz.com · elecz.com/docs · Powered by ENTSO-E

Máy chủ liên quan