PostalDataPI MCP Server

oficial

Búsqueda global de códigos postales, validación y búsqueda de ciudades para más de 70 países. Respuestas en menos de 10 ms.

GitHub

Documentación

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

Servidor MCP (Model Context Protocol) para PostalDataPI: permite a los agentes de IA buscar, validar y consultar códigos postales en más de 240 países y territorios con metadatos enriquecidos: zona horaria, regiones administrativas, altitud y coordenadas.

Herramientas

HerramientaDescripción
lookup_postal_codeObtiene ciudad, estado/región y abreviatura para un código postal (ZIP de EE. UU., código postal del Reino Unido, PLZ alemán, etc.)
validate_postal_codeVerifica si un código postal existe en un país
search_by_cityEncuentra todos los códigos postales de una ciudad
get_postal_code_metadataMetadatos completos: coordenadas, jerarquía administrativa, zona horaria, altitud y más

Configuración

1. Obtén una clave API

Regístrate en postaldatapi.com/register: 1,000 consultas gratuitas, sin tarjeta de crédito.

2. Instalación

pip install postaldatapi-mcp

3. Configuración con Claude Code

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

4. Configuración con Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Uso

Una vez configurado, pregúntale a Claude de forma natural:

  • "¿A qué ciudad pertenece el código postal 90210?"
  • "Busca el código postal del Reino Unido SW1A"
  • "¿Es 10115 un código postal alemán válido?"
  • "¿Cuáles son los códigos postales de Beverly Hills, CA?"
  • "Obtén las coordenadas del código postal 100-0001 en Japón"

Claude usará automáticamente las herramientas de PostalDataPI para responder.

Países admitidos

Más de 240 países y territorios, incluidos EE. UU., Reino Unido, Canadá, Alemania, Francia, Japón, Australia, Brasil, India y muchos más. Consulta la lista completa en postaldatapi.com/countries.

Metadatos enriquecidos

Más allá de las búsquedas básicas, la herramienta get_postal_code_metadata devuelve hasta 18 campos por código postal, que incluyen:

  • Coordenadas (latitud, longitud)
  • Zona horaria (p. ej., America/Mexico_City, Europe/Berlin)
  • Jerarquía administrativa (estado/provincia, condado, municipio)
  • Altitud (metros sobre el nivel del mar)
  • Nombre del lugar e información del país

Ejemplo de respuesta para Ciudad de México 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
}

Enlaces