MCP server Zip-Codes.com
Коммит 11 нояб. 2026 г.Валидация адресов США, геокодирование, получение демографических данных переписи, информации о школьных округах и пространственный анализ почтовых индексов.
Также известен как ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Звёзды
- 0
- Инструменты
- 12
- Загрузки, 30 дней
- —
- Последняя версия
- 1.1.0
- Последний коммит
- 11 нояб. 2026 г.
- Лицензия
- —
Что такое Zip-Codes.com MCP?
Zip-Codes.com — это MCP server. Валидация адресов США, геокодирование, получение демографических данных переписи, информации о школьных округах и пространственный анализ почтовых индексов. Он предоставляет 12 инструментов, например about_data, buy_credits, city_name_rules.
Сводка сгенерирована из README проекта
О Zip-Codes.com MCP server
Этот сервер позволяет валидировать адреса в США и получать демографические данные переписи населения прямо из ИИ-клиента. Разработчики могут использовать его для преобразования неполных названий мест в точные данные о местоположении или стандартизации уличных адресов для поиска конкретных кодов ZIP+4. Сервер предоставляет глубокую пространственную аналитику, включая данные о доходах, жилье и школьных округах, используя ежемесячно обновляемые данные USPS и границы переписи населения.
Пользователи подключаются к серверу через streamable HTTP, что обеспечивает совместимость с Claude Code, Cursor и VS Code. Хотя бесплатный ключ позволяет использовать 2500 кредитов ежедневно, сервер поддерживает Machine Payments Protocol через инструмент buy_credits. Это позволяет агенту использовать MPP-кошелек, например Stripe Link, для покупки предоплаченных API-ключей или прямого пополнения баланса.
Инструментарий включает двенадцать специализированных функций, таких как zip_lookup для получения полных записей, radius_search для поиска ближайших почтовых зон и distance для расчета расстояния между двумя точками. Сервер охватывает всё: от справочников агломераций до исторических границ Census TIGER/Line за период с 2010 по 2026 год.
Что вы можете с ним делать
- 1Стандартизация почтовых адресов СШААгент может проверить уличный адрес на корректность и получить точный код ZIP+4.
- 2Анализ демографии районовРазработчик может запросить подробные данные переписи, включая статистику доходов и жилья для конкретной локации.
- 3Пространственный поиск по радиусуВы можете дать ИИ команду найти все почтовые индексы США или почтовые зоны Канады в пределах определенного расстояния от центральной точки.
- 4Автоматизация управления кредитами APIАвтономный агент может использовать подключенный кошелек для покупки дополнительных кредитов API по мере необходимости.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Zip-Codes.com MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Zip-Codes.com MCP в Claude Code
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpУстановка Zip-Codes.com MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Установка Zip-Codes.com MCP в VS Code
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Установка Zip-Codes.com MCP в VS Code CLI
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Установка Zip-Codes.com MCP в Codex
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpУстановка Zip-Codes.com MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Установка Zip-Codes.com MCP в Gemini CLI
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpУстановка Zip-Codes.com MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Инструменты Zip-Codes.com MCP 12
Определено из READMEabout_databuy_creditscity_name_rulescounty_referencedistancemetro_area_referencequick_zipradius_searchsuggest_placesvalidate_addresszip_factszip_lookup
| about_data | — | |
| buy_credits | — | |
| city_name_rules | — | |
| county_reference | — | |
| distance | — | |
| metro_area_reference | — | |
| quick_zip | — | |
| radius_search | — | |
| suggest_places | — | |
| validate_address | — | |
| zip_facts | — | |
| zip_lookup | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийzip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 225 msПройдено
README
Открыть на GitHubZip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics
Location intelligence for US addresses and ZIP Codes, through the Model Context Protocol. Zip-Codes.com can validate a US street address and return its ZIP+4, census tract demographics, income, housing and school district in one call. It answers from current USPS data, updated monthly, and Census boundaries, so an agent looks addresses and ZIP Codes up instead of guessing them. Request the enrichments you need. The survey estimates describe the census tract and carry margins of error.
ZIP boundaries follow USPS carrier routes and are refreshed quarterly. Coverage includes PO Box and single-organization ZIP Codes that Census ZIP-area files leave out. Boundary enrichments show which counties and districts a ZIP overlaps, with shares measured by area. The USPS county assignment is available alongside the mapped counties.
For history, request Census TIGER/Line boundaries from 2010–2026. American Community Survey profiles use consistent field names across the 2011–2024 releases, for ZIP Code areas and census tracts alike. A ZIP's survey estimates come from the Census ZCTA with the same code.
MPP-capable: an optional buy_credits tool lets an agent with an MPP wallet (such as Stripe Link) buy a prepaid API key or add credits to one; the wallet's owner approves each payment.
Connect
Server 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) and other mcpServers clients
{
"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"
}
}
}
}
Clients that only take a bearer token can send Authorization: Bearer YOUR_KEY instead.
Claude / Claude Desktop custom connector
Add https://mcp.zip-codes.com/mcp as a custom connector. It runs in demo mode unless the connector form has a Request headers section (a beta for a limited set of organizations): there, add x-api-key with your key.
Tools (12)
| Tool | Title | What it does |
|---|---|---|
about_data |
About this data | Where this server's data comes from: for each dataset the authority behind it, the edition served where the source publishes editions (TIGER/Line, ACS, ZCTA), how often a new release is taken, and a ready-made citation string. |
buy_credits |
Buy credits | Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link. |
city_name_rules |
City name rules | How USPS names a ZIP Code, and which of those names may be used on mail. |
county_reference |
County reference | US counties and county equivalents — all 3,235 of them — with their Census and USPS names, which disagree for over a hundred, plus ANSI code, legal type, land and water area, and USPS delivery footprint. |
distance |
Distance between two places | Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second. |
metro_area_reference |
Metro area reference | US metropolitan and micropolitan statistical areas (CBSAs) — all 935. |
quick_zip |
Quick ZIP / ZIP+4 / reverse geocode | The fast, small answer for a postal code. |
radius_search |
Radius search | Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each. |
suggest_places |
Place search (type-ahead) | Search for a place by partial name, misspelled name, or partial code — the resolver that turns what a person typed into something the other tools can look up. |
validate_address |
Validate a US address | Validate and standardise a US street address and return its ZIP+4. |
zip_facts |
ZIP Code facts | Statistics about US ZIP Codes and Canadian postal codes: how many exist, how they break down by type, delivery point and carrier route totals, per-state tables, and ranked lists such as the ZIP Codes with the most carrier routes. |
zip_lookup |
ZIP Code lookup | The full record for a postal code — the main location-intelligence tool. |
Pricing
No key needed to start. A free key gives 2,500 credits a day; plans and credit packs: https://www.zip-codes.com/api/pricing
Support
Email jharris@zip-codes.com. Issues are turned off on this repository; email reaches the people who run the server.
Privacy policy: https://www.zip-codes.com/privacy-policy.asp
Links
- Overview: https://www.zip-codes.com/api/mcp
- API docs: https://api.zip-codes.com/docs
- Server overview for agents: https://mcp.zip-codes.com/llms.txt
License
Proprietary. All rights reserved; see LICENSE. Use of the server, API and data is governed by the Terms of Service: https://www.zip-codes.com/api/tos
Вопросы о Zip-Codes.com MCP
Как добавить Zip-Codes.com MCP в Claude Code?
Выполните claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Zip-Codes.com MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет Zip-Codes.com MCP?
Он предоставляет 12 инструментов, включая about_data, buy_credits, city_name_rules, county_reference, distance.
Какую информацию можно получить при валидации адреса в США?
Вы можете проверить уличный адрес в США и одним запросом получить его ZIP+4, демографические данные по участкам переписи, сведения о доходах, жилье и школьном округе.
Как ИИ-агент может докупить кредиты?
Агенты могут использовать инструмент buy_credits для покупки пакетов кредитов через MPP-кошелек (например, Stripe Link) с одобрения владельца.
Есть ли бесплатный тариф?
Да, вы можете начать работу без ключа, а бесплатный ключ предоставляет 2500 кредитов в день.