MCP-сервер PostalDataPI

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

Инструменты

Related MCP server: Postio

Настройка

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 в свободной форме:

• "Какой город у почтового индекса 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
}

Ссылки

• PostalDataPI

• Справочник API

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

• Python SDK

• Node.js SDK