# Zippopotam.us MCP for AI Agents AI Agent Connect

> Zippopotam.us lets your AI agent fetch global geocoding and postal code data instantly. It pulls city names, states, and GPS coordinates for specific zip codes or lists all postal codes within a city. It handles international data across dozens of countries, making it a go-to for address validation and location mapping.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** postal-codes, zip-codes, geocoding, location-data, address-validation

## Description

Zippopotam.us is the tool you use when your agent needs to know exactly where a postal code lands on a map. Instead of your AI guessing or hallucinating location data, this Connector provides hard facts from a global database. You can ask it to find the latitude and longitude for a specific zip code or grab a list of every postal code in a major city. It works across many countries, so you aren't stuck with just US data. If you're building an app that needs to verify shipping addresses or if you're cleaning a messy dataset of locations, this is how you get the info without writing complex GIS queries. It's one of the many tools available in the Vinkius catalog that turns your AI into a reliable source of geographic truth. You just give it a code, and it gives you back the city, state, and coordinates in a format your agent can actually use.

## Tools

### get_location_by_postal_code
Get the city, state, and GPS coordinates for a specific postal code. It's the fastest way to turn a zip code into a map point.

### get_postal_codes_by_city
Retrieve a list of all postal codes for a specific city and state. Use this to see the full coverage area of a metropolitan region.

## Prompt Examples

**Prompt:** 
```
What's the city and state for zip code 90210?
```

**Response:** 
```
That zip code belongs to Beverly Hills, California (CA). The coordinates are **34.0901 latitude** and **-118.4065 longitude**.
```

**Prompt:** 
```
Give me all the zip codes for Seattle, WA.
```

**Response:** 
```
I found the following postal codes for Seattle, WA:

* 98101
* 98102
* 98103
* 98104
* And several others in the metro area.

Would you like the full list or details for a specific one?
```

**Prompt:** 
```
What's the city for German zip code 10115?
```

**Response:** 
```
The German postal code 10115 corresponds to the city of **Berlin** in the state of **Berlin (BE)**.
```

## Capabilities

### Get GPS coordinates
Retrieve latitude and longitude for any valid postal code instantly.

### List city postal codes
Get a full list of every zip code associated with a specific city and state.

### Identify city and state
Convert a single postal code into a readable city and state name.

### Fetch international data
Access geographic information for dozens of countries using standard ISO codes.

### Validate shipping destinations
Verify that a postal code exists and matches the expected city or state.

## Use Cases

### Verifying a shipping destination
A customer provides a zip code. The agent uses get_location_by_postal_code to confirm the city and state before generating a shipping label.

### Mapping out city coverage
A developer needs to show all delivery zones for Chicago. The agent uses get_postal_codes_by_city to pull the full list of codes.

### Cleaning international data
A data scientist has a list of French postal codes. The agent fetches the city names for the codes to complete a regional report.

### Automating map pins
A user asks where a specific zip code is located. The agent retrieves the coordinates to display a pin on a map immediately.

## Benefits

- Stop hallucinating coordinates. Use get_location_by_postal_code to get real latitude and longitude for any zip code.
- Map out entire cities. Use get_postal_codes_by_city to find every code in a region instantly.
- Handle international shipping. Access geographic data for dozens of countries using standard ISO codes.
- Clean messy datasets. Quickly fill in missing city and state information for thousands of records at once.
- Build maps faster. Get the data needed for map pins without setting up a complex GIS infrastructure.

## How It Works

The bottom line is you get accurate global location data without having to manage a database yourself.

1. Subscribe to the Zippopotam.us MCP on Vinkius.
2. Set your access key to 'PUBLIC' in your AI client settings.
3. Ask your agent to find coordinates or city names for any code.

## Frequently Asked Questions

**Can Zippopotam.us find coordinates for international zip codes?**
Yes, it supports dozens of countries. You can get city and GPS data for codes in the US, UK, France, and many other regions.

**Does Zippopotam.us require an account to use?**
No, it's a public API. You just need to set your access key to 'PUBLIC' in your Connector settings to start using it.

**How can Zippopotam.us help with my shipping data?**
It can automatically fill in missing city and state info for your shipping labels and validate that a postal code actually exists in a specific region.

**Can I get a list of all zip codes for a city using Zippopotam.us?**
Yes, the tool can pull all postal codes associated with a specific city and state so you can see the full coverage area.

**Is Zippopotam.us good for building a map app?**
It's great for getting the initial coordinates needed to drop pins on a map based on a user's zip code input.

**Does Zippopotam.us provide street addresses?**
No, it provides city-level and postal code-level data, including the city, state, and GPS coordinates.

**How can I find the latitude and longitude for a specific zip code?**
Use the `get_location_by_postal_code` tool. Provide the country code (e.g., 'us') and the postal code. The agent will return the city, state, and precise GPS coordinates.

**Can I find all postal codes for a specific city?**
Yes. Use the `get_postal_codes_by_city` tool. You will need to provide the country, the state abbreviation (e.g., 'ca' for California), and the city name.

**What format should I use for the country parameter?**
The API requires ISO 3166-1 alpha-2 country codes. For example, use 'us' for the United States, 'de' for Germany, 'fr' for France, or 'br' for Brazil.