PostalDataPI MCP Server

oficial

Consultas de códigos postais globais, validação e busca por cidades em mais de 70 países. Respostas em menos de 10ms.

GitHub
1

O que você pode fazer com PostalDataPI MCP?

  • Consultar um código postal — Solicite a cidade, estado e região associados a um determinado código postal usando lookup_postal_code.
  • Validar um código postal — Verifique se um código postal existe para um país específico com validate_postal_code.
  • Encontrar todos os códigos de uma cidade — Recupere todos os códigos postais que atendem a uma determinada cidade via search_by_city.
  • Obter metadados completos de localização — Solicite coordenadas, fuso horário, altitude e hierarquia administrativa para um código postal através de get_postal_code_metadata.

Documentação

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

Servidor MCP (Model Context Protocol) para PostalDataPI — permite que agentes de IA consultem, validem e pesquisem códigos postais em mais de 240 países e territórios com metadados ricos: fuso horário, regiões administrativas, altitude e coordenadas.

Ferramentas

FerramentaDescrição
lookup_postal_codeObtém cidade, estado/região e abreviação para um código postal (CEP dos EUA, código postal do Reino Unido, PLZ alemão, etc.)
validate_postal_codeVerifica se um código postal existe em um país
search_by_cityEncontra todos os códigos postais de uma cidade
get_postal_code_metadataMetadados completos: coordenadas, hierarquia administrativa, fuso horário, altitude e mais

Configuração

1. Obtenha uma Chave de API

Cadastre-se em postaldatapi.com/register — 1.000 consultas gratuitas, sem necessidade de cartão de crédito.

2. Instalação

pip install postaldatapi-mcp

3. Configurar com Claude Code

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

4. Configurar com Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

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

Uso

Uma vez configurado, pergunte ao Claude naturalmente:

  • "Qual é a cidade do CEP 90210?"
  • "Consulte o código postal do Reino Unido SW1A"
  • "10115 é um código postal alemão válido?"
  • "Quais são os códigos postais de Beverly Hills, CA?"
  • "Obtenha as coordenadas do código postal 100-0001 no Japão"

O Claude usará automaticamente as ferramentas do PostalDataPI para responder.

Países Suportados

Mais de 240 países e territórios, incluindo EUA, Reino Unido, Canadá, Alemanha, França, Japão, Austrália, Brasil, Índia e muitos outros. Veja a lista completa em postaldatapi.com/countries.

Metadados Ricos

Além das consultas básicas, a ferramenta get_postal_code_metadata retorna até 18 campos por código postal, incluindo:

  • Coordenadas (latitude, longitude)
  • Fuso horário (ex.: America/Mexico_City, Europe/Berlin)
  • Hierarquia administrativa (estado/província, condado, município)
  • Altitude (metros acima do nível do mar)
  • Nome do local e informações do país

Exemplo de resposta para Cidade do 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
}

Links