Zippopotam.us MCP for AI. Turn Any Postal Code into Coordinates.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Zippopotam.us delivers global postal code intelligence directly through your AI agent. It instantly translates any zip or postal code into precise geographical data, pulling out city names, state details, and latitude/longitude coordinates for over 60 countries.
Use this to validate addresses, calculate service areas, or build location-aware workflows without leaving your chat window.
What your AI can do
Lookup nearby city
Finds all associated postal codes when given a general city and state name.
Lookup postcode
Retrieves the full location details, including coordinates, for any specific zip code.
You pass a postal code, and it returns the precise latitude and longitude for that location.
You list a city and state, and it compiles all associated postal codes for that area.
The agent cross-references an address against global data to confirm the validity of the zip code and location details.
Ask an AI about this
Waiting for input…
Zippopotam.us with 2 Tools
These two tools let you perform comprehensive geographic data lookups: finding all codes in a city, or pulling details for a single postal code.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Zippopotam.us on VinkiusLookup Nearby City
Finds all associated postal codes when given a general city and state name.
Lookup Postcode
Retrieves the full location details, including coordinates, for any specific zip...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Zippopotam.us integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Zippopotam.us, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zippopotam.us. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 2 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Figuring out where an address belongs used to be a manual nightmare.
Today, if you needed location details for even a single zip code, someone had to jump through hoops. You'd copy the number into one database, then maybe another internal tool just to get the city name, and then possibly a third sheet of spreadsheets just to confirm the state abbreviation. It was slow, it required three different logins, and every time you needed coordinates, you were stuck copying text from one tab to another.
Now, your agent handles all that complexity in one go. You give it a postal code, and it instantly returns validated city name, state details, and the precise lat/long coordinates—all structured data you can use immediately for mapping or calculations.
With Zippopotam.us, location validation is instant.
The multi-step process of checking if a zip code was valid, then finding its city, and finally pulling the coordinates is gone. Your agent handles the full chain in one query.
You don't just get data; you get confidence. You know the location details are sourced from a reliable global index, making your application logic faster and far more accurate.
What your AI can actually do with this
This MCP gives your agent the intelligence needed to handle global addressing. Instead of needing a separate database query or relying on limited internal lists, you can ask it for location details using just a postal code. You get back structured data: the city, the state, and exact coordinates for that spot.
Need to check if Miami has three different zip codes? It handles that. Working with complex supply chains, your agent acts like a dedicated geographic specialist. This is especially powerful when you combine it with other services; for example, chaining this MCP with a billing system MCP allows your agent to validate both the location and the service address in one go.
Because all these operations run on Vinkius, you get full visibility into what data flowed through every step of the process using Vinkius AI Analytics. This means nothing happens in the dark; you always know exactly which coordinates were used and how the budget is being spent.
019d84a3-e3c0-730d-9ea5-d58df220219f 
Here's how it actually works
The bottom line is you get reliable, actionable geographic facts without writing any API calls or managing keys yourself.
Connect this MCP to your AI client on Vinkius.
Prompt your agent with a specific query, like 'What's the coordinate for X postal code?'
Your agent runs the lookup and returns structured data: city name, state, latitude, and longitude.
Who is this actually for?
Anyone dealing with physical addresses across borders. Think logistics managers whose biggest headache is mis-addressed shipments, e-commerce fulfillment teams that need to validate service areas quickly, or data scientists who need reliable geo-datasets for modeling.
Needs to verify if a postal code in a new region actually covers the facility's intended state before setting up shipping routes.
Builds checkout forms that require real-time, accurate coordinate lookups for tax calculation or fraud detection.
Requires a structured way to enrich raw datasets of zip codes with corresponding lat/long values for mapping projects.
What Changes When You Connect
Validate addresses on the fly: Use lookup_postcode to immediately confirm a zip code's city, state, and exact coordinates for any global location.
Map out service areas: If you need to know every possible postal code in a given region, use lookup_nearby_city instead of manually searching through lists.
Build complex workflows: Connect this MCP with others—say, messaging or billing services. Your agent can validate an address and then automatically create a support ticket for that specific location.
No API keys needed: This service is public access, so you never have to worry about managing credentials; your AI client connects once and gets the data.
Structured results always: You don't get messy text. You get clean JSON with latitude and longitude points ready for database insertion or mapping tools.
See it in action
Checking a new market's feasibility
A regional sales manager needs to know the service boundaries for a new state. They ask their agent to use lookup_nearby_city with the city name, which returns all relevant postal codes. This shows them exactly what zip code ranges they need to target, saving days of manual research.
Validating billing addresses for a client
A finance ops engineer receives an invoice with a suspicious zip code. They prompt their agent using lookup_postcode. The agent quickly confirms the location is not only valid but also provides the coordinates, allowing the engineer to flag it immediately before processing payment.
Fulfilling complex international orders
A global e-commerce developer needs a checkout field that validates addresses across multiple countries. They use this MCP's data to ensure every provided postal code matches known city and state boundaries, preventing failed shipments.
Calculating distance for delivery zones
A dispatch coordinator determines if a new client falls within the service zone. They ask their agent to get coordinates using lookup_postcode, which provides the necessary lat/long pair to run an accurate distance calculation.
The honest tradeoffs
Relying on incomplete data
Assuming that just knowing a city name is enough for billing purposes, and trying to use it as the final source of truth.
Don't stop at the city name. Always follow up with lookup_postcode to get the precise zip code and coordinates needed for accurate financial or logistical records.
Hardcoding location logic
Writing custom Python functions that use geo-libraries, requiring constant maintenance when boundaries change.
Let your agent handle it. Use this MCP to query the live data source directly from your AI client. It handles the updates; you just ask the question.
Ignoring multi-country differences
Using a single, generalized address validation tool that fails when switching between US zip codes and UK postal codes.
This MCP is built for global data. Use it to handle the specific format requirements of any country's postal code system.
When It Fits, When It Doesn't
Use this MCP if your core problem involves turning a written address or zip code into precise, actionable latitude and longitude coordinates—especially if you need to validate addresses across multiple countries. Don't use it if all you need is general text parsing; for that, stick to simple string manipulation tools. You must use this when the business logic requires physical geography, like calculating delivery radius or verifying tax jurisdiction boundaries using lookup_postcode. If your goal is just to list every code in a state, then lookup_nearby_city handles that specific need better than trying to force one tool to do everything.
Questions you might have
How does lookup_postcode work? +
It takes a specific postal code and returns all associated geographic data points. This means you get the city, state, and exact latitude/longitude for that number.
Can Zippopotam.us list all zip codes in a big metro area? +
Yes, use lookup_nearby_city. You simply provide the desired city name and state, and it pulls back a full list of associated postal codes for you.
Do I need an API key to use Zippopotam.us? +
No. This MCP uses public access, meaning there's no key management required from your end—just connect it to your AI client and start querying.
What is the difference between the two tools? +
Use lookup_postcode when you have a specific zip code and need its details. Use lookup_nearby_city when you have a general area (city/state) and want to find all relevant zip codes.
What happens if I use `lookup_postcode` with an invalid or non-existent postal code? +
The tool handles invalid inputs gracefully by returning a specific error object. Your agent will receive this failure report, allowing it to continue running the workflow without crashing and prompting you to check your input data.
Does `lookup_nearby_city` or `lookup_postcode` output the geographic data in a structured format? +
Yes. All results are returned as clean, usable JSON objects. This structure makes it easy for your AI client to read and pass the latitude, longitude, state name, or coordinates directly into another connected MCP.
Are there any rate limits when calling Zippopotam.us tools? +
The platform manages usage, but sustained high-volume requests are subject to standard API rate limits. If you exceed the allowed calls in a window, your agent will receive an explicit error code, which helps manage retries and throttling.
How can I combine data from `lookup_nearby_city` with other operational tasks? +
You get precise coordinates for any city found. You can pass these latitude and longitude values immediately to a separate logistics MCP or mapping service to calculate routes, check service areas, or validate distances.
Can I lookup a US zip code and get its coordinates? +
Yes! Use the lookup_postcode tool 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 tool with the country code, state, and city name. It will return a list of all postal codes associated with that urban area.
We've already built the connector for Zippopotam.us. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 2 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.