AnythingMCP
Back to Guides

OpenPLZ MCP Server — German Postal Codes for AI Agents

Look up German postal codes, localities, streets, and districts via MCP. Free OpenPLZ adapter in AnythingMCP — no API key, BKG official data.

Pre-built adapter available on AnythingMCP Cloud

Skip the self-hosted setup — install this adapter in one click with a free trial. No credit card required.

Install on Cloud — Free Trial

German Postal Code Lookups with AI Agents

OpenPLZ is the free reference API for the German administrative hierarchy — federal states (Bundesländer), districts (Kreise), municipalities (Gemeinden), localities (Orte), postal codes (PLZ), and streets. The data comes from the official Bundesamt für Kartographie und Geodäsie (BKG) and is ideal for address validation, form autocomplete, and regional analytics inside AI workflows.

Quick Setup with Built-in Adapter

OpenPLZ ships with AnythingMCP. The endpoint is free and unauthenticated.

Step 1: Deploy AnythingMCP

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 2: Import the Adapter

Open http://localhost:3000/connectors/store and click Import on OpenPLZ Germany. There are no credentials.

Step 3: Connect to Your AI Agent

{
  "mcpServers": {
    "openplz": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | openplz_lookup_postalcode | All localities for a 5-digit PLZ | | openplz_search_localities | Search localities by name, optional federal-state filter | | openplz_search_streets | Street autocomplete inside a PLZ or locality | | openplz_list_federal_states | The 16 Bundesländer with their Regional Keys | | openplz_list_districts | All Kreise / kreisfreie Städte for a federal state |

AI Agent Use Cases

  • "Which city has the postal code 79098?"
  • "List all streets starting with 'Kaiser-Joseph' in Freiburg"
  • "Validate this delivery address: Bahnhofstraße 12, 80335 München"
  • "Show me the districts of Baden-Württemberg"

Notes

OpenPLZ is rate-limited (~10 req/s soft cap). For bulk processing self-host the OpenPLZ API server — the adapter baseUrl can be overridden after import.

Next Steps