PostalDataPI MCP Server

officiel

Recherche mondiale de codes postaux, validation et recherche de villes pour plus de 70 pays. Réponses en moins de 10 ms.

GitHub
1

Que pouvez-vous faire avec PostalDataPI MCP ?

  • Rechercher un code postal — Demandez la ville, l'état et la région associés à un code postal donné en utilisant lookup_postal_code.
  • Valider un code postal — Vérifiez si un code postal existe pour un pays spécifique avec validate_postal_code.
  • Trouver tous les codes d'une ville — Récupérez tous les codes postaux desservant une ville particulière via search_by_city.
  • Obtenir les métadonnées complètes d'un emplacement — Demandez les coordonnées, le fuseau horaire, l'altitude et la hiérarchie administrative d'un code postal via get_postal_code_metadata.

Documentation

Serveur MCP PostalDataPI

License: MIT Python 3.10+ PyPI

Serveur MCP (Model Context Protocol) pour PostalDataPI — permet aux agents IA de rechercher, valider et explorer des codes postaux dans plus de 240 pays et territoires avec des métadonnées riches : fuseau horaire, régions administratives, altitude et coordonnées.

Outils

OutilDescription
lookup_postal_codeObtenir la ville, l'état/la région et l'abréviation d'un code postal (ZIP américain, code postal britannique, PLZ allemand, etc.)
validate_postal_codeVérifier si un code postal existe dans un pays
search_by_cityTrouver tous les codes postaux d'une ville
get_postal_code_metadataMétadonnées complètes : coordonnées, hiérarchie administrative, fuseau horaire, altitude et plus encore

Configuration

1. Obtenir une clé API

Inscrivez-vous sur postaldatapi.com/register — 1 000 requêtes gratuites, aucune carte de crédit requise.

2. Installation

pip install postaldatapi-mcp

3. Configurer avec Claude Code

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

4. Configurer avec Claude Desktop

Ajoutez à votre configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS) :

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

Utilisation

Une fois configuré, interrogez Claude naturellement :

  • « Quelle ville correspond au code postal 90210 ? »
  • « Rechercher le code postal britannique SW1A »
  • « 10115 est-il un code postal allemand valide ? »
  • « Quels sont les codes postaux de Beverly Hills, CA ? »
  • « Obtenir les coordonnées du code postal 100-0001 au Japon »

Claude utilisera automatiquement les outils PostalDataPI pour répondre.

Pays pris en charge

Plus de 240 pays et territoires, dont les États-Unis, le Royaume-Uni, le Canada, l'Allemagne, la France, le Japon, l'Australie, le Brésil, l'Inde et bien d'autres. Consultez la liste complète sur postaldatapi.com/countries.

Métadonnées riches

Au-delà des recherches de base, l'outil get_postal_code_metadata renvoie jusqu'à 18 champs par code postal, notamment :

  • Coordonnées (latitude, longitude)
  • Fuseau horaire (par ex., America/Mexico_City, Europe/Berlin)
  • Hiérarchie administrative (état/province, comté, municipalité)
  • Altitude (mètres au-dessus du niveau de la mer)
  • Nom du lieu et informations sur le pays

Exemple de réponse pour Mexico 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
}

Liens