# PostcodeDog MCP Server

**Recherchez et validez des codes postaux depuis vos outils IA**

Connectez Claude, ChatGPT, Codex, Cursor, VS Code et d’autres outils IA à PostcodeDog. Recherchez des codes postaux dans 82 pays, validez-les selon le format national et décomposez des adresses depuis votre assistant.

Endpoint: https://postcode.dog/mcp

Streamable HTTP · Sans inscription · Sans clé API

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

## Ce que vous pouvez faire

Posez la question en langage naturel. Votre assistant choisit le bon outil.

### Rechercher et valider

Trouvez un code postal, une ville ou un lieu dans 82 pays, et vérifiez le code selon le format national avant de l’insérer dans une adresse.

- Qu’est-ce que 90210, et quels autres pays utilisent le même code ?
- 75008 est-il un code postal français valide ?
- Quel code postal correspond à Shibuya, Tokyo ?
- Cherche Munich en Allemagne et donne-moi trois codes.

### Comprendre la couverture

Voyez quels pays sont couverts, quel format ils utilisent et quel est le niveau de précision par pays.

- Quels pays européens couvrez-vous, et avec quels formats ?
- À quoi ressemblent les codes postaux britanniques et canadiens ?
- Combien de codes postaux compte la base ?
- Liste les pays couverts en Asie, avec un code d’exemple pour chacun.

### Travailler avec des adresses

Décomposez une adresse complète en pays, région, ville et code postal, puis vérifiez que le code existe avant de l’utiliser dans un formulaire ou une étiquette.

- Décompose 1 Infinite Loop, Cupertino, CA 95014, USA.
- Quel code postal correspond au 10 Downing Street, Londres ?
- Vérifie ces codes allemands un par un : 10115, 80331, 99999.
- Valide SW1A 1AA et dis-moi quelle zone de Londres il couvre.

## 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

Choisissez votre outil IA. Ni inscription ni clé API — l’URL du serveur suffit.

### Claude Code

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

1. Exécutez la commande dans le terminal.
2. Lancez Claude Code, exécutez /mcp et choisissez postcodedog.

**Pour vérifier :** demandez « Qu’est-ce que 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. Ajoutez le serveur avec la commande, ou le bloc dans ~/.codex/config.toml.
2. Lancez Codex. Aucune étape de connexion — le serveur est public.

**Pour vérifier :** demandez « Quel code postal correspond à 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. Ajoutez le serveur avec la commande, ou le bloc dans les réglages de Gemini CLI.
2. Lancez Gemini CLI et exécutez /mcp pour vérifier que postcodedog est connecté.

**Pour vérifier :** demandez « 75008 est-il un code postal français valide ? »

### 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. Exécutez la commande, ou enregistrez le bloc dans .vscode/mcp.json du workspace.
2. Ouvrez la vue MCP, démarrez postcodedog et posez une question de code postal.

**Pour vérifier :** demandez « Quels sont les formats des codes postaux allemands et japonais ? »

### Cursor

`~/.cursor/mcp.json`

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

1. Fusionnez le bloc dans ~/.cursor/mcp.json, ou dans .cursor/mcp.json du projet.
2. Ouvrez les réglages Cursor → MCP, activez postcodedog et rechargez la fenêtre.

**Pour vérifier :** demandez « Quels pays d’Europe couvrez-vous ? »

### Claude

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

1. Ouvrez Customize → Connectors, puis Add → Custom → Web.
2. Nommez-le PostcodeDog, collez l’URL du serveur et laissez l’authentification vide.
3. Sélectionnez Connect — les outils sont disponibles immédiatement, sans connexion.

**Pour vérifier :** demandez « Décompose 1 Infinite Loop, Cupertino, CA 95014, USA. »

### ChatGPT

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

1. Ouvrez Plugins, sélectionnez +, puis Add custom MCP server.
2. Nommez-le PostcodeDog, collez l’URL et choisissez « No authentication ».
3. Créez le plugin et posez une question de code postal dans une nouvelle conversation.

**Pour vérifier :** demandez « Quel est le code postal de Shibuya, Tokyo ? »

### Amp

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

1. Exécutez la commande.
2. Amp se connecte à la première utilisation ; aucune connexion requise.

**Pour vérifier :** demandez « 99999 existe-t-il en Allemagne ? »

### opencode

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

1. Ajoutez le serveur.
2. Lancez opencode et posez une question de code postal ; aucune authentification.

**Pour vérifier :** demandez « Combien de lieux s’appellent Springfield aux États-Unis ? »

### Other AI tools

Tout outil IA qui prend en charge les serveurs MCP distants via Streamable HTTP peut se connecter avec l’URL. Aucun flux OAuth ni enregistrement de client.

`mcp.json`

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

1. Indiquez l’URL du serveur au client et laissez l’authentification vide.
2. Le serveur est sans état — pas d’en-tête de session, pas de cookies, pas de handshake initialize.

**Pour vérifier :** demandez « Qu’est-ce que 90210 ? »

## Questions

### Qu’est-ce que le serveur MCP PostcodeDog ?

Il relie des outils IA comme Claude, ChatGPT, Cursor et Codex à la base de codes postaux de PostcodeDog via le Model Context Protocol. L’assistant peut chercher des codes, des lieux, valider selon les formats nationaux, décomposer des adresses et indiquer la couverture.

### Faut-il une clé API ?

Non. Le serveur est public et en lecture seule : aucun compte, aucun OAuth, aucun jeton. Coller l’URL suffit.

### Avec quels outils IA fonctionne-t-il ?

Tout outil prenant en charge les serveurs MCP distants via Streamable HTTP. Le guide couvre Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp et opencode.

### Que peut voir mon assistant ?

Uniquement des données postales publiques : environ 1,8 million de lignes GeoNames dans 82 pays, avec noms de lieux, régions, comtés, coordonnées et formats nationaux. Aucun compte, donc aucune donnée personnelle.

### Peut-il modifier quelque chose ?

Non. Les cinq outils sont en lecture seule. Le serveur ne peut rien écrire, soumettre ou modifier, ne pose aucun cookie et ne garde aucune session.

### Les données sont-elles exactes ?

C’est la base postale GeoNames, sous licence CC BY 4.0, actualisée à chaque reconstruction. Les noms de lieux et les coordonnées proviennent d’enregistrements réels. La précision varie selon le pays ; list_countries indique le format et la couverture disponible pour chacun.

### Y a-t-il une limite de débit ?

Pas de clé ni de quota strict, mais PostcodeDog est un petit site : gardez les traitements par lot à un rythme raisonnable. Pour un usage intensif ou commercial, contactez-nous d’abord.

### Comment déconnecter ?

Retirez le serveur des réglages de votre outil IA. Rien n’est stocké de notre côté, il n’y a donc rien d’autre à révoquer.

---

Postal code data © GeoNames contributors, CC BY 4.0.