Servidor MCP de PostalDataPI

Name: PostalDataPI MCP Server
Author: PostalDataPI

License: MIT Python 3.10+ PyPI

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

Herramientas

Herramienta	Descripción
`lookup_postal_code`	Obtiene la ciudad, estado/región y abreviatura de un código postal (ZIP de EE. UU., código postal del Reino Unido, PLZ alemán, etc.)
`validate_postal_code`	Comprueba si un código postal existe en un país
`search_by_city`	Encuentra todos los códigos postales de una ciudad
`get_postal_code_metadata`	Metadatos completos: coordenadas, jerarquía administrativa, zona horaria, elevación y más

Configuración

1. Obtener una clave API

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

2. Instalación

pip install postaldatapi-mcp

3. Configurar con Claude Code

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

4. Configurar con Claude Desktop

Añádelo 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:

"¿Qué ciudad es 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 utilizará 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, incluyendo:

Coordenadas (latitud, longitud)
Zona horaria (p. ej., America/Mexico_City, Europe/Berlin)
Jerarquía administrativa (estado/provincia, condado, municipio)
Elevación (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
}