Serveur MCP Zip-Codes.com
Commit 11 nov. 2026Valide les adresses américaines et fournit le géocodage, les données démographiques du recensement, les districts scolaires et l'analyse spatiale pour les codes ZIP.
Aussi connu sous ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Étoiles
- 0
- Outils
- 12
- Téléchargements, 30 jours
- —
- Dernière version
- 1.1.0
- Dernier commit
- 11 nov. 2026
- Licence
- —
Qu'est-ce que Zip-Codes.com MCP ?
Zip-Codes.com est un serveur MCP. Valide les adresses américaines et fournit le géocodage, les données démographiques du recensement, les districts scolaires et l'analyse spatiale pour les codes ZIP. Il expose 12 outils, comme about_data, buy_credits, city_name_rules.
Résumé généré à partir du README du projet
À propos du MCP server Zip-Codes.com
Ce serveur permet de valider des adresses américaines et de récupérer des données démographiques du recensement directement depuis un client IA. Les développeurs peuvent l'utiliser pour transformer des noms de lieux partiels en données de localisation précises ou pour standardiser des adresses de rue afin de trouver des codes ZIP+4 spécifiques. Il offre une intelligence spatiale approfondie, incluant des informations sur les revenus, le logement et les districts scolaires, en extrayant des données USPS mises à jour mensuellement et des limites de recensement.
Les utilisateurs se connectent au serveur via un transport streamable HTTP, ce qui le rend compatible avec Claude Code, Cursor et VS Code. Bien qu'une clé gratuite permette d'obtenir 2 500 crédits par jour, le serveur prend en charge le Machine Payments Protocol via un outil buy_credits. Cela permet à un agent d'utiliser un portefeuille MPP, comme Stripe Link, pour acheter des clés API prépayées ou ajouter des crédits directement.
La boîte à outils comprend douze fonctions spécialisées telles que zip_lookup pour les enregistrements complets, radius_search pour trouver des zones postales à proximité, et distance pour calculer le kilométrage entre deux points. Elle couvre tout, des références de zones métropolitaines aux limites historiques Census TIGER/Line s'étendant de 2010 à 2026.
Ce que vous pouvez faire avec
- 1Standardiser les adresses postales américainesUn agent peut valider une adresse de rue pour s'assurer de son exactitude et récupérer le code ZIP+4 spécifique.
- 2Analyser la démographie d'un quartierUn développeur peut demander des données détaillées sur les secteurs de recensement, incluant les statistiques sur les revenus et le logement pour un lieu précis.
- 3Effectuer des recherches de rayon spatialVous pouvez demander à une IA de trouver tous les codes ZIP américains ou les zones postales canadiennes dans une distance spécifique par rapport à un point central.
- 4Automatiser la gestion des crédits APIUn agent autonome peut utiliser un portefeuille connecté pour acheter davantage de crédits API lorsque cela est nécessaire.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Zip-Codes.com MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Zip-Codes.com MCP dans Claude Code
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstaller Zip-Codes.com MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Installer Zip-Codes.com MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Installer Zip-Codes.com MCP dans VS Code CLI
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Installer Zip-Codes.com MCP dans Codex
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpInstaller Zip-Codes.com MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Installer Zip-Codes.com MCP dans Gemini CLI
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstaller Zip-Codes.com MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Outils MCP Zip-Codes.com 12
Détectés depuis le 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 | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblezip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)No licenseFaille
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 225 msRéussi
README
Voir sur 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
Questions sur Zip-Codes.com MCP
Comment ajouter Zip-Codes.com MCP à Claude Code ?
Exécutez claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Zip-Codes.com MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Zip-Codes.com MCP fournit-il ?
Il expose 12 outils, dont about_data, buy_credits, city_name_rules, county_reference, distance.
Quelles informations puis-je obtenir via la validation d'une adresse américaine ?
Vous pouvez valider une adresse de rue aux États-Unis et recevoir son code ZIP+4, les données démographiques du secteur de recensement, ainsi que des informations sur les revenus, le logement et le district scolaire en un seul appel.
Comment un agent IA peut-il acheter plus de crédits ?
Les agents peuvent utiliser l'outil buy_credits pour acheter des packs de crédits via un portefeuille MPP, tel que Stripe Link, avec l'approbation du propriétaire.
Existe-t-il une offre gratuite ?
Oui, vous pouvez commencer sans clé, et une clé gratuite fournit 2 500 crédits par jour.