Zip-Codes.com MCP server
Commit 11. Nov. 2026Validiert US-Adressen und bietet Geocoding, Volkszählungsdaten, Schulbezirke sowie räumliche Analysen für ZIP-Codes.
Auch bekannt als ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Stars
- 0
- Tools
- 12
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.0
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- —
Was ist Zip-Codes.com MCP?
Zip-Codes.com ist ein MCP server. Validiert US-Adressen und bietet Geocoding, Volkszählungsdaten, Schulbezirke sowie räumliche Analysen für ZIP-Codes. Er stellt 12 Tools bereit, etwa about_data, buy_credits, city_name_rules.
Zusammenfassung generiert aus dem README des Projekts
Über Zip-Codes.com MCP server
Dieser MCP server ermöglicht es dir, US-Adressen direkt aus einem AI Client heraus zu validieren und demografische Daten der Volkszählung abzurufen. Entwickler können ihn nutzen, um unvollständige Ortsnamen in präzise Standortdaten umzuwandeln oder Straßenadressen zu standardisieren, um spezifische ZIP+4-Codes zu finden. Er bietet tiefe räumliche Intelligenz, einschließlich Informationen zu Einkommen, Wohnraum und Schulbezirken, indem er monatlich aktualisierte USPS-Daten und Census-Grenzen nutzt.
Nutzer verbinden sich über einen streamable HTTP Transport mit dem Server, was ihn kompatibel mit Claude Code, Cursor und VS Code macht. Während ein kostenloser Key 2.500 Credits täglich ermöglicht, unterstützt der Server das Machine Payments Protocol über ein buy_credits Tool. Dies erlaubt es einem Agent, ein MPP-Wallet wie Stripe Link zu nutzen, um Prepaid-API-Keys zu kaufen oder direkt Credits hinzuzufügen.
Das Toolset umfasst zwölf spezialisierte Funktionen wie zip_lookup für vollständige Datensätze, radius_search zum Finden nahegelegener Postgebiete und distance zur Berechnung der Entfernung zwischen zwei Punkten. Er deckt alles ab, von Metropolregion-Referenzen bis hin zu historischen Census TIGER/Line Grenzen für den Zeitraum von 2010 bis 2026.
Was du damit machen kannst
- 1US-Postanschriften standardisierenEin Agent kann eine Straßenadresse validieren, um deren Korrektheit sicherzustellen und den spezifischen ZIP+4-Code abzurufen.
- 2Nachbarschaftsdemografie analysierenEin Entwickler kann detaillierte Census Tract Daten anfordern, einschließlich Einkommens- und Wohnraumstatistiken für einen bestimmten Standort.
- 3Räumliche Radius-Suchen durchführenDu kannst eine KI anweisen, alle US ZIP Codes oder kanadischen Postgebiete innerhalb einer bestimmten Entfernung von einem Mittelpunkt zu finden.
- 4API-Credit-Management automatisierenEin autonomer Agent kann ein verbundenes Wallet nutzen, um bei Bedarf weitere API Credits zu kaufen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Zip-Codes.com MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenZip-Codes.com MCP in Claude Code installieren
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpZip-Codes.com MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Zip-Codes.com MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Zip-Codes.com MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Zip-Codes.com MCP in Codex installieren
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpZip-Codes.com MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Zip-Codes.com MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpZip-Codes.com MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Zip-Codes.com MCP tools 12
Erkannt aus dem 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 | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarzip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 225 msBestanden
README
Auf GitHub ansehenZip-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 Fragen
Wie füge ich Zip-Codes.com MCP zu Claude Code hinzu?
Führe claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Zip-Codes.com MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Zip-Codes.com MCP?
Er stellt 12 Tools bereit, darunter about_data, buy_credits, city_name_rules, county_reference, distance.
Welche Informationen kann ich durch eine US-Adressvalidierung erhalten?
Du kannst eine US-Straßenadresse validieren und erhältst in einem einzigen Aufruf die ZIP+4-Erweiterung, demografische Daten des Census Tracts sowie Informationen zu Einkommen, Wohnraum und Schulbezirken.
Wie kann ein AI Agent weitere Credits kaufen?
Agents können das buy_credits Tool nutzen, um Credit-Pakete über ein MPP-Wallet, wie zum Beispiel Stripe Link, mit der Genehmigung des Besitzers zu erwerben.
Gibt es eine kostenlose Stufe?
Ja, du kannst ohne Key starten, und ein kostenloser Key bietet 2.500 Credits pro Tag.