Zip-Codes.com: пространственный анализ, округа и демографические данные за 14+ лет

Данные о местоположении адресов и ZIP-кодов США через Model Context Protocol. Zip-Codes.com проверяет адреса улиц в США и за один запрос возвращает ZIP+4, демографические данные переписного участка, сведения о доходах и жилье, а также школьный округ. Сервер использует актуальные данные USPS, обновляемые ежемесячно, и границы переписи населения США, поэтому агент может находить адреса и ZIP-коды, а не угадывать их. Запрашивайте нужные вам дополнительные данные. Оценки по результатам обследований относятся к переписному участку и сопровождаются показателями погрешности.

Границы ZIP-кодов соответствуют маршрутам доставки USPS и обновляются ежеквартально. Данные охватывают ZIP-коды для абонентских ящиков и отдельных организаций, которые не включены в файлы переписных ZIP-зон. Дополнительные данные о границах показывают, с какими округами и округами школьных систем пересекается ZIP-код, с указанием долей площади. Также доступно закрепление округа USPS наряду с округами, определёнными по картам.

Чтобы получить исторические данные, запросите границы Census TIGER/Line за 2010–2025 годы. В профилях American Community Survey используются единые названия полей для выпусков 2011–2024 годов по ZIP-зонам и 2022–2024 годов по переписным участкам. Оценки обследований для ZIP-кода берутся из переписной ZCTA с тем же кодом.

Подключение

URL сервера: https://mcp.zip-codes.com/mcp (Streamable HTTP).

Claude Code

claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp --header "X-Api-Key: YOUR_KEY"

Cursor (`~/.cursor/mcp.json`) и другие клиенты `mcpServers`

{
  "mcpServers": {
    "zip-codes": {
      "url": "https://mcp.zip-codes.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_KEY"
      }
    }
  }
}

VS Code (`.vscode/mcp.json`)

{
  "servers": {
    "zip-codes": {
      "type": "http",
      "url": "https://mcp.zip-codes.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_KEY"
      }
    }
  }
}

Клиенты, которые принимают только bearer-токен, могут вместо этого передать Authorization: Bearer YOUR_KEY.

Пользовательский коннектор Claude / Claude Desktop

Добавьте https://mcp.zip-codes.com/mcp в качестве пользовательского коннектора. По умолчанию он работает в деморежиме, если в форме настройки коннектора нет раздела Заголовки запроса (эта функция пока доступна в бета-версии ограниченному числу организаций). Если раздел есть, добавьте заголовок x-api-key и укажите свой ключ.

Инструменты (11)

Инструмент	Название	Описание
`about_data`	Об этих данных	Источники данных сервера: для каждого набора указаны ответственная за него организация, используемая версия — если источник выпускает версии (TIGER/Line, ACS, ZCTA), периодичность получения новых выпусков и готовая строка для цитирования.
`city_name_rules`	Правила названий городов	Как USPS называет ZIP-коды и какие из этих названий можно указывать на почтовых отправлениях.
`county_reference`	Справочник округов	Все 3 235 округов США и приравненных к ним территорий: названия Бюро переписи населения США и USPS, которые различаются более чем в сотне случаев, а также код ANSI, юридический тип, площадь суши и водной поверхности и зона доставки USPS.
`distance`	Расстояние между двумя местами	Расстояние между двумя местами в милях и километрах, а также компасный азимут от первого места ко второму.
`metro_area_reference`	Справочник агломераций	Все 935 статистических городских и микрополитенских районов США (CBSAs).
`quick_zip`	Быстрый поиск ZIP / ZIP+4 / обратное геокодирование	Краткий ответ для почтового индекса.
`radius_search`	Поиск в радиусе	Находит все ZIP-коды США и почтовые зоны Канады в заданном радиусе от центральной точки и указывает расстояние до каждой из них.
`suggest_places`	Поиск мест (с автодополнением)	Поиск места по неполному или ошибочно введённому названию либо части кода. Инструмент преобразует введённый пользователем запрос в данные, которые можно использовать для поиска с помощью других инструментов.
`validate_address`	Проверка адреса в США	Проверяет и стандартизирует адрес улицы в США и возвращает ZIP+4.
`zip_facts`	Статистика по ZIP-кодам	Статистика по ZIP-кодам США и почтовым кодам Канады: общее количество, разбивка по типам, число пунктов доставки и маршрутов доставки, данные по штатам, а также рейтинги, например ZIP-коды с наибольшим числом маршрутов доставки.
`zip_lookup`	Поиск по ZIP-коду	Полная запись о почтовом коде — основной инструмент для работы с данными о местоположении.

Цены

Для начала ключ не нужен. Бесплатный ключ даёт 2 500 кредитов в день. Тарифы и пакеты кредитов: https://www.zip-codes.com/api/pricing

Поддержка

Напишите на jharris@zip-codes.com. Обсуждения в этом репозитории отключены; по электронной почте можно связаться с командой, которая поддерживает сервер.

Ссылки

Обзор: https://www.zip-codes.com/api/mcp
Документация API: https://api.zip-codes.com/docs
Обзор сервера для агентов: https://mcp.zip-codes.com/llms.txt