MCP Server

Verbind AI-assistenten met PostcodeTools via het Model Context Protocol (MCP). Je AI kan adressen opzoeken, geocoderen en statistieken opvragen.

// ABOUT_MCPWat is MCP?

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten verbinding kunnen maken met externe databronnen en tools. PostcodeTools biedt een MCP-server die AI-assistenten directe toegang geeft tot Nederlandse BAG-adresgegevens — zonder REST API-aanroepen.

Gebruik dezelfde API-sleutel voor zowel de REST API als de MCP-server.

// SETUPSnel instellen

Snel instellenKies je AI-client en volg de onderstaande instructies. Je hebt een API-sleutel nodig — maak er een aan in je dashboard als je er nog geen hebt.

CLI-commando

Voer dit commando uit in je terminal:

claude mcp add --transport http postcodetools https://postcodetools.nl/mcp --header "Authorization: Bearer <api-key>"

Configuratiebestand

Of voeg toe aan je Claude Desktop configuratiebestand:

{
  "mcpServers": {
    "postcodetools": {
      "url": "https://postcodetools.nl/mcp",
      "headers": {
        "Authorization": "Bearer <api-key>"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

// TOOLS9

Deze tools zijn beschikbaar voor je AI-assistent na het verbinden:

TOOLlookup_address

Zoek een Nederlands adres op aan de hand van postcode en huisnummer. Retourneert volledige adresdetails inclusief straat, woonplaats, gemeente en coördinaten.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLsearch_addresses

Vrije-tekst zoeken naar Nederlandse adressen. Zoek op straatnaam, woonplaats, postcode of een combinatie. Retourneert overeenkomende adressen met volledige details.

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Zoekopdracht (straatnaam, woonplaats, postcode of combinatie)
limit	integer	Optioneel	Maximaal aantal resultaten (1-50, standaard: 10)

TOOLget_postcode_info

Haal alle adressen en informatie op voor een Nederlandse postcode. Retourneert straatnaam, woonplaats en alle huisnummers van die postcode.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLget_nearby_postcodes

Vind postcodes binnen een straal van een gegeven adres. Retourneert nabijgelegen 4-cijferige postcodegebieden met afstanden en aantallen adressen.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Optioneel	Nederlandse postcode (6 tekens). Verplicht tenzij lat+lng worden meegegeven.
number	integer	Optioneel	Huisnummer. Verplicht tenzij lat+lng worden meegegeven.
lat	number	Optioneel	Breedtegraad in WGS84 (bijv. 52.3702)
lng	number	Optioneel	Lengtegraad in WGS84 (bijv. 4.8952)
radius	number	Optioneel	Zoekstraal in kilometers (0.1–20, standaard: 5)
precision	integer	Optioneel	Postcode precisie: 4 (gebied) of 6 (volledig), standaard 4

TOOLget_building_info

Haal bouwwerkdetails op via BAG pand-ID. Retourneert bouwjaar, status en alle adressen in het pand.

Parameters

Naam	Type	Verplicht	Beschrijving
pand_id	string	Verplicht	BAG pand-identificatie (16 cijfers)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)
include_addresses	boolean	Optioneel	Voeg de adressen-array toe (standaard: true). Geef false op om dit voor grote panden over te slaan.

TOOLget_city_info

Haal informatie op over een Nederlandse woonplaats op naam. Retourneert woonplaatsdetails, statistieken en gemeentelijke informatie.

Parameters

Naam	Type	Verplicht	Beschrijving
city_name	string	Verplicht	Nederlandse woonplaatsnaam (bijv. Amsterdam, Rotterdam, Utrecht)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLgeocode_address

Converteer een Nederlands adres naar GPS-coördinaten (WGS84 latitude/longitude). Zoek met een vrije-tekstquery.

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Te geocoderen adres (bijv. "Keizersgracht 123 Amsterdam" of "1012AB 123")

TOOLreverse_geocode

Converteer GPS-coördinaten (WGS84) naar het dichtstbijzijnde Nederlandse adres. Zoekt het dichtstbijzijnde adres binnen een straal van 100m.

Parameters

Naam	Type	Verplicht	Beschrijving
lat	number	Optioneel	WGS84 breedtegraad. Verplicht tenzij rd_x+rd_y worden meegegeven.
lng	number	Optioneel	WGS84 lengtegraad. Verplicht tenzij rd_x+rd_y worden meegegeven.
rd_x	number	Optioneel	RD X-coordinaat (alternatief voor lat/lng, bijv. 121000)
rd_y	number	Optioneel	RD Y-coordinaat (alternatief voor lat/lng, bijv. 487000)
radius	number	Optioneel	Zoekradius in meters (standaard: 100, max: 1000)

TOOLget_statistics

Haal BAG-statistieken op voor een woonplaats, gemeente, provincie of postcodegebied. Retourneert aantallen adressen, gebouwen en uitsplitsingen per type.

Parameters

Naam	Type	Verplicht	Beschrijving
area_type	string	Verplicht	Type gebied: city, municipality, province of postcode_area
area_name	string	Verplicht	Naam of code van het gebied (bijv. "Amsterdam", "0363", "Noord-Holland", "1012")

// RESOURCES2

Deze alleen-lezen resources bieden context aan je AI-assistent:

RESOURCEbag://data-version

Huidige BAG-dataversie en laatste update-datum. Toont wanneer de adresdata voor het laatst is geïmporteerd en hoeveel records beschikbaar zijn.

Naamdata-version

MIME Typeapplication/json

RESOURCEbag://statistics/overview

Nationaal BAG-statistiekoverzicht. Toont totalen voor adressen, gebouwen, woonplaatsen en gemeenten, plus uitsplitsingen per type en provincie.

Naamstatistics-overview

MIME Typeapplication/json

// AUTHAuthenticatie

Authenticatie

De MCP-server gebruikt dezelfde API-sleutel als de REST API. Je sleutel moet geldig zijn en niet verlopen of ingetrokken.

MCP-endpointhttps://postcodetools.nl/mcp

ProtocolStreamable HTTP (JSON-RPC 2.0)

AuthenticatieBearer Token