Zip-Codes.com MCP server
Commit 11 Nov 2026Memvalidasi alamat di AS serta menyediakan geocoding, demografi sensus, distrik sekolah, dan analisis spasial untuk kode ZIP.
Juga dikenal sebagai ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Stars
- 0
- Tools
- 12
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.1.0
- Commit terakhir
- 11 Nov 2026
- Lisensi
- —
Apa itu Zip-Codes.com MCP?
Zip-Codes.com adalah MCP server. Memvalidasi alamat di AS serta menyediakan geocoding, demografi sensus, distrik sekolah, dan analisis spasial untuk kode ZIP. Server ini menyediakan 12 tool, seperti about_data, buy_credits, city_name_rules.
Ringkasan dibuat dari README proyek
Tentang Zip-Codes.com MCP server
Server ini memungkinkan Anda memvalidasi alamat di AS dan mengambil data demografi sensus langsung dari dalam AI client. Developer dapat menggunakannya untuk mengubah nama tempat yang tidak lengkap menjadi data lokasi yang presisi atau menstandardisasi alamat jalan untuk menemukan kode ZIP+4 yang spesifik. Server ini menyediakan kecerdasan spasial yang mendalam, termasuk informasi pendapatan, perumahan, dan distrik sekolah, dengan mengambil data dari USPS yang diperbarui setiap bulan dan batas wilayah Census.
User terhubung ke server melalui transport streamable HTTP, sehingga kompatibel dengan Claude Code, Cursor, dan VS Code. Meskipun key gratis memungkinkan penggunaan 2.500 credit setiap hari, server ini mendukung Machine Payments Protocol melalui tool buy_credits. Hal ini memungkinkan agent untuk menggunakan wallet MPP, seperti Stripe Link, untuk membeli API key prabayar atau menambah credit secara langsung.
Toolset yang tersedia mencakup dua belas fungsi khusus seperti zip_lookup untuk catatan lengkap, radius_search untuk mencari area pos terdekat, dan distance untuk menghitung jarak antar dua titik. Tool ini mencakup segalanya, mulai dari referensi area metropolitan hingga batas historis Census TIGER/Line yang mencakup tahun 2010 hingga 2026.
Apa yang bisa Anda lakukan dengannya
- 1Standardisasi alamat surat di ASSeorang agent dapat memvalidasi alamat jalan untuk memastikan kebenarannya dan mengambil kode ZIP+4 yang spesifik.
- 2Analisis demografi lingkunganDeveloper dapat meminta data census tract mendetail termasuk statistik pendapatan dan perumahan untuk lokasi tertentu.
- 3Melakukan pencarian radius spasialAnda dapat menginstruksikan AI untuk mencari semua kode ZIP AS atau area pos Kanada dalam jarak tertentu dari titik pusat.
- 4Otomatisasi manajemen credit APIAgent otonom dapat menggunakan wallet yang terhubung untuk membeli lebih banyak credit API saat dibutuhkan.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Zip-Codes.com MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Zip-Codes.com MCP di Claude Code
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstal Zip-Codes.com MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Instal Zip-Codes.com MCP di VS Code
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Instal Zip-Codes.com MCP di VS Code CLI
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Instal Zip-Codes.com MCP di Codex
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpInstal Zip-Codes.com MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Instal Zip-Codes.com MCP di Gemini CLI
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstal Zip-Codes.com MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Tool Zip-Codes.com MCP 12
Terdeteksi dari 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 | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauzip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 225 msLolos
README
Lihat di 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
Pertanyaan tentang Zip-Codes.com MCP
Bagaimana cara menambahkan Zip-Codes.com MCP ke Claude Code?
Jalankan claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Zip-Codes.com MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan Zip-Codes.com MCP?
Server ini menyediakan 12 tool, termasuk about_data, buy_credits, city_name_rules, county_reference, distance.
Informasi apa yang bisa saya dapatkan dari validasi alamat AS?
Anda dapat memvalidasi alamat jalan di AS dan menerima informasi ZIP+4, demografi census tract, pendapatan, perumahan, serta informasi distrik sekolah dalam satu kali pemanggilan.
Bagaimana cara AI agent membeli lebih banyak credit?
Agent dapat menggunakan tool buy_credits untuk membeli paket credit menggunakan wallet MPP, seperti Stripe Link, dengan persetujuan pemiliknya.
Apakah tersedia tier gratis?
Ya, Anda bisa mulai tanpa key, dan key gratis menyediakan 2.500 credit per hari.