Zip-Codes.com MCP server
2026년 11월 11일 커밋미국 주소를 검증하고 ZIP 코드에 대한 지오코딩, 인구 조사 인구 통계, 학군 및 공간 분석 기능을 제공합니다.
다른 이름 ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- 스타
- 0
- Tools
- 12
- 다운로드, 30일
- —
- 최신 버전
- 1.1.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- —
Zip-Codes.com MCP란?
Zip-Codes.com은(는) MCP server입니다. 미국 주소를 검증하고 ZIP 코드에 대한 지오코딩, 인구 조사 인구 통계, 학군 및 공간 분석 기능을 제공합니다. 12개 도구를 제공합니다. 예: about_data, buy_credits, city_name_rules.
프로젝트 README에서 생성된 요약
Zip-Codes.com MCP server 정보
이 MCP server는 AI 클라이언트 내부에서 미국 주소를 검증하고 인구 조사 인구 통계를 가져오는 기능을 지원합니다. 개발자는 이를 사용하여 불완전한 지명을 정확한 위치 데이터로 변환하거나, 도로 주소를 표준화하여 특정 ZIP+4 코드를 찾을 수 있습니다. 또한 매달 업데이트되는 USPS 데이터와 인구 조사 경계 데이터를 활용하여 소득, 주거, 학군 정보를 포함한 심층적인 공간 지능을 제공합니다.
사용자는 streamable HTTP 전송 방식을 통해 서버에 연결하므로 Claude Code, Cursor, VS Code와 호환됩니다. 무료 키로 매일 2,500 크레딧을 사용할 수 있지만, 서버는 buy_credits 도구를 통해 Machine Payments Protocol을 지원합니다. 이를 통해 에이전트는 Stripe Link와 같은 MPP 지갑을 사용하여 선불 API 키를 구매하거나 크레딧을 직접 충전할 수 있습니다.
도구 세트에는 전체 레코드를 위한 zip_lookup, 인근 우편 구역을 찾는 radius_search, 두 지점 사이의 거리를 계산하는 distance 등 12개의 특화된 기능이 포함되어 있습니다. 대도시 지역 참조부터 2010년에서 2026년까지의 과거 Census TIGER/Line 경계에 이르기까지 모든 정보를 다룹니다.
활용 사례
- 1미국 우편 주소 표준화에이전트가 도로 주소를 검증하여 정확성을 확인하고 특정 ZIP+4 코드를 가져올 수 있습니다.
- 2지역 인구 통계 분석개발자가 특정 위치에 대한 소득 및 주거 통계를 포함한 상세한 인구 조사 구역 데이터를 요청할 수 있습니다.
- 3공간 반경 검색 수행AI에게 중심점에서 특정 거리 내에 있는 모든 미국 ZIP 코드 또는 캐나다 우편 구역을 찾도록 지시할 수 있습니다.
- 4API 크레딧 관리 자동화자율 에이전트가 연결된 지갑을 사용하여 필요할 때 API 크레딧을 추가로 구매할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Zip-Codes.com MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Zip-Codes.com MCP 설치
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpCursor에 Zip-Codes.com MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}VS Code에 Zip-Codes.com MCP 설치
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}VS Code CLI에 Zip-Codes.com MCP 설치
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Codex에 Zip-Codes.com MCP 설치
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpCodex config.toml에 Zip-Codes.com MCP 설치
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Gemini CLI에 Zip-Codes.com MCP 설치
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpGemini settings.json에 Zip-Codes.com MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Zip-Codes.com MCP 도구 12
README에서 감지됨about_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 | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능zip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스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통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 225 ms통과
README
GitHub에서 보기Zip-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 코드, 인구 조사 구역 인구 통계, 소득, 주거 및 학군 정보를 받을 수 있습니다.
AI 에이전트가 크레딧을 추가로 구매하려면 어떻게 해야 하나요?
에이전트는 소유자의 승인 하에 buy_credits 도구를 사용하여 Stripe Link와 같은 MPP 지갑으로 크레딧 팩을 구매할 수 있습니다.
무료 티어가 있나요?
네, 키 없이 시작할 수 있으며 무료 키를 사용하면 하루에 2,500 크레딧을 제공받습니다.