MCP · eerste versie

MCP-server

Laat een AI-host (Claude Code, Claude Desktop, ...) marktprijzen en, met een eigen sleutel, uw eigen dossier lezen. De MCP-server is een dunne client van de externe API: hij rekent niets zelf en schrijft niets.

Bereikbaarheid. De MCP-server praat met de API op https://energieplatform-vlaanderen.be/api/v1 (standaard in .mcp.json). Een sleutel maakt u zelf aan onder Mijn Energieplatform → API-sleutels.

Installatie (Claude Code)

Maak op API-sleutels een MCP/API-sleutel: die leest marktprijzen en uw eigen dossier, meer niet (publiek dossier:lezen). Home Assistant krijgt daar een eigen, aparte sleutel.
Zet sleutel en scopes in uw shell (bv. ~/.bashrc), nooit in een repository.
Installeer de MCP-extra in de SEF-map en start Claude Code daar; .mcp.json registreert de server sef. Controleer met /mcp.

export SEF_MCP_SLEUTEL="sef_..."
export SEF_MCP_SCOPES="publiek dossier:lezen"   # weglaten = enkel publiek

.venv/bin/pip install -e ".[mcp]"

De server draait lokaal bij de AI-host (stdio) en stopt meteen zonder SEF_MCP_SLEUTEL. Sleutels, scopes en limieten zijn die van de API.

Tools

Elke tool is één route van /api/v1. Een tool verschijnt enkel als zijn scope in SEF_MCP_SCOPES staat. Alle tools zijn read-only, behalve sef_start_vergelijking: die vraagt een aparte sleutel met dossier:uitvoeren. Nog niet: een simulatie starten.

Tool	Scope	Wat
`sef_status`	`publiek`	Status van de databronnen en de nachtrun.
`sef_prijsindexen, sef_prijsindex`	`publiek`	Beschikbare prijsindexen en de waarden van één index.
`sef_prijsverloop`	`publiek`	Verloop van de groothandelsprijzen.
`sef_leveranciersoverzicht`	`publiek`	De goedkoopste contracten per contracttype (standaard 3, hoogstens 10).
`sef_netbeheerders_vergelijking`	`publiek`	Nettarieven per netbeheerder.
`sef_nieuws, sef_tariefsignalen`	`publiek`	Goedgekeurd energienieuws en tariefsignalen.
`sef_aansluitingen`	`dossier:lezen`	Uw aansluitingen, EAN gemaskeerd.
`sef_verbruik`	`dossier:lezen`	Verbruik per maand (standaard 12 maanden) of per dag (hoogstens 31 dagen).
`sef_contractperiodes`	`dossier:lezen`	Uw contractperiodes.
`sef_kwh_prijs`	`dossier:lezen`	Uw all-in kWh-prijs.
`sef_simulatie_opties, sef_simulaties, sef_simulatie`	`dossier:lezen`	Simulatie-opties, uw bewaarde simulaties en één resultaat.
`sef_vergelijkingen, sef_vergelijking`	`dossier:lezen`	Uw contractvergelijkingen en één resultaat (de goedkoopste per contracttype, met uw huidige contract).
`sef_start_vergelijking`	`dossier:uitvoeren`	Een contractvergelijking starten op uw meting: het laatste jaar of een gekozen periode (hoogstens 366 dagen).

Gedrag

Bedragen en energie blijven decimale strings, zoals in de API.
Onbekende argumenten worden geweigerd, zonder API-aanroep.
Een API-fout wordt een toolfout met status, code, titel, Retry-After en correlatie-ID; nooit de URL of de sleutel.
Elke aanroep telt mee voor de 60 aanvragen per minuut van de sleutel.

Privacy

Met dossier:lezen gaan uw verbruikstotalen, contractperiodes en simulatieresultaten naar de AI-provider van de host. EAN-nummers blijven gemaskeerd en kwartierwaarden zijn niet bereikbaar.

Gebruik die scope enkel voor uw eigen dossier, en wis de sleutel op API-sleutels zodra u de koppeling niet meer gebruikt. Zie ook Uw gegevens.