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" }
}
}
}
Listing the available tools works without authentication. To execute 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 |
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.