WozApi
WOZ values (official Dutch property valuations) for Dutch addresses, one lookup or a whole list.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"wozapi": {
"url": "https://woz-api.nl/Api/Mcp"
}
}
}Remote endpoints
https://woz-api.nl/Api/Mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟡create_credit_payment_link(credits, trial_code)
Returns a page where the user buys WozApi credits for single lookups and pays with iDEAL. This tool moves no money. Works when the user is signed in to WozApi, with the connected API key, or with a trial_code that has the user's e-mail address.
Input Schema
{
"type": "object",
"properties": {
"credits": {
"description": "Optional. Number of credits; leave empty for the suggested amount.",
"type": [
"integer",
"null"
],
"default": null
},
"trial_code": {
"description": "The trial_code from start_trial. Leave empty when the user is signed in to WozApi or the connection has a WozApi API key.",
"type": [
"string",
"null"
],
"default": null
}
}
}🟡add_trial_email(trial_code, email)
Adds the user's own e-mail address to a trial. The trial grows to 10 addresses in total and the user gets a WozApi account without a password (they log in with a code sent by e-mail). Only use an address the user typed.
Input Schema
{
"type": "object",
"properties": {
"trial_code": {
"description": "The trial_code from start_trial. Leave empty when the user is signed in to WozApi or the connection has a WozApi API key.",
"type": "string"
},
"email": {
"description": "Optional. The user's own e-mail address, only if the user typed it. Never invent one.",
"type": "string"
}
},
"required": [
"trial_code",
"email"
]
}🟢get_account_balance
Returns the remaining credits of the user's own WozApi account. Needs the user to be signed in to WozApi, or a WozApi API key on the connection; when neither is there, the client asks the user to sign in first. Read-only and free.
Input Schema
{
"type": "object",
"properties": {}
}🟢get_address_list(list_token, wait_seconds, offset)
Returns the status of an address list: trial rows, number of addresses found, price, payment link, progress, and after payment the result rows (at most 50 per call; use offset for more) and a download link for the Excel file. Can wait up to 20 seconds for the trial or the processing to finish.
Input Schema
{
"type": "object",
"properties": {
"list_token": {
"description": "The list_token from start_address_list.",
"type": "string"
},
"wait_seconds": {
"description": "Optional. Seconds to wait for a change while the trial or the processing runs, 0 to 20.",
"type": "integer",
"default": 0
},
"offset": {
"description": "Optional. First result row to return after delivery, starting at 0.",
"type": "integer",
"default": 0
}
},
"required": [
"list_token"
]
}🟢start_address_list(addresses, place, email, trial_code)
Starts WOZ lookups for a whole list of Dutch addresses, for example from a spreadsheet the user shared. Runs a free trial on 5 addresses, then gives the price of the full list and a payment page for the user. Returns a list_token for get_address_list. Sending the same list again within an hour returns the same list.
Input Schema
{
"type": "object",
"properties": {
"addresses": {
"description": "The addresses, one string per row in the original order, each with house number and postcode or city.",
"type": "array",
"items": {
"type": "string"
}
},
"place": {
"description": "Optional. The city for all addresses that have no postcode or city.",
"type": [
"string",
"null"
],
"default": null
},
"email": {
"description": "Optional. The user's own e-mail address for delivery of the file and the invoice, only if the user typed it.",
"type": [
"string",
"null"
],
"default": null
},
"trial_code": {
"description": "The trial_code from start_trial. Leave empty when the user is signed in to WozApi or the connection has a WozApi API key.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"addresses"
]
}🟢get_prices
Returns WozApi prices: credits for single lookups by quantity, the price of an address list by size, and the trial terms. Read-only and free.
Input Schema
{
"type": "object",
"properties": {}
}⚪lookup_woz_value(address, trial_code)
Returns the WOZ values of one Dutch address for all available years, with the address as matched. Costs one trial address or one credit per unique address; the same address again within 7 days, an answer without WOZ values and an error cost nothing. For questions about properties, not to assess or profile people. Needs a trial_code unless the user is signed in to WozApi or the connection has a WozApi API key.
Input Schema
{
"type": "object",
"properties": {
"address": {
"description": "A full Dutch address with house number and postcode or city, for example 'Spuistraat 36C, 1012 TT Amsterdam'.",
"type": "string"
},
"trial_code": {
"description": "The trial_code from start_trial. Leave empty when the user is signed in to WozApi or the connection has a WozApi API key.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"address"
]
}🟡create_list_payment_link(list_token, email)
Returns the page where the user reviews the trial and the price of the list and pays with iDEAL. This tool moves no money: payment only happens when the user pays on that page. Optionally stores the user's own e-mail address for delivery of the file and the invoice.
Input Schema
{
"type": "object",
"properties": {
"list_token": {
"description": "The list_token from start_address_list.",
"type": "string"
},
"email": {
"description": "Optional. The user's own e-mail address for delivery of the file and the invoice, only if the user typed it.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"list_token"
]
}⚪start_trial(email)
Starts a free WozApi trial without an account and returns a trial_code. The trial covers WOZ value lookups for 5 unique Dutch addresses, or 10 when the user's own e-mail address is given. Pass the trial_code to lookup_woz_value and start_address_list. Call it once per conversation, and not when the user is signed in to WozApi or the connection already has a WozApi API key.
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "Optional. The user's own e-mail address, only if the user typed it. Never invent one.",
"type": [
"string",
"null"
],
"default": null
}
}
}Community
Evidence