# PostcodeDog MCP Server

**Cari dan validasi kode pos dari alat AI Anda**

Hubungkan Claude, ChatGPT, Codex, Cursor, VS Code, dan alat AI lain ke PostcodeDog. Cari kode pos di 82 negara, validasi dengan format nasional, dan uraikan alamat langsung dari asisten Anda.

Endpoint: https://postcode.dog/mcp

Streamable HTTP · Tanpa pendaftaran · Tanpa API key

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

## Yang bisa dilakukan

Tanya dengan bahasa biasa. Asisten memilih alat yang tepat.

### Cari dan validasi

Temukan kode pos, kota, atau nama tempat di 82 negara, dan periksa kode itu dengan format nasional sebelum dimasukkan ke alamat.

- Apa itu 90210, dan negara mana lagi yang memakai kode yang sama?
- Apakah 75008 kode pos Prancis yang valid?
- Berapa kode pos Shibuya, Tokyo?
- Cari Munich di Jerman dan tunjukkan tiga kode pos.

### Cakupan data

Lihat negara mana yang tercakup, format apa yang dipakai, dan seberapa presisi datanya per negara.

- Negara Eropa mana yang Anda cakup, dan formatnya apa?
- Seperti apa format kode pos Inggris dan Kanada?
- Ada berapa kode pos di basis data?
- Sebutkan negara yang tercakup di Asia, dengan satu contoh kode untuk masing-masing.

### Mengolah alamat

Uraikan alamat lengkap menjadi negara, wilayah, kota, dan kode pos, lalu pastikan kodenya benar-benar ada sebelum dipakai di formulir atau label kiriman.

- Uraikan 1 Infinite Loop, Cupertino, CA 95014, USA.
- Kode pos apa untuk 10 Downing Street, London?
- Periksa kode Jerman ini satu per satu: 10115, 80331, 99999.
- Validasi SW1A 1AA dan sebutkan area London mana yang dicakupnya.

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

## Pemasangan

Pilih alat AI Anda. Tanpa login dan tanpa API key — URL server sudah cukup.

### Claude Code

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

1. Jalankan perintah di terminal.
2. Buka Claude Code, jalankan /mcp, dan pilih postcodedog.

**Coba periksa:** tanya “Apa itu 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. Tambahkan server dengan perintah, atau bloknya ke ~/.codex/config.toml.
2. Buka Codex. Tidak ada langkah login — servernya publik.

**Coba periksa:** tanya “Kode pos 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. Tambahkan server dengan perintah, atau bloknya ke pengaturan Gemini CLI.
2. Buka Gemini CLI dan jalankan /mcp untuk memastikan postcodedog tersambung.

**Coba periksa:** tanya “Apakah 75008 kode pos Prancis yang valid?”

### 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. Jalankan perintah, atau simpan bloknya sebagai .vscode/mcp.json di workspace.
2. Buka tampilan MCP, jalankan postcodedog, lalu ajukan pertanyaan kode pos.

**Coba periksa:** tanya “Apa format kode pos Jerman dan Jepang?”

### Cursor

`~/.cursor/mcp.json`

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

1. Gabungkan bloknya ke ~/.cursor/mcp.json, atau .cursor/mcp.json di proyek.
2. Buka pengaturan Cursor → MCP, aktifkan postcodedog, lalu muat ulang jendela.

**Coba periksa:** tanya “Negara Eropa mana yang Anda cakup?”

### Claude

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

1. Buka Customize → Connectors, lalu Add → Custom → Web.
2. Beri nama PostcodeDog, tempel URL server, dan biarkan autentikasi kosong.
3. Pilih Connect — alatnya langsung tersedia, tanpa login.

**Coba periksa:** tanya “Uraikan 1 Infinite Loop, Cupertino, CA 95014, USA.”

### ChatGPT

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

1. Buka Plugins, pilih +, lalu Add custom MCP server.
2. Beri nama PostcodeDog, tempel URL, dan pilih “No authentication”.
3. Buat plugin-nya dan ajukan pertanyaan kode pos di chat baru.

**Coba periksa:** tanya “Berapa kode pos Shibuya, Tokyo?”

### Amp

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

1. Jalankan perintah.
2. Amp tersambung saat pertama dipakai; tanpa login.

**Coba periksa:** tanya “Apakah 99999 ada di Jerman?”

### opencode

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

1. Tambahkan server.
2. Buka opencode dan ajukan pertanyaan kode pos; tanpa autentikasi.

**Coba periksa:** tanya “Ada berapa tempat bernama Springfield di AS?”

### Other AI tools

Alat AI apa pun yang mendukung server MCP jarak jauh lewat Streamable HTTP bisa terhubung dengan URL ini. Tidak ada alur OAuth dan tidak perlu registrasi klien.

`mcp.json`

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

1. Arahkan klien ke URL server dan biarkan autentikasi kosong.
2. Servernya stateless — tanpa header sesi, tanpa cookie, tanpa handshake initialize.

**Coba periksa:** tanya “Apa itu 90210?”

## Pertanyaan

### Apa itu server MCP PostcodeDog?

Server ini menghubungkan alat AI seperti Claude, ChatGPT, Cursor, dan Codex ke basis data kode pos PostcodeDog lewat Model Context Protocol. Asisten bisa mencari kode dan tempat, memvalidasi format nasional, menguraikan alamat, dan melaporkan cakupan.

### Apakah perlu API key?

Tidak. Servernya publik dan hanya baca: tanpa akun, tanpa OAuth, tanpa token. Menempel URL sudah cukup.

### Kompatibel dengan alat AI apa?

Semua alat yang mendukung server MCP jarak jauh lewat Streamable HTTP. Panduan ini mencakup Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp, dan opencode.

### Apa yang bisa dilihat asisten?

Hanya data pos publik: sekitar 1,8 juta baris GeoNames di 82 negara, berisi nama tempat, wilayah, county, koordinat, dan format nasional. Tidak ada akun, jadi tidak ada data pribadi.

### Bisakah mengubah sesuatu?

Tidak. Kelima alat bersifat hanya baca. Server tidak bisa menulis, mengirim, atau mengubah data, tidak menyetel cookie, dan tidak menyimpan sesi.

### Seberapa akurat datanya?

Ini basis data kode pos GeoNames dengan lisensi CC BY 4.0, diperbarui tiap kali dibangun ulang. Nama tempat dan koordinat berasal dari catatan nyata. Presisinya berbeda per negara; list_countries menunjukkan format dan cakupan yang tersedia untuk tiap negara.

### Apakah ada batas laju?

Tidak ada key dan tidak ada kuota ketat, tetapi PostcodeDog situs kecil: jaga laju tugas massal tetap wajar. Untuk pemakaian berat atau komersial, hubungi kami dulu.

### Bagaimana memutus koneksi?

Hapus server dari pengaturan alat AI Anda. Kami tidak menyimpan apa pun, jadi tidak ada yang perlu dicabut.

---

Postal code data © GeoNames contributors, CC BY 4.0.