Can I lookup a US zip code and get its coordinates?

Yes! Use the lookup_postcode capability with the country 'US' and the zip code. It will return the city, state, and coordinates for that location.

Which countries are supported by Zippopotam.us?

Zippopotam.us supports over 60 countries, including the US, Canada, Great Britain, Brazil, France, Germany, and many others. You can use the standard 2-letter ISO country codes.

Can I find all zip codes for a specific city?

Yes! Use the lookup_city capability with the country code, state, and city name. It will return a list of all postal codes associated with that urban area.

Download PDF Markdown Version

Use Zippopotam.us with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Global postal code intelligence. lookup city, state, and coordinates by zip code via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Complete set · 2 capabilities

The complete Zippopotam.us capability set.

These are the exact actions your AI can choose when you ask it to work with Zippopotam.us.

Capability set01 / 01

01-02

2 capabilities in this set.

Part of 2 available through Zippopotam.us.

01
Lookup nearby city
Lookup zip codes for a city
02
Lookup postcode
Lookup location by postal code

Observed, not estimated

823ms average. Fast in production.

Zippopotam.us is checked daily against the live service.

Daily averagePeak 1020ms

Aug 20Today

Fastest day: 639ms
Slowest day: 1020ms
14-day trend: Slowing+15%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 2 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Zippopotam.us, so you can see the experience inside your AI.

It does not authenticate your account with Zippopotam.us. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Zippopotam.us Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Zippopotam.us capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "zippopotamus-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Zippopotam.us owners ask.

01
Can I lookup a US zip code and get its coordinates?
Yes! Use the lookup_postcode capability with the country 'US' and the zip code. It will return the city, state, and coordinates for that location.
02
Which countries are supported by Zippopotam.us?
Zippopotam.us supports over 60 countries, including the US, Canada, Great Britain, Brazil, France, Germany, and many others. You can use the standard 2-letter ISO country codes.
03
Can I find all zip codes for a specific city?
Yes! Use the lookup_city capability with the country code, state, and city name. It will return a list of all postal codes associated with that urban area.

Explore