Metadata-Version: 2.4
Name: mcp-monumenten
Version: 3.0.0
Summary: MCP server voor monumentale statussen in Nederland.
Author-email: Tomer Gabay <tomer.gabay@woonstadrotterdam.nl>, Ben Verhees <ben.verhees@woonstadrotterdam.nl>
License-Expression: MIT
Keywords: mcp,monumenten,rijksmonumenten,kadaster,gemeente
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.10.10
Requires-Dist: dotenv>=0.9.9
Requires-Dist: mcp[cli]<3,>=2
Requires-Dist: monumenten>=2.0.0
Dynamic: license-file

# Monumenten MCP Server 🏛️

A Model Context Protocol (MCP) server that enables AI assistants to check monumental status of Dutch addresses. Connects to the Dutch BAG (Basisadministratie Adressen en Gebouwen) data and Ministry of Cultural Heritage (Rijksdienst voor het Cultureel Erfgoed) to identify national monuments, protected cityscapes, and municipal monuments.

<!-- mcp-name: io.github.woonstadrotterdam/monumenten -->

Built on the [MCP Python SDK](https://py.sdk.modelcontextprotocol.io/) 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](https://github.com/woonstadrotterdam/monumenten) package. For more information, see the [monumenten](https://github.com/woonstadrotterdam/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 (rijksmonument, protected cityscape, municipal monument) |

Prefer `postal_code` + `house_number` when both are available. For a rijksmonument, always cite the source (RCE = Rijksdienst voor het Cultureel Erfgoed).

## Quick Setup

Add to your AI assistant's MCP configuration:

```json
{
  "mcpServers": {
    "monumenten": {
      "command": "uvx",
      "args": ["mcp-monumenten"]
    }
  }
}
```

For local development:

```json
{
  "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.

## 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, protected cityscape inclusion, 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)

```bash
uvx mcp-monumenten
```

### Local Development

```bash
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)](https://www.kadaster.nl/)** - Official Dutch address registry
- **[RCE (Rijksdienst voor het Cultureel Erfgoed)](https://www.rijksoverheid.nl/ministeries/cultureel-erfgoed/rijksdienst-voor-het-cultureel-erfgoed)** - National monuments registry

## License

MIT License - see [LICENSE](LICENSE) file for details.
