Monumenten MCP Server ποΈ
A Model Context Protocol (MCP) server that enables AI assistants to check monumental status of Dutch addresses relevant for woningwaardering (rent-point system). Connects to the Dutch BAG (Basisadministratie Adressen en Gebouwen) data and Ministry of Cultural Heritage (Rijksdienst voor het Cultureel Erfgoed) to identify national monuments, nationally protected cityscapes, and municipal monuments.
Built on the MCP Python SDK v2 (MCPServer). Tools return structured results; validation and lookup failures raise ToolError (is_error=true) so the model can retry.
Requires Python 3.11+.
Note
This MCP server is based on the monumenten package. For more information, see the monumenten package.
What This Does
This MCP server allows AI assistants to:
- π Find verblijfsobject IDs - Convert Dutch addresses to BAG identifiers (
verblijfsobject_id) - ποΈ Check monumental status - Determine if a property is protected as cultural heritage
- π Support flexible address input - Search by postal code + house number or full address
- π Handle address variations - Support house letters and suffixes (30A, 30-2, etc.)
Available Tools
| Tool | Parameters | Result |
|---|---|---|
get_verblijfsobject_id | house_number, postal_code OR street + house_number + city, optional house_letter, house_suffix | Structured matches list of BAG verblijfsobject records |
get_monumental_status | bag_verblijfsobject_id (16 digits) | Structured monumental status (provincie, rijksmonument, voorbescherming, rijksbeschermd stads-/dorpsgezicht, municipal and provincial monument; null = not determined) |
Quick Setup
Add to your AI assistant's MCP configuration:
{
"mcpServers": {
"monumenten": {
"command": "uvx",
"args": ["mcp-monumenten"]
}
}
}
For local development:
{
"mcpServers": {
"monumenten": {
"command": "uv",
"args": ["run", "--project", "/path/to/mcp-monumenten", "mcp-monumenten"]
}
}
}
Streamable HTTP (mcp-monumenten --http) listens on http://127.0.0.1:8000/mcp by default.
Claude Code plugin
Requires uv. Then:
/plugin marketplace add woonstadrotterdam/mcp-monumenten
/plugin install monumenten@woonstad-rotterdam
Or add the server directly: claude mcp add monumenten -- uvx mcp-monumenten.
OpenAI Codex plugin
Requires uv. Then:
codex plugin marketplace add woonstadrotterdam/mcp-monumenten
codex plugin add monumenten@woonstad-rotterdam
In the ChatGPT desktop app you can instead install Monumenten from the Woonstad Rotterdam marketplace in the Plugins Directory.
Gemini CLI extension
Requires uv. Run outside an interactive session, then restart Gemini CLI:
gemini extensions install https://github.com/woonstadrotterdam/mcp-monumenten
Update later with gemini extensions update monumenten.
GitHub Copilot CLI plugin
Requires uv. Then:
copilot plugin marketplace add woonstadrotterdam/mcp-monumenten
copilot plugin install monumenten@woonstad-rotterdam
The repo ships one portable Agent Plugins manifest (plugin.json + mcp.json) that Codex and Copilot CLI both read. Gemini CLI reads gemini-extension.json; every client picks up the same skills/monumenten skill.
Usage Examples
Finding Monumental Status
"What is the monumental status of Coolsingel 30, Rotterdam?"
The AI will:
- Convert the address to a BAG verblijfsobject ID
- Check monument registries
- Report rijksmonument status, rijksbeschermd stads-/dorpsgezicht, or municipal or provincial monument designation
"Is 1234AB 30-2 a rijksmonument?"
The AI can handle:
- Postal code + house number format
- House number suffixes (30-2, 30A, etc.)
- Direct verblijfsobject ID lookups
Address Flexibility
The server handles Dutch address formats:
1234AB 30- Basic postal code + house number1234AB 30-2- With house number suffix1234AB 30A- With house letterCoolsingel 30, Rotterdam- Full street address
Installation
Via uvx (Recommended)
uvx mcp-monumenten
Local Development
git clone https://github.com/woonstadrotterdam/mcp-monumenten.git
cd mcp-monumenten
uv sync
uv run --project . mcp-monumenten
Data Sources
- Kadaster - BAG (Basisadministratie Adressen en Gebouwen) - Official Dutch address registry, queried through the PDOK BAG WFS (
bag:verblijfsobjectlayer) to turn an address into a verblijfsobject ID. The layer only has hoofdadressen of verblijfsobjecten, so ligplaatsen and standplaatsen return no match. - PDOK Locatieserver - Current provincie of a verblijfsobject. When the WFS finds no hoofdadres, it also finds nevenadressen (returned with
nevenadres: true) and lists the huisletter and toevoeging variants that exist for the house number in the error - RCE (Rijksdienst voor het Cultureel Erfgoed) - National monuments registry
- Provinces Noord-Holland and Drenthe - Provincial monuments, from their map services
When a source does not answer
A status that could not be determined is null, never false. If a source (RCE, BAG or BRK-PB) does not answer at all, get_monumental_status returns a tool error naming the source. If only a provincial service is down, the call succeeds and provinciaal_monument is null for addresses in Noord-Holland and Drenthe.
License
MIT License - see LICENSE file for details.