# Zippopotam.us MCP for AI Agents AI Agent Connect > Zippopotam.us MCP gives your AI agent instant access to global postal data. It handles lookups for over 60 countries, letting your agent find city names, state details, and precise latitude and longitude coordinates from just a zip code. It also performs reverse lookups to find all postal codes tied to a specific city and state. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** postal-code-lookup, geographic-data, json-api, latitude-longitude, location-intelligence, reverse-geocoding, global-data ## Description The Zippopotam.us MCP connects your AI agent to a global database of geographic and postal information. Instead of your agent guessing where a zip code lands or hunting through messy spreadsheets, it can now pull accurate location data for over 60 different countries. You can ask it to find the exact coordinates for a specific area or identify which state and city a postal code belongs to. This is a huge help for anyone who needs to ground their AI in real-world geography without manual data entry. When you use this through the Vinkius catalog, you get a reliable way to handle these queries instantly. It works for everything from confirming addresses in a shipping log to mapping out service areas for a local business. Your agent basically becomes a geography specialist that knows exactly where things are located across the globe. You don't have to worry about the nuances of different country formats because the Connector handles the heavy lifting of data translation. Whether you are building a new app that needs to display locations on a map or you are just trying to clean up a messy list of addresses for a logistics project, this tool makes the data accessible in plain English. It removes the friction of switching between different websites to find basic location details, letting you stay focused on the actual work of moving goods, analyzing data, or building software. ## Tools ### lookup_nearby_city Use lookup_nearby_city to find all zip codes associated with a specific city and state. This helps you see the full coverage of a geographic area. ### lookup_postcode Use lookup_postcode to get the city, state, and exact coordinates for a specific postal code. This turns a simple zip into actionable location data. ## Prompt Examples **Prompt:** ``` What's the city and state for zip code 90210? ``` **Response:** ``` The zip code 90210 belongs to **Beverly Hills, California**. Here are the exact coordinates: * **Latitude**: 34.0901 * **Longitude**: -118.4065 ``` **Prompt:** ``` List the postal codes for Miami, Florida. ``` **Response:** ``` I found several postal codes for **Miami, Florida**. Here are some common ones: * 33101 * 33109 * 33125 Would you like me to pull the full list for you? ``` **Prompt:** ``` Give me the coordinates for the postal code 'SW1A 1AA' in Great Britain. ``` **Response:** ``` That postal code is located in **London, England**, specifically in the Buckingham Palace area. The coordinates are **51.501, -0.1419**. ``` ## Capabilities ### Get city and state names Your agent can pull the city and state for any zip code in over 60 countries. ### Find precise coordinates The Connector provides exact latitude and longitude for specific postal codes. ### Map entire regions You can find every postal code associated with a specific city and state. ### Identify geographic details The agent can access data for over 60 different countries instantly. ### Perform reverse lookups Turn a city and state into a complete list of associated postal codes. ## Use Cases ### Shipping Route Verification A logistics manager asks the agent to find the coordinates for a list of zip codes to plan a delivery route. ### Real Estate Data Cleaning A data scientist uses the agent to identify which states and cities belong to a large list of postal codes. ### Local Service Mapping A small business owner asks the agent to find all postal codes in a specific city to define their service area. ### Address Validation A developer builds a tool that uses the agent to check if a zip code is valid and what city it belongs to. ## Benefits - Stop manual data entry. Use lookup_postcode to instantly get city and state names for any zip code in 60+ countries. - Get precise mapping data. Your agent can pull exact latitude and longitude coordinates to power localized services. - Map entire regions easily. Use lookup_nearby_city to see every postal code tied to a specific city and state. - Verify shipping details quickly. Your agent can confirm location data for logistics and delivery teams in seconds. - Build location-aware apps faster. Developers can integrate geographic lookups without building or maintaining their own databases. ## How It Works The bottom line is your AI agent gets a direct line to global geographic data without needing any manual API setup. 1. Subscribe to the Zippopotam.us MCP on Vinkius 2. Connect your preferred AI client like Claude or Cursor 3. Ask your agent to find location data or postal codes using natural language ## Frequently Asked Questions **Can the Zippopotam.us MCP find locations in my country?** Yes, it supports geographic data for over 60 countries worldwide, making it a reliable choice for global location queries. **Does the Zippopotam.us MCP require an API key?** No, this Connector provides public access, so you can start using it immediately after connecting it to your AI client. **Can I use Zippopotam.us MCP to find coordinates for mapping?** Yes, it provides precise latitude and longitude for postal codes, which you can use to plot locations on a map. **How does Zippopotam.us MCP handle cities with multiple zip codes?** You can ask the agent to list all postal codes for a specific city and state to see the full range of codes in that area. **Is the Zippopotam.us MCP good for logistics?** It is great for verifying city and state data from postal codes to ensure shipping accuracy and route planning. **Can Zippopotam.us MCP help with data cleaning?** Yes, it can help you map large lists of zip codes to their corresponding cities and states, which is perfect for cleaning up messy datasets. **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.