MCP server for geocoding

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.

GET /v3/US/48867
[
  {
    "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

200 OK
[
  {
    "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.

Start in minutes

Create a free key, then copy a working example in cURL, Python, Node.js, PHP or Ruby.