Postal code & geocoding MCP server for AI agents
Give Claude, Cursor and any Model Context Protocol (MCP) agent native tools to look up postal codes, reverse-geocode coordinates, batch-resolve lists and search cities across 123 countries and territories.
Try a live US lookup
Test the underlying API response your agents receive.
[
{
"country": "US",
"postal_code": "48867",
"city": "Owosso",
"county": "Shiawassee",
"state": "Michigan",
"state_short": "MI",
"latitude": 42.9934,
"longitude": -84.1595,
"timezone": "America/Detroit",
"geohash": "dpshsfsytw8k"
}
]
Call it from your code or agent
Pass your API key in the x-key header:
{
"mcpServers": {
"ziptastic": {
"command": "python",
"args": ["-m", "ziptastic_mcp.server"],
"env": { "ZIPTASTIC_API_KEY": "YOUR_KEY" }
}
}
}v3 Response
[
{
"country": "US",
"postal_code": "48867",
"city": "Owosso",
"county": "Shiawassee",
"state": "Michigan",
"state_short": "MI",
"latitude": 42.9934,
"longitude": -84.1595,
"timezone": "America/Detroit",
"geohash": "dpshsfsytw8k"
}
]
The MCP server wraps the v3 REST API and authenticates with the same x-key header, so agent tool calls are metered against your normal plan allowance. See the field reference for details.
Six native MCP tools for geographic reasoning
- postal_lookup & batch_lookup: Resolve a single (country, postal_code) pair or batch up to 100 codes in one tool call when an agent processes a table or CSV.
- resolve (forgiving free-text): Agents often extract messy strings like '90210' or 'M5V Toronto'. The resolve tool infers the country, normalizes the code and returns a confidence score.
- reverse_geocode & city_search: Turn latitude/longitude + radius into the nearest postal codes, or find postal codes for a city prefix within a country.
- OpenAPI + llms.txt included: Agents that call HTTP directly can introspect /openapi.json or read /llms.txt, with structured error hints designed for autonomous retries.
Stop letting LLMs hallucinate ZIP codes and timezones
Language models routinely guess the wrong county, coordinate or timezone for mid-size and international postal codes. Connecting Ziptastic's MCP server grounds your agent in over 2.8 million postal codes across 123 countries and territories.
Grab a free Developer API key (100 requests a day, no credit card needed), drop it into your MCP config, and let your agents resolve places deterministically.
Free plan included
The free Developer plan gives you an API key with 100 requests a day on the full v3 API across all 123 countries and territories, and no card is required. When you outgrow it, paid plans scale up to 1,000,000 requests a day.
Explore other postal code APIs
Start in minutes
Create a free key, then copy a working example in cURL, Python, Node.js, PHP or Ruby.