# PostcodeDog MCP Server

**Postleitzahlen in deinen KI-Tools nachschlagen und prüfen**

Verbinde Claude, ChatGPT, Codex, Cursor, VS Code und andere KI-Tools mit PostcodeDog. Schlage Postleitzahlen in 82 Ländern nach, prüfe sie gegen das Landesformat und zerlege Adressen – direkt in deinem Assistenten.

Endpoint: https://postcode.dog/mcp

Streamable HTTP · Keine Anmeldung · Kein API-Key

> Source: https://postcode.dog/mcp/install

## Was du machen kannst

Frag in normaler Sprache. Dein Assistent wählt das passende Werkzeug.

### Nachschlagen und prüfen

Finde Postleitzahl, Stadt oder Ortsname in 82 Ländern und prüfe die PLZ gegen das Landesformat, bevor sie in eine Adresse wandert.

- Was ist 90210, und welche anderen Länder nutzen denselben Code?
- Ist 75008 eine gültige französische Postleitzahl?
- Welche Postleitzahl hat Shibuya in Tokio?
- Schlag München in Deutschland nach und zeig mir drei PLZ.

### Abdeckung verstehen

Sieh, welche Länder abgedeckt sind, welches Format sie nutzen und wie fein die Daten je Land sind.

- Welche europäischen Länder deckst du ab, und welche Formate nutzen sie?
- Wie sehen britische und kanadische Postleitzahlen aus?
- Wie viele Postleitzahlen enthält die Datenbank?
- Liste die abgedeckten Länder in Asien mit je einem Beispielcode.

### Mit Adressen arbeiten

Zerlege eine vollständige Adresse in Land, Region, Stadt und Postleitzahl und prüfe, ob der Code existiert, bevor du ihn in ein Formular oder Label schreibst.

- Zerlege 1 Infinite Loop, Cupertino, CA 95014, USA.
- Welche Postleitzahl gehört zu 10 Downing Street, London?
- Prüfe diese deutschen Codes einzeln: 10115, 80331, 99999.
- Prüfe SW1A 1AA und sag mir, welches Londoner Gebiet es abdeckt.

## Tools

- `lookup_postal_code` — Resolve a postal code, city, or place name; optional country and limit.
- `search_places` — Full-text search over place names, optionally limited to one country.
- `validate_postal_code` — Check a code against the national format and the database.
- `parse_address` — Split a free-form or labelled address into fields and resolve its code.
- `list_countries` — List covered countries with format, example, coverage note, and counts.

## Installation

Wähle dein KI-Tool. Keine Anmeldung, kein API-Key – die Server-URL genügt.

### Claude Code

```bash
claude mcp add --transport http --scope user postcodedog https://postcode.dog/mcp
```

1. Führe den Befehl im Terminal aus.
2. Starte Claude Code, führe /mcp aus und wähle postcodedog.

**Zum Testen:** frag „Was ist 90210?“

### Codex

```bash
codex mcp add postcodedog --url https://postcode.dog/mcp
```

`~/.codex/config.toml`

```toml
[mcp_servers.postcodedog]
url = "https://postcode.dog/mcp"
```

1. Füge den Server per Befehl hinzu oder den Block in ~/.codex/config.toml.
2. Starte Codex. Es gibt keinen Login-Schritt – der Server ist öffentlich.

**Zum Testen:** frag „Welche Postleitzahl hat Beverly Hills 90210?“

### Gemini CLI

```bash
gemini mcp add --transport http --scope user postcodedog https://postcode.dog/mcp
```

`settings.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "httpUrl": "https://postcode.dog/mcp"
    }
  }
}
```

1. Füge den Server per Befehl hinzu oder den Block in die Gemini-CLI-Einstellungen.
2. Starte Gemini CLI und prüfe mit /mcp, ob postcodedog verbunden ist.

**Zum Testen:** frag „Ist 75008 eine gültige französische Postleitzahl?“

### VS Code

```bash
code --add-mcp '{"name":"postcodedog","type":"http","url":"https://postcode.dog/mcp"}'
```

`.vscode/mcp.json`

```json
{
  "servers": {
    "postcodedog": {
      "type": "http",
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. Führe den Befehl aus oder speichere den Block als .vscode/mcp.json im Workspace.
2. Öffne die MCP-Ansicht, starte postcodedog und stelle eine Postleitzahl-Frage.

**Zum Testen:** frag „Welche Formate haben deutsche und japanische Postleitzahlen?“

### Cursor

`~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. Füge den Block in ~/.cursor/mcp.json oder .cursor/mcp.json im Projekt ein.
2. Öffne die Cursor-Einstellungen → MCP, aktiviere postcodedog und lade das Fenster neu.

**Zum Testen:** frag „Welche Länder in Europa deckst du ab?“

### Claude

```text
https://postcode.dog/mcp
```

1. Öffne Customize → Connectors und wähle Add → Custom → Web.
2. Nenne es PostcodeDog, füge die Server-URL ein und lass die Authentifizierung leer.
3. Wähle Connect – die Tools sind sofort da, ohne Anmeldung.

**Zum Testen:** frag „Zerlege 1 Infinite Loop, Cupertino, CA 95014, USA.“

### ChatGPT

```text
https://postcode.dog/mcp
```

1. Öffne Plugins, wähle + und dann Add custom MCP server.
2. Nenne es PostcodeDog, füge die URL ein und wähle „No authentication“.
3. Erstelle das Plugin und stelle in einem neuen Chat eine Postleitzahl-Frage.

**Zum Testen:** frag „Wie lautet die Postleitzahl von Shibuya, Tokio?“

### Amp

```bash
amp mcp add postcodedog https://postcode.dog/mcp
```

1. Führe den Befehl aus.
2. Amp verbindet sich beim ersten Aufruf; kein Login nötig.

**Zum Testen:** frag „Gibt es 99999 in Deutschland?“

### opencode

```bash
opencode mcp add postcodedog --global --url https://postcode.dog/mcp
```

1. Füge den Server hinzu.
2. Starte opencode und stelle eine Postleitzahl-Frage; kein Auth-Schritt.

**Zum Testen:** frag „Wie viele Orte heißen Springfield in den USA?“

### Other AI tools

Jedes KI-Tool, das entfernte MCP-Server über Streamable HTTP unterstützt, kann sich mit der Server-URL verbinden. Es gibt keinen OAuth-Flow und keine Client-Registrierung.

`mcp.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "type": "http",
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. Richte den Client auf die Server-URL und lass die Authentifizierung leer.
2. Der Server ist zustandslos – kein Session-Header, keine Cookies, kein initialize-Handshake.

**Zum Testen:** frag „Was ist 90210?“

## Fragen

### Was ist der PostcodeDog MCP-Server?

Er verbindet KI-Tools wie Claude, ChatGPT, Cursor und Codex über das Model Context Protocol mit der Postleitzahlen-Datenbank von PostcodeDog. Der Assistent kann Codes nachschlagen, Orte suchen, Codes gegen Landesformate prüfen, Adressen zerlegen und die Abdeckung nennen.

### Brauche ich einen API-Key?

Nein. Der Server ist öffentlich und nur lesend: kein Konto, kein OAuth, kein Token. Die URL einzufügen ist die ganze Einrichtung.

### Mit welchen KI-Tools funktioniert es?

Mit jedem Tool, das entfernte MCP-Server über Streamable HTTP unterstützt. Die Anleitung deckt Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp und opencode ab.

### Was kann mein Assistent sehen?

Nur öffentliche Postleitzahlen-Daten: rund 1,8 Millionen GeoNames-Zeilen aus 82 Ländern mit Ortsnamen, Regionen, Landkreisen, Koordinaten und Landesformaten. Es gibt keine Konten und damit keine persönlichen Daten.

### Kann er etwas verändern?

Nein. Alle fünf Werkzeuge sind nur lesend. Der Server kann nichts schreiben, einreichen oder ändern, setzt keine Cookies und speichert keine Session.

### Wie genau sind die Daten?

Es ist die Postleitzahlen-Datenbank von GeoNames unter CC BY 4.0, aktualisiert bei jedem Rebuild. Ortsnamen und Koordinaten stammen aus echten Datensätzen. Die Genauigkeit unterscheidet sich je Land; list_countries zeigt Format und verfügbaren Umfang für jedes Land.

### Gibt es ein Rate-Limit?

Es gibt keinen Key und keine harte Quote, aber PostcodeDog ist eine kleine Seite: Halte Stapeljobs in vernünftigem Tempo. Für hohe Last oder kommerzielle Nutzung frag bitte vorher an.

### Wie trenne ich die Verbindung?

Entferne den Server in den Einstellungen deines KI-Tools. Bei uns wird nichts gespeichert, es gibt also nichts weiter zu widerrufen.

---

Postal code data © GeoNames contributors, CC BY 4.0.