mcp-monumenten

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, rijksbeschermd stads-/dorpsgezicht, municipal monument; provinciaal_monument is always null)

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.

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 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
• RCE (Rijksdienst voor het Cultureel Erfgoed) - National monuments registry

License

MIT License - see LICENSE file for details.