No install? Use cloud.anythingmcp.com directly.
Sign in, install the OpenPLZ Germany in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
TL;DR
Look up German postal codes, localities, and streets via the OpenPLZ API. Free, no authentication, based on the official Bundesanstalt für Kartographie und Geodäsie (BKG) datasets.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → OpenPLZ Germany klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein
git clone, kein lokaler Server.
OpenPLZ Germany + Gemini
Look up German postal codes, localities, and streets via the OpenPLZ API. Free, no authentication, based on the official Bundesanstalt für Kartographie und Geodäsie (BKG) datasets.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
(none — public API)
Schritt 1 — Zugangsdaten holen
This connector wraps the free OpenPLZ API for German administrative structure lookups. Useful for address validation, form autocomplete, and regional analytics.
Hierarchy: Germany → Federal state (Bundesland) → District (Kreis) → Municipality (Gemeinde) → Locality (Ort) + postal code (PLZ).
No authentication required. OpenPLZ is rate-limited (soft limit ~10 req/s) — for bulk work consider self-hosting.
Common flows:
- Postal code → localities:
openplz_lookup_postalcode - City + street autocomplete:
openplz_search_streets - Full town info by AGS (Amtlicher Gemeindeschlüssel):
openplz_get_locality
Schritt 2 — Adapter installieren
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
Schritt 3 — Connector in Gemini hinzufügen
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (oder %APPDATA%\gemini\settings.json unter Windows). Hinzufügen:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
}
}
}
- Hole deinen MCP API Key aus AnythingMCP → Profil → MCP API Keys → Neuer Key.
- Speichern und
geminineu starten. /mcpin Gemini CLI ausführen —OpenPLZ Germanysollte als verfügbar gelistet sein.- Vertex AI Studio:
https://cloud.anythingmcp.com/mcpimtools-Array der Anfrage mit demselben Bearer-Header übergeben.
Verfügbare Tools
| Tool | What it does |
|---|---|
openplz_lookup_postalcode | Look up all localities associated with a German postal code (PLZ) |
openplz_search_localities | Search localities by name, optionally filtered by federal state |
openplz_search_streets | Search streets within a locality |
openplz_list_federal_states | List all 16 German federal states (Bundesländer) with their Regional Key (RS), name, and seat of government |
openplz_list_districts | List all districts (Kreise/kreisfreie Städte) of a federal state |
FAQ
Unterstützen Gemini 1.5 Pro oder 2.x MCP? Ja — Gemini CLI ≥ 0.4 und die Vertex AI Tools API akzeptieren MCP httpUrl-Connectors mit Bearer-Header.
Nächste Schritte
War dieser Guide hilfreich?