WozApi voor AI-agents

Koppelen in Claude, Claude Code en Cursor

De MCP-server werkt zonder inloggen: de assistent start zelf een gratis proef. Heb je een WozApi-account, dan werkt de assistent op je eigen credits: in Claude en Claude Code log je in met dat account, in andere clients geef je je API-sleutel mee in de header X-Api-Key.

• Claude: voeg onder Connectors een eigen connector toe met de URL https://woz-api.nl/Api/Mcp. Vraag je naar je saldo, dan vraagt Claude je in te loggen met je WozApi-account.
• Claude Code: zie het commando hieronder. Inloggen met je account doe je met /mcp, of je geeft je sleutel mee.
• Cursor en andere clients: een MCP-server over Streamable HTTP op hetzelfde adres, met je sleutel in de header.

# Claude Code, zonder account
claude mcp add --transport http wozapi https://woz-api.nl/Api/Mcp

# Claude Code, met je eigen API-sleutel
claude mcp add --transport http wozapi https://woz-api.nl/Api/Mcp --header "X-Api-Key: jouw-sleutel"

{
  "mcpServers": {
    "wozapi": { "url": "https://woz-api.nl/Api/Mcp", "headers": { "X-Api-Key": "jouw-sleutel" } }
  }
}

Welke weg

Een lijst of Excel, stap voor stap

1. De assistent leest de adressen uit het bestand en stuurt ze met start_address_list of POST https://woz-api.nl/Api/Lijst, een tekst per regel, in de volgorde van het bestand.
2. De gratis proef loopt: we zoeken alle adressen op en vragen er vijf op. Na een halve minuut tot een minuut staat de lijst op wacht_op_betaling.
3. De assistent laat de proefrijen zien, zegt hoeveel adressen we vonden en wat de hele lijst kost, en geeft de betaallink.
4. De gebruiker betaalt zelf met iDEAL. Daarna vragen we de rest op; bij duizend adressen duurt dat ongeveer een kwartier.
5. Klaar: de assistent haalt de rijen op, en de gebruiker krijgt het bestand met de WOZ-waarden ook per mail.

curl -X POST https://woz-api.nl/Api/Lijst \
  -H "X-Api-Key: $WOZAPI_SLEUTEL" -H "Content-Type: application/json" \
  -d '{"adressen": ["Spuistraat 36C, 1012 TT Amsterdam", "Dorpsweg 4, Swifterbant"]}'

De gratis proef

• Een proefsleutel geeft 5 unieke adressen, met het eigen e-mailadres van de gebruiker 10 in totaal (POST https://woz-api.nl/Api/Proef/Email, of add_trial_email). Hij is 30 dagen geldig.
• Hetzelfde adres opnieuw en een opvraging die op een fout eindigt, kosten niets.
• Een lijst heeft een eigen gratis proef van 5 adressen; die tellen bij een koop mee in de prijs.
• Vraag per gesprek hoogstens een proefsleutel aan, en geen nieuwe als de proef op is.

curl -X POST https://woz-api.nl/Api/Proef -H "Content-Type: application/json" -d '{}'

curl "https://woz-api.nl/Api/Adres?adres=Spuistraat%2036C%2C%201012%20TT%20Amsterdam" \
  -H "X-Api-Key: $PROEFSLEUTEL"

Als de proef op is

• Losse adressen: de gebruiker koopt credits. POST https://woz-api.nl/Api/Opwaarderen (of create_credit_payment_link) geeft een betaallink; de gebruiker betaalt zelf met iDEAL en daarna werkt dezelfde sleutel weer. Credits koop je vooraf, zonder abonnement, en ze vervallen niet. 1 credit is 1 uniek adres; hetzelfde adres binnen 7 dagen opnieuw kost niets.
• Een lijst: de prijs voor de hele lijst staat in prijs.inclBtw, en de gebruiker betaalt op betaling.betaalUrl. Adressen zonder WOZ-waarde betalen we na de verwerking terug.
• Prijzen en staffels: https://woz-api.nl/woz-api-prijs.

Foutcodes en wat een agent doet

Elke fout heeft een vaste code; beslis daarop, niet op de tekst in fout.

Regels voor elke agent

• Verzin nooit een e-mailadres, adres of WOZ-waarde. Noem alleen waarden die WozApi teruggaf.
• Een lege lijst woz betekent dat er voor dat adres geen openbare WOZ-waarde terugkwam, vaak omdat het geen woning is. Zeg dat; schat nooit een waarde.
• Een WOZ-waarde bij een adres is een persoonsgegeven. Gebruik de uitkomst alleen voor de vraag van de gebruiker, alleen voor woningen, en niet om personen te beoordelen.
• Betalen doet de gebruiker zelf, op een pagina van WozApi. Vraag nooit om betaalgegevens.
• wozJaar is het belastingjaar van een waarde; de peildatum is 1 januari van het jaar ervoor. WOZ-jaar 2026 hoort bij peildatum 1 januari 2025.
• Elke fout heeft een vaste code en vaak een volgendeStap. Beslis op de code, niet op de tekst.

De volledige specificatie staat op https://woz-api.nl/openapi.json, de documentatie per endpoint in de Swagger-weergave, en een samenvatting voor taalmodellen in llms.txt.