Planslurpen

This MCP Server gives you programmatic access to Planslurpen’s AI interpretations of Norwegian zoning plans. You can fetch plan interpretations by municipality and plan ID, look up plans by property, download outputs in JSON or XML, and discover available fields and provisions to tailor your queries.

How to use

You interact with the Planslurpen MCP Server through an MCP client. Start by choosing a target and a format for the data you need. Use the available tools to retrieve plan interpretations, look up properties, and download outputs in your preferred format. For discoverable filters, first fetch the available fields and classifications for a given plan, then apply your selections to refine results.

Key workflows you’ll perform often include retrieving a plan by kommune number and plan ID, fetching a plan by its UUID, and downloading complete plan outputs in JSON or NPAD XML. You can also query for specific plan provisions and look up plans related to a property by its cadastral address.

How to install

Prerequisites: you need Python 3.10 or higher and pip.

Step-by-step commands to set up the MCP server locally:

pip install -r requirements.txt

chmod +x planslurpen_mcp.py

python planslurpen_mcp.py

Configuration and usage notes

You can configure the MCP client (Claude Desktop) to run the Planslurpen MCP Server. Add a config entry that points to the local Python process.

{
  "mcpServers": {
    "planslurpen": {
      "command": "python",
      "args": ["/absolute/path/to/planslurpen_mcp/planslurpen_mcp.py"]
    }
  }
}

Starting and running locally

Run the server directly to start handling MCP requests.

python planslurpen_mcp.py

Security and environment

Keep your environment secure and ensure that only trusted clients can access the MCP endpoints. If you expose the HTTP endpoint, configure network access controls and monitor usage to prevent abuse.

Examples of common tasks

Retrieve a plan interpretation for a given kommune and plan, then download the full JSON output for later analysis.

Notes

This server supports multiple response formats (JSON and Markdown) for convenience. If a response is large, you can apply field filters or classifications to narrow the result set.

Available tools

planslurpen_get_plan

Retrieve AI-interpreted plan data by kommune number and plan ID, with optional version and response format.

planslurpen_get_plan_by_id

Retrieve plan data by its UUID with optional response format.

planslurpen_get_plan_output_json

Download complete plan output in JSON format with optional filtering by field codes and classifications.

planslurpen_get_plan_fields

Get the list of available fields and classifications for a plan to inform filtering and querying.

planslurpen_get_plan_provisions

Download the plan provisions (planbestemmelser) as original legal text for reference.

planslurpen_get_plan_output_xml

Download plan output in NPAD XML format for integration with XML-based workflows.

planslurpen_lookup_property

Look up regulation plans for a specific property by cadastral address (gardsnummer, bruksnummer, festenummer, seksjonsnummer).