PostalDataPI MCP Server

offiziell

Globale Postleitzahlsuche, Validierung und Stadtsuche für über 70 Länder. Antwortzeiten unter 10 ms.

GitHub

Dokumentation

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

MCP (Model Context Protocol) Server für PostalDataPI – ermöglicht KI-Agenten das Nachschlagen, Validieren und Suchen von Postleitzahlen in über 240 Ländern und Territorien mit umfangreichen Metadaten: Zeitzone, Verwaltungsregionen, Höhenlage und Koordinaten.

Werkzeuge

WerkzeugBeschreibung
lookup_postal_codeStadt, Bundesland/Region und Abkürzung für eine Postleitzahl abrufen (US ZIP, UK postcode, deutsche PLZ usw.)
validate_postal_codePrüfen, ob eine Postleitzahl in einem Land existiert
search_by_cityAlle Postleitzahlen für eine Stadt finden
get_postal_code_metadataVollständige Metadaten: Koordinaten, Verwaltungshierarchie, Zeitzone, Höhenlage und mehr

Einrichtung

1. API-Schlüssel erhalten

Registrieren Sie sich unter postaldatapi.com/register – 1.000 kostenlose Abfragen, keine Kreditkarte erforderlich.

2. Installation

pip install postaldatapi-mcp

3. Mit Claude Code konfigurieren

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Mit Claude Desktop konfigurieren

Zur Claude Desktop-Konfiguration hinzufügen (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Nutzung

Nach der Konfiguration können Sie Claude ganz natürlich fragen:

  • "Welche Stadt hat die Postleitzahl 90210?"
  • "UK-Postleitzahl SW1A nachschlagen"
  • "Ist 10115 eine gültige deutsche Postleitzahl?"
  • "Wie lauten die Postleitzahlen für Beverly Hills, CA?"
  • "Koordinaten für die Postleitzahl 100-0001 in Japan abrufen"

Claude verwendet automatisch die PostalDataPI-Werkzeuge zur Beantwortung.

Unterstützte Länder

Über 240 Länder und Territorien, darunter USA, UK, Kanada, Deutschland, Frankreich, Japan, Australien, Brasilien, Indien und viele mehr. Die vollständige Liste finden Sie unter postaldatapi.com/countries.

Umfangreiche Metadaten

Über einfache Abfragen hinaus liefert das Werkzeug get_postal_code_metadata bis zu 18 Felder pro Postleitzahl, darunter:

  • Koordinaten (Breitengrad, Längengrad)
  • Zeitzone (z. B. America/Mexico_City, Europe/Berlin)
  • Verwaltungshierarchie (Bundesland/Provinz, Landkreis, Gemeinde)
  • Höhenlage (Meter über dem Meeresspiegel)
  • Ortsname und Länderinformationen

Beispielantwort für Mexiko-Stadt 06000:

{
  "postalCode": "06000",
  "country": "MX",
  "placeName": "Centro",
  "latitude": 19.4364,
  "longitude": -99.1553,
  "timezone": "America/Mexico_City",
  "adminLevel1": "Ciudad de México",
  "adminLevel2": "Cuauhtémoc",
  "elevation": 2239
}

Links