PostalDataPI MCP Server

официальный

Глобальный поиск почтовых индексов, валидация и поиск городов для более чем 70 стран. Время ответа менее 10 мс.

GitHub

Документация

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

MCP-сервер (Model Context Protocol) для PostalDataPI — позволяет AI-агентам искать, проверять и находить почтовые индексы в 240+ странах и территориях с богатыми метаданными: часовой пояс, административные регионы, высота над уровнем моря и координаты.

Инструменты

ИнструментОписание
lookup_postal_codeПолучить город, штат/регион и аббревиатуру для почтового индекса (ZIP США, почтовый индекс Великобритании, PLZ Германии и т.д.)
validate_postal_codeПроверить, существует ли почтовый индекс в стране
search_by_cityНайти все почтовые индексы для города
get_postal_code_metadataПолные метаданные: координаты, административная иерархия, часовой пояс, высота и многое другое

Настройка

1. Получите API-ключ

Зарегистрируйтесь на postaldatapi.com/register — 1000 бесплатных запросов, кредитная карта не требуется.

2. Установка

pip install postaldatapi-mcp

3. Настройка с Claude Code

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

4. Настройка с Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

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

Использование

После настройки просто спросите Claude:

  • "Какой город соответствует ZIP-коду 90210?"
  • "Найди почтовый индекс Великобритании SW1A"
  • "Действителен ли немецкий почтовый индекс 10115?"
  • "Какие почтовые индексы у Беверли-Хиллз, Калифорния?"
  • "Получи координаты для почтового индекса 100-0001 в Японии"

Claude автоматически использует инструменты PostalDataPI для ответа.

Поддерживаемые страны

240+ стран и территорий, включая США, Великобританию, Канаду, Германию, Францию, Японию, Австралию, Бразилию, Индию и многие другие. Полный список смотрите на postaldatapi.com/countries.

Расширенные метаданные

Помимо базовых запросов, инструмент get_postal_code_metadata возвращает до 18 полей для каждого почтового индекса, включая:

  • Координаты (широта, долгота)
  • Часовой пояс (например, America/Mexico_City, Europe/Berlin)
  • Административная иерархия (штат/провинция, округ, муниципалитет)
  • Высота над уровнем моря (в метрах)
  • Название места и информация о стране

Пример ответа для Мехико 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
}

Ссылки