Validate & geocode a US address; enrich with demographics, districts, counties, schools & much more.
Validate & geocode a US address; enrich with demographics, districts, counties, schools & much more.
·
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.
Server URL: https://mcp.zip-codes.com/mcp (Streamable HTTP).
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/mcp.json) and other mcpServers clients{
"mcpServers": {
"zip-codes": {
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "YOUR_KEY"
}
}
}
}.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.
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.
| 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. |
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
Email [email protected]. 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
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
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add zip-codes --transport http https://mcp.zip-codes.com/mcp{
"mcpServers": {
"zip-codes": {
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": ""
}
}
}
}code --add-mcp '{"name":"zip-codes","url":"https://mcp.zip-codes.com/mcp","headers":{"X-Api-Key":""}}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/zip-codes-mcp to learn what the "Zip-Codes.com ZIP & Postal Code" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
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"| Name | What it does |
|---|---|
suggest_places | 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. Fuzzy matching is built in: "beverley hil |
zip_lookup | The full record for a postal code — the main location-intelligence tool. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the city, st |
zip_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 |
quick_zip | The fast, small answer for a postal code. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the code's city, state or province, county, |
city_name_rules | How USPS names a ZIP Code, and which of those names may be used on mail. Each ZIP Code has exactly one preferred city name plus alternates, and some alternates are NOT valid for addressing — for 08088 |
buy_credits | Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link. The credits go on the account or prepaid card of the API key you send. Without a key, the pur |
radius_search | Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each. The centre takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a l |
about_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 r |
distance | Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second. Each end takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a lati |
validate_address | Validate and standardise a US street address and return its ZIP+4. US ONLY — unlike the postal-code tools, this does not cover Canada. Send the address on one line in mailing order: number and street, |
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 footpri |
metro_area_reference | US metropolitan and micropolitan statistical areas (CBSAs) — all 935. Of those only 393 are metropolitan; the rest are micropolitan and are NOT metro areas, so do not treat a CBSA count as a metro cou |
Read live from the server on November 15, 2026.
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/zip-codes-mcp)Finds hardcoded UI text, translates it with your app's context, and opens one pull request
Official SpriteFuse hosted OAuth MCP connection configurations and documentation; proprietary
v1.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "zip-codes-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Finds hardcoded UI text, translates it with your app's context, and opens one pull request
Developer Tools
Official SpriteFuse hosted OAuth MCP connection configurations and documentation; proprietary
Developer Tools
One email a week. New agents, MCP servers and skills, and what is actually getting traction.