PostalDataPI MCP-Server

Name: PostalDataPI MCP Server
Author: PostalDataPI

License: MIT Python 3.10+ PyPI

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

Tools

Tool	Beschreibung
`lookup_postal_code`	Abrufen von Stadt, Bundesland/Region und Abkürzung für eine Postleitzahl (US ZIP, UK Postcode, deutsche PLZ usw.)
`validate_postal_code`	Überprüfen, ob eine Postleitzahl in einem Land existiert
`search_by_city`	Finden aller Postleitzahlen für eine Stadt
`get_postal_code_metadata`	Vollständige Metadaten: Koordinaten, Verwaltungshierarchie, Zeitzone, Höhe 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. Konfiguration mit Claude Code

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

4. Konfiguration mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

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

Verwendung

Sobald die Konfiguration abgeschlossen ist, können Sie Claude ganz natürlich fragen:

"Welche Stadt hat die ZIP-Code 90210?"
"Suche die britische Postleitzahl SW1A"
"Ist 10115 eine gültige deutsche Postleitzahl?"
"Was sind die Postleitzahlen für Beverly Hills, CA?"
"Rufe die Koordinaten für die Postleitzahl 100-0001 in Japan ab"

Claude verwendet automatisch die PostalDataPI-Tools, um zu antworten.

Unterstützte Länder

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

Umfangreiche Metadaten

Über einfache Suchanfragen hinaus liefert das Tool 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öhe (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
}