Zippopotam.us Connector for AI agents.
2 live capabilities
Get precise geocoding and postal code data for global addresses.
Waiting for input…
Why people use Zippopotam.us
Zippopotam.us Geocoding for Precise Address Validation
With Zippopotam.us, your agent just asks and gets the answer. You get the city, state, and exact GPS coordinates in a single step, letting you move from 'where is this?' to 'done' in seconds.
What Vinkius changes
You get accurate global location data without having to manage a database yourself.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Verifying a shipping destination
A customer provides a zip code.
- Real-world use case 02
Mapping out city coverage
A developer needs to show all delivery zones for Chicago.
- Real-world use case 03
Cleaning international data
A data scientist has a list of French postal codes.
Complete set · 2capabilities
The complete Zippopotam.us capability set.
These are the exact actions your AI can choose when you ask it to work with Zippopotam.us.
01—02
2 capabilities in this set.
Part of 2 available through Zippopotam.us.
- 01 Capability
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.
- 02 Capability
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.
Set up in minutes
One URL. Then ask Zippopotam.us to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Zippopotam.us from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Zippopotam.us, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Zippopotam.us for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Zippopotam.us URL.
- Step 03
Save and start
Save the connection and enable Zippopotam.us in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"zippopotamus-alternative": {
"url": "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Zippopotam.us
Open Agent mode in chat and ask: "Using Zippopotam.us, help me...". 2 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"zippopotamus-alternative": {
"url": "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Zippopotam.us
Ask Copilot: "Using Zippopotam.us, help me...". 2 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"zippopotamus-alternative": {
"url": "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Zippopotam.us
Open Cascade and ask: "Using Zippopotam.us, help me...". 2 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"zippopotamus-alternative": {
"url": "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Zippopotam.us
Ask Cline: "Using Zippopotam.us, help me...". 2 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add zippopotamus-alternative --transport http "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Zippopotam.us
Ask Claude: "Using Zippopotam.us, show me...". 2 tools are ready
Where the request belongs
Work Zippopotam.us can move forward.
Logistics managers who need to verify shipping zones and data scientists who are tired of manually cleaning messy address lists.
Logistics Coordinator
Validates shipping destinations and calculates regional routing during peak seasons.
Data Analyst
Cleans up thousands of rows of address data to ensure every entry has a valid city and state.
Frontend Developer
Fetches coordinates to drop pins on a map without building a backend for geocoding.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsZippopotam.us
Global postal code intelligence. lookup city, state, and coordinates by zip code via AI.
ZIP Codes API
Manage ZIP code data. audit locations, distances, and regions via AI.
Smarty
Equip your AI with enterprise-grade location intelligence to validate, autocomplete, and extract US or International addresses instantly.
CountryStateCity
Access global geographic data. list countries, states, and cities with ISO codes and metadata directly from any AI agent.
Geocodio
Empower geocoding via Geocodio. perform batch geocoding and reverse geocoding for US/Canada, and retrieve Census and legislative data directly from any AI agent.
HUD User (USPS Crosswalk)
Map ZIP codes to Census geographies via HUD User USPS Crosswalk API.
Bring your own AI
Change the model, client or framework. Keep Zippopotam.us connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Zippopotam.us.
The practical details behind the request, access and result.
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 capability 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 capability. 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 capability. 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.
One connection away
Give your agent a direct line to Zippopotam.us.
Connect Zippopotam.us once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available