PostalDataPI MCP-Server

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

Tools

Related MCP server: Postio

Einrichtung

1. API-Schlüssel abrufen

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 Postleitzahl 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
}

Links

• PostalDataPI

• API-Referenz

• Dokumentation

• Python SDK

• Node.js SDK