Skip to content

woonstadrotterdam/monumenten

v3.1.0MIT

Vind voor de woningwaardering relevante monumentale statussen van een adres in Nederland. Look up monumental statuses of a Dutch address that are relevant for woningwaardering (the Dutch rent-point system).

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

ToolParametersResult
get_verblijfsobject_idhouse_number, postal_code OR street + house_number + city, optional house_letter, house_suffixStructured matches list of BAG verblijfsobject records
get_monumental_statusbag_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:

  1. Convert the address to a BAG verblijfsobject ID
  2. Check monument registries
  3. 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 number
  • 1234AB 30-2 - With house number suffix
  • 1234AB 30A - With house letter
  • Coolsingel 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:verblijfsobject layer) 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.