# PostcodeDog MCP Server

**Cerca e verifica codici postali dai tuoi strumenti IA**

Collega Claude, ChatGPT, Codex, Cursor, VS Code e altri strumenti IA a PostcodeDog. Cerca codici postali in 82 paesi, verificali secondo il formato nazionale e scomponi indirizzi dal tuo assistente.

Endpoint: https://postcode.dog/mcp

Streamable HTTP · Nessuna registrazione · Nessuna chiave API

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

## Cosa puoi fare

Chiedi in linguaggio naturale. L’assistente sceglie lo strumento giusto.

### Cercare e verificare

Trova un codice postale, una città o un luogo in 82 paesi e controlla il codice secondo il formato nazionale prima di metterlo in un indirizzo.

- Cos’è 90210 e quali altri paesi usano lo stesso codice?
- 75008 è un codice postale francese valido?
- Qual è il codice postale di Shibuya, Tokyo?
- Cerca Monaco di Baviera in Germania e mostrami tre codici.

### Capire la copertura

Scopri quali paesi sono coperti, che formato usano e qual è la precisione dei dati per paese.

- Quali paesi europei copri e che formati usano?
- Come sono i codici postali britannici e canadesi?
- Quanti codici postali ci sono nel database?
- Elenca i paesi coperti in Asia, con un codice di esempio per ciascuno.

### Lavorare con gli indirizzi

Scomponi un indirizzo completo in paese, regione, città e codice postale, poi verifica che il codice esista prima di usarlo in un modulo o su un’etichetta.

- Scomponi 1 Infinite Loop, Cupertino, CA 95014, USA.
- Quale codice postale corrisponde a 10 Downing Street, Londra?
- Controlla questi codici tedeschi uno per uno: 10115, 80331, 99999.
- Verifica SW1A 1AA e dimmi quale zona di Londra copre.

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

## Installazione

Scegli il tuo strumento IA. Nessuna registrazione e nessuna chiave API: basta l’URL del server.

### Claude Code

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

1. Esegui il comando nel terminale.
2. Avvia Claude Code, esegui /mcp e scegli postcodedog.

**Per provare:** chiedi «Cos’è 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. Aggiungi il server con il comando o il blocco in ~/.codex/config.toml.
2. Avvia Codex. Non c’è alcun passaggio di login: il server è pubblico.

**Per provare:** chiedi «Qual è il codice postale di 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. Aggiungi il server con il comando o il blocco nelle impostazioni di Gemini CLI.
2. Avvia Gemini CLI ed esegui /mcp per verificare che postcodedog sia connesso.

**Per provare:** chiedi «75008 è un codice postale francese valido?»

### 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. Esegui il comando o salva il blocco come .vscode/mcp.json nel workspace.
2. Apri la vista MCP, avvia postcodedog e fai una domanda su un codice postale.

**Per provare:** chiedi «Quali sono i formati dei codici postali tedeschi e giapponesi?»

### Cursor

`~/.cursor/mcp.json`

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

1. Unisci il blocco in ~/.cursor/mcp.json o in .cursor/mcp.json del progetto.
2. Apri le impostazioni di Cursor → MCP, attiva postcodedog e ricarica la finestra.

**Per provare:** chiedi «Quali paesi europei copri?»

### Claude

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

1. Apri Customize → Connectors e scegli Add → Custom → Web.
2. Chiamalo PostcodeDog, incolla l’URL del server e lascia vuota l’autenticazione.
3. Seleziona Connect: gli strumenti sono subito disponibili, senza login.

**Per provare:** chiedi «Scomponi 1 Infinite Loop, Cupertino, CA 95014, USA.»

### ChatGPT

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

1. Apri Plugins, scegli + e poi Add custom MCP server.
2. Chiamalo PostcodeDog, incolla l’URL e scegli «No authentication».
3. Crea il plugin e fai una domanda su un codice postale in una nuova chat.

**Per provare:** chiedi «Qual è il codice postale di Shibuya, Tokyo?»

### Amp

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

1. Esegui il comando.
2. Amp si connette al primo utilizzo; nessun login.

**Per provare:** chiedi «99999 esiste in Germania?»

### opencode

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

1. Aggiungi il server.
2. Avvia opencode e fai una domanda su un codice postale; nessuna autenticazione.

**Per provare:** chiedi «Quanti luoghi si chiamano Springfield negli USA?»

### Other AI tools

Qualsiasi strumento IA che supporti server MCP remoti via Streamable HTTP può connettersi con l’URL. Nessun flusso OAuth e nessuna registrazione del client.

`mcp.json`

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

1. Imposta l’URL del server nel client e lascia l’autenticazione vuota.
2. Il server è senza stato: nessun header di sessione, nessun cookie, nessun handshake initialize.

**Per provare:** chiedi «Cos’è 90210?»

## Domande

### Cos’è il server MCP di PostcodeDog?

Collega strumenti IA come Claude, ChatGPT, Cursor e Codex al database di codici postali di PostcodeDog tramite il Model Context Protocol. L’assistente può cercare codici e luoghi, verificare i formati nazionali, scomporre indirizzi e indicare la copertura.

### Serve una chiave API?

No. Il server è pubblico e in sola lettura: nessun account, nessun OAuth, nessun token. Incollare l’URL è tutta la configurazione.

### Con quali strumenti IA funziona?

Con qualsiasi strumento che supporti server MCP remoti via Streamable HTTP. La guida copre Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp e opencode.

### Cosa può vedere l’assistente?

Solo dati postali pubblici: circa 1,8 milioni di righe GeoNames in 82 paesi, con nomi di luoghi, regioni, contee, coordinate e formati nazionali. Non ci sono account, quindi nessun dato personale.

### Può modificare qualcosa?

No. I cinque strumenti sono in sola lettura. Il server non può scrivere, inviare o modificare dati, non imposta cookie e non conserva sessioni.

### I dati sono accurati?

È il database postale di GeoNames, con licenza CC BY 4.0, aggiornato a ogni rebuild. Nomi e coordinate derivano da record reali. La precisione varia da paese a paese; list_countries indica formato e copertura disponibile per ciascuno.

### C’è un limite di richieste?

Nessuna chiave e nessuna quota rigida, ma PostcodeDog è un sito piccolo: mantieni i lotti a un ritmo ragionevole. Per uso intenso o commerciale, contattaci prima.

### Come disconnetto?

Rimuovi il server dalle impostazioni del tuo strumento IA. Non conserviamo nulla dalla nostra parte, quindi non c’è altro da revocare.

---

Postal code data © GeoNames contributors, CC BY 4.0.