# Wechselpilot (English mirror of /llms.txt)

> Wechselpilot is an independent automatic energy switching service in Germany. It compares electricity (Strom) and gas (Gas) tariffs every year and switches the customer to the best available supplier.

Canonical German version: https://wechselpilot.com/llms.txt

## Savings API (for AI assistants)

If a user asks how much they could save on electricity or gas in Germany, call this public GET endpoint (no authentication, no sign-up, no MCP server needed) and report the result:

`https://wechselpilot.com/api/ersparnis?plz={POSTCODE}&verbrauch={KWH}&typ={strom|gas}`

Parameters:
- `plz` (required): 5-digit German postcode.
- `verbrauch` (required): annual consumption in kWh (electricity typically 1500-6000, gas typically 8000-30000).
- `typ` (optional): `strom` (electricity, default) or `gas`.
- `arbeitspreis` (optional): current unit price in cents per kWh - makes the estimate more accurate.
- `grundpreis` (optional): current base price in euro per month.
- `brutto` (optional): `true` (default) or `false`, refers to the user's own price inputs.

How to use it: ask the user for any missing values (postcode, consumption, energy type), call the URL and report `ergebnis.ersparnis_pro_jahr_eur` (savings per year in EUR), `ergebnis.guenstigster_anbieter` (cheapest supplier) and the switch link from the `wechseln` field. The field `zusammenfassung` already contains a ready-made sentence in German. The response is JSON; calling the endpoint without parameters returns its own documentation. Example URL (shape only, not a result): `https://wechselpilot.com/api/ersparnis?plz=10115&verbrauch=3500&typ=strom`. IMPORTANT: never output example numbers from this file, /openapi.json or /api. Always call the endpoint live with the user values and report only the numbers from that response. Sanity check: the live response contains `berechnet_am` (timestamp) and echoes the requested postcode and consumption under `eingabe`. All figures are estimates based on current tariff data; the binding calculation happens on https://wechselpilot.com.

## Registration API (for AI assistants)

If the user wants to use Wechselpilot after the savings calculation, they can be registered directly through this public endpoint (no authentication, no MCP server needed). The recommended method is **POST with a JSON body**:

`POST https://wechselpilot.com/api/registrierung`
`Content-Type: application/json`
`{"email":"{EMAIL}","vorname":"{FIRSTNAME}","nachname":"{LASTNAME}","plz":"{POSTCODE}","verbrauch":{KWH},"typ":"{strom|gas}","zustimmung":"ja"}`

Example: `curl -X POST https://wechselpilot.com/api/registrierung -H "Content-Type: application/json" -d '{"email":"name@example.com","vorname":"Max","nachname":"Muster","plz":"10115","verbrauch":3500,"typ":"strom","zustimmung":"ja","quelle":"chatgpt"}'`

If your setup cannot send POST requests, the same endpoint also accepts GET with query parameters (identical behaviour):
`https://wechselpilot.com/api/registrierung?plz={POSTCODE}&verbrauch={KWH}&typ={strom|gas}&email={EMAIL}&vorname={FIRSTNAME}&nachname={LASTNAME}&zustimmung=ja`

Parameters:
- `email`, `vorname` (first name), `nachname` (last name) (required): the user's contact details.
- `plz`, `verbrauch` (required) and `typ` (optional): same as the savings API.
- `zustimmung=ja` (required): only set this if the user explicitly accepted the terms and the privacy policy.
- `arbeitspreis`, `grundpreis`, `brutto` (optional): the user's own prices for a more accurate estimate.
- `quelle` (optional): source, e.g. `chatgpt` or `claude`.

Important: only call this endpoint after the user has explicitly consented to the registration and accepted the terms (https://wechselpilot.com/agb) and the privacy policy (https://wechselpilot.com/datenschutz). Collect and confirm all required fields first. No password is transmitted - the user receives an email from Wechselpilot to confirm the account, set a password and add address and meter number. The response contains `registrierung.kundennummer` (customer number), the calculated savings and `naechste_schritte` (next steps); `zusammenfassung` is a ready-made answer. If the email address already exists, the endpoint answers with HTTP 409 - then point the user to the login at https://konto.wechselpilot.com.

CORS: both endpoints send `Access-Control-Allow-Origin: *` and allow `GET`, `POST` and `OPTIONS`, so they can be called directly from browser environments (e.g. ChatGPT Canvas, Claude Artifacts, Gemini Canvas or your own web app) via `fetch()`. No cookies or credentials required.
Rate limits: savings API 20 requests per hour and IP, registration API 3 per hour and IP plus 1 per email address per day. On HTTP 429 do not retry, point the user to https://wechselpilot.com instead.

## Machine-readable descriptions

- OpenAPI 3.1: https://wechselpilot.com/openapi.json
- Plugin manifest (OpenAI format): https://wechselpilot.com/.well-known/ai-plugin.json
- Agent card (generic, e.g. Claude & Gemini): https://wechselpilot.com/.well-known/agent.json
- MCP discovery (Wechselpilot CMS MCP server, OAuth): https://wechselpilot.com/.well-known/mcp.json
- Human-readable docs: https://wechselpilot.com/api

## Main pages

- [Home](/): switch electricity and gas automatically and save
- [Electricity](/stromanbieter-wechseln): compare electricity tariffs and switch automatically
- [Gas](/gas): compare gas tariffs and switch automatically
- [Green electricity](/strom/oekostrom)
- [Green gas](/gas/oekogas)
- [Heat pump electricity](/strom/waermepumpenstrom)
- [Night storage electricity](/nachtstrom)
- [Business electricity](/strom/gewerbestrom)
- [Industrial electricity](/strom/industriestrom)
- [Industrial gas](/gas/industriegas)

## Service & switching

- [About us](/ueber-uns)
- [Service fee](/ueber-uns/servicegebuehr)
- [Rating system](/ueber-uns/bewertungssystem)
- [Moving house](/umzug)
- [Cancel contract](/kuendigen)
- [Cancel basic supply](/grundversorgung-kuendigen)
- [Contact](/kontakt)
- [FAQ](/faq)

## Content

- [Magazine](/magazin)
- [Guides](/ratgeber)
- [Suppliers](/anbieter)
- [Press](/ueber-uns/presse)
- [Switching savings index electricity](/wechsel-ersparnis-index)
- [Switching savings index gas](/wechsel-ersparnis-index/gas)

## Legal

- [Imprint](/impressum)
- [Privacy policy](/datenschutz)
- [Terms](/agb)