PostalDataPI MCP Server

officiel

Global postal code lookups, validation, and city search for 70+ countries. Sub-10ms responses.

GitHub

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