PostalDataPI MCP Server

resmi

Pencarian kode pos global, validasi, dan pencarian kota untuk 70+ negara. Respons di bawah 10ms.

GitHub

Dokumentasi

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

Server MCP (Model Context Protocol) untuk PostalDataPI — memungkinkan agen AI mencari, memvalidasi, dan menelusuri kode pos di 240+ negara dan wilayah dengan metadata kaya: zona waktu, wilayah administratif, elevasi, dan koordinat.

Alat

AlatDeskripsi
lookup_postal_codeMendapatkan kota, negara bagian/wilayah, dan singkatan untuk kode pos (ZIP AS, kode pos Inggris, PLZ Jerman, dll.)
validate_postal_codeMemeriksa apakah kode pos ada di suatu negara
search_by_cityMenemukan semua kode pos untuk suatu kota
get_postal_code_metadataMetadata lengkap: koordinat, hierarki admin, zona waktu, elevasi, dan lainnya

Penyiapan

1. Dapatkan Kunci API

Daftar di postaldatapi.com/register — 1.000 kueri gratis, tanpa kartu kredit.

2. Instal

pip install postaldatapi-mcp

3. Konfigurasi dengan Claude Code

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Konfigurasi dengan Claude Desktop

Tambahkan ke konfigurasi Claude Desktop Anda (~/Library/Application Support/Claude/claude_desktop_config.json di macOS):

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Penggunaan

Setelah dikonfigurasi, tanyakan Claude secara alami:

  • "Kota apa kode ZIP 90210?"
  • "Cari kode pos Inggris SW1A"
  • "Apakah 10115 kode pos Jerman yang valid?"
  • "Apa saja kode pos untuk Beverly Hills, CA?"
  • "Dapatkan koordinat untuk kode pos 100-0001 di Jepang"

Claude akan otomatis menggunakan alat PostalDataPI untuk menjawab.

Negara yang Didukung

240+ negara dan wilayah termasuk AS, Inggris, Kanada, Jerman, Prancis, Jepang, Australia, Brasil, India, dan banyak lagi. Lihat daftar lengkapnya di postaldatapi.com/countries.

Metadata Kaya

Di luar pencarian dasar, alat get_postal_code_metadata mengembalikan hingga 18 bidang per kode pos termasuk:

  • Koordinat (lintang, bujur)
  • Zona waktu (mis., America/Mexico_City, Europe/Berlin)
  • Hierarki administratif (negara bagian/provinsi, county, munisipalitas)
  • Elevasi (meter di atas permukaan laut)
  • Nama tempat dan informasi negara

Contoh respons untuk Mexico City 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
}

Tautan