Zip-Codes.com MCP sunucusu
Commit 11 Kas 2026ABD adreslerini doğrular; posta kodları için coğrafi kodlama, nüfus demografisi, okul bölgeleri ve mekansal analiz sağlar.
Ayrıca bilinen adı ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Yıldızlar
- 0
- Araçlar
- 12
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.1.0
- Son commit
- 11 Kas 2026
- Lisans
- —
Zip-Codes.com MCP nedir?
Zip-Codes.com bir MCP sunucusudur. ABD adreslerini doğrular; posta kodları için coğrafi kodlama, nüfus demografisi, okul bölgeleri ve mekansal analiz sağlar. 12 araç sunar; örneğin about_data, buy_credits, city_name_rules.
Özet, projenin README dosyasından oluşturuldu
Zip-Codes.com MCP sunucusu hakkında
Bu server, bir AI istemcisi içerisinden ABD adreslerini doğrulamanıza ve nüfus demografisi verilerini çekmenize olanak tanır. Geliştiriciler, kısmi yer isimlerini kesin konum verilerine dönüştürmek veya belirli ZIP+4 kodlarını bulmak için sokak adreslerini standartlaştırmak amacıyla bu aracı kullanabilirler. Aylık olarak güncellenen USPS verilerinden ve Census sınırlarından yararlanarak gelir, konut ve okul bölgesi bilgilerini içeren derin mekansal zeka sağlar.
Kullanıcılar server'a streamable HTTP transport üzerinden bağlanabilirler; bu da onu Claude Code, Cursor ve VS Code ile uyumlu hale getirir. Ücretsiz bir anahtar günlük 2.500 krediye izin verirken, server buy_credits aracı aracılığıyla Machine Payments Protocol'ü destekler. Bu sayede bir agent, ön ödemeli API anahtarları satın almak veya doğrudan kredi eklemek için Stripe Link gibi bir MPP cüzdanı kullanabilir.
Araç seti; tam kayıtlar için zip_lookup, yakındaki posta alanlarını bulmak için radius_search ve iki nokta arasındaki mesafeyi hesaplamak için distance gibi on iki özelleşmiş fonksiyon içerir. Metropol alanı referanslarından, 2010 ile 2026 yıllarını kapsayan geçmiş Census TIGER/Line sınırlarına kadar her şeyi kapsar.
Neler yapabilirsiniz
- 1ABD posta adreslerini standartlaştırınBir agent, bir sokak adresinin doğru olduğundan emin olmak için doğrulama yapabilir ve belirli ZIP+4 kodunu alabilir.
- 2Mahalle demografisini analiz edinBir geliştirici, belirli bir konum için gelir ve konut istatistiklerini içeren ayrıntılı nüfus bölgesi verilerini talep edebilir.
- 3Mekansal yarıçap aramaları gerçekleştirinBir AI'ya, belirli bir merkez noktadan belirli bir mesafe içindeki tüm ABD ZIP Kodlarını veya Kanada posta alanlarını bulması talimatını verebilirsiniz.
- 4API kredi yönetimini otomatize edinOtonom bir agent, ihtiyaç duyduğunda daha fazla API kredisi satın almak için bağlı bir cüzdan kullanabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Zip-Codes.com MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleZip-Codes.com MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpZip-Codes.com MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Zip-Codes.com MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Zip-Codes.com MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Zip-Codes.com MCP'yi Codex içine yükleyin
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpZip-Codes.com MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Zip-Codes.com MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpZip-Codes.com MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Zip-Codes.com MCP araçları 12
README dosyasından algılandı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 | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirzip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 225 msGeçti
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 soruları
Zip-Codes.com MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Zip-Codes.com MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Zip-Codes.com MCP hangi araçları sunar?
12 araç sunar; bunlar arasında about_data, buy_credits, city_name_rules, county_reference, distance yer alır.
ABD adres doğrulaması ile hangi bilgileri alabilirim?
Bir ABD sokak adresini doğrulayabilir; tek bir çağrı ile ZIP+4 kodu, nüfus bölgesi demografisi, gelir, konut ve okul bölgesi bilgilerini alabilirsiniz.
Bir AI agent daha fazla kredi nasıl satın alabilir?
Agentlar, sahibinin onayıyla Stripe Link gibi bir MPP cüzdanı kullanarak kredi paketleri satın almak için buy_credits aracını kullanabilirler.
Ücretsiz bir katman mevcut mu?
Evet, bir anahtar olmadan başlayabilirsiniz; ücretsiz bir anahtar günlük 2.500 kredi sağlar.