Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics
Validate & geocode a US address; enrich with demographics, districts, counties, schools & much more.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http zip-codes-com-location-intelligence-spat 'https://mcp.zip-codes.com/mcp' --header 'X-Api-Key: <Optional API key; without it the server runs in demo mode>'{
"mcpServers": {
"zip-codes-com-location-intelligence-spat": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "<Optional API key; without it the server runs in demo mode>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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–2025. American Community Survey profiles use consistent field names across 2011–2024 releases for ZIP Code areas and 2022–2024 for tracts. A ZIP's survey estimates come from the Census ZCTA with the same code.
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 (11)
| 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. |
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.
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 fréquentes
Qu'est-ce que Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics ?
Validate & geocode a US address; enrich with demographics, districts, counties, schools & much more.
Comment installer Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http zip-codes-com-location-intelligence-spat 'https://mcp.zip-codes.com/mcp' --header 'X-Api-Key: <Optional API key; without it the server runs in demo mode>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics ?
Oui. Il attend X-Api-Key, à renseigner dans sa configuration.
Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics ?
Il est publié par ZIP-Codes-API. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.