MCP · eerste versie

MCP-server

Laat een AI-host (Claude Code, Claude Desktop, ...) marktprijzen en, met een eigen sleutel, je 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, en die is voorlopig enkel bereikbaar binnen het Tailscale-netwerk van SEF. Op een echte server volgt een openbaar adres; de tools blijven dan gelijk. Een sleutel vraag je via contact.

Installatie (Claude Code)

Vraag een eigen API-sleutel voor de MCP, los van andere integraties, met scope publiek of publiek dossier:lezen.
Zet sleutel en scopes in je 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

Alle tools zijn read-only; elke tool is één GET-route van /api/v1. Een tool verschijnt enkel als zijn scope in SEF_MCP_SCOPES staat. Nog niet: een simulatie of vergelijking 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`	Je aansluitingen, EAN gemaskeerd.
`sef_verbruik`	`dossier:lezen`	Verbruik per maand (standaard 12 maanden) of per dag (hoogstens 31 dagen).
`sef_contractperiodes`	`dossier:lezen`	Je contractperiodes.
`sef_kwh_prijs`	`dossier:lezen`	Je all-in kWh-prijs.
`sef_simulatie_opties, sef_simulaties, sef_simulatie`	`dossier:lezen`	Simulatie-opties, je bewaarde simulaties en één resultaat.
`sef_vergelijkingen, sef_vergelijking`	`dossier:lezen`	Je contractvergelijkingen en één resultaat.

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 je 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 je eigen dossier, en laat de sleutel intrekken zodra je de koppeling niet meer gebruikt. Zie ook Jouw gegevens.