Use zipcodestack with AI agents (MCP)
zipcodestack ships a hosted Model Context Protocol (MCP) server. AI agents and assistants — Claude, Cursor, VS Code and any other MCP-capable client — can call the API as native tools, no SDK or glue code required.
https://api.zipcodestack.com/mcp
Connect in seconds
Using Claude Code:
claude mcp add --transport http zipcodestack https://api.zipcodestack.com/mcp --header "apikey: YOUR_API_KEY"
Or add it to any MCP client configuration:
{
"mcpServers": {
"zipcodestack": {
"url": "https://api.zipcodestack.com/mcp",
"headers": { "apikey": "YOUR_API_KEY" }
}
}
}
Every request needs your API key, including the MCP handshake and listing the tools. Sign up for a free API key and send it as the apikey header.
Available tools
| Tool | Endpoint | Description |
|---|---|---|
search | GET /v1/search | Look up postal codes |
distance | GET /v1/distance | Distance from one code to others |
radius | GET /v1/radius | Codes within a radius |
polygon | POST /v1/polygon | Codes inside a polygon |
match | GET /v1/match | Match code pairs within a distance |
codesByCity | GET /v1/code/city | Codes for a city |
codesByState | GET /v1/code/state | Codes for a state |
provinces | GET /v1/country/province | Provinces for a country |
reverse | GET /v1/reverse | Postal codes nearest to a coordinate |
validateCode | GET /v1/validate | Validate a postal code |
autocomplete | GET /v1/autocomplete | Postal codes starting with a prefix |
coverage | GET /v1/coverage | Coverage by country |
getStatus | GET /v1/status | Account quota status |
Tool calls are metered like regular API requests and return the same machine-readable errors, so your agent always knows how to proceed. Full details in the MCP documentation.