# Wozapi

> WOZ values (official Dutch property valuations) for Dutch addresses, one lookup or a whole list.

- name: nl.woz-api/wozapi
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 90/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/nl.woz-api%2Fwozapi
- tools: https://api.protogrid.dev/v1/servers/nl.woz-api%2Fwozapi/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "wozapi": {
      "type": "http",
      "url": "https://woz-api.nl/Api/Mcp",
      "headers": {
        "X-Api-Key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-5d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 90/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 9 of 9 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,648 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 7 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 1,648 tokens to load them all
- tool set hash: 855e3ed2bb95349d6693521f71d3381e
- tools last changed: 2026-10-15T19:50:41.328Z
- badge: [![protogrid quality](https://protogrid.dev/badge/nl.woz-api/wozapi.svg)](https://protogrid.dev/servers/nl.woz-api/wozapi)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-15 `start_trial` changed (description)
  - before: 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.
  - after: 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.
- 2026-10-15 `lookup_woz_value` changed (description, inputSchema)
  - before: 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.
  - after: 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.
- 2026-10-15 `get_prices` changed (description)
  - before: 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.
  - after: 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.
- 2026-10-15 `start_address_list` changed (inputSchema)
- 2026-10-15 `get_account_balance` changed (description)
  - before: 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.
  - after: 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.
- 2026-10-15 `add_trial_email` changed (description, inputSchema)
  - before: 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.
  - after: 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.
- 2026-10-15 `create_credit_payment_link` changed (description, inputSchema)
  - before: 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.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/nl.woz-api%2Fwozapi/changes

## Remotes

- https://woz-api.nl/Api/Mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (9)

- `add_trial_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.
- `create_credit_payment_link`: 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.
- `create_list_payment_link`: 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.
- `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.
- `get_address_list`: 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.
- `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.
- `lookup_woz_value`: 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.
- `start_address_list`: 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.
- `start_trial`: 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.
