Servidor MCP de PostalDataPI

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 y territorios con metadatos enriquecidos: zona horaria, regiones administrativas, elevación y coordenadas.

Herramientas

Related MCP server: Postio

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 SW1A del Reino Unido"

• "¿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
}

Enlaces

• PostalDataPI

• Referencia de la API

• Documentación

• SDK de Python

• SDK de Node.js