Zippopotam.us Connector for AI agents.
2 live capabilities
Access global postal codes and geographic coordinates for logistics and mapping.
Waiting for input…
Why people use Zippopotam.us
Zippopotam.us for Global Logistics and Address Verification
This Connector changes that by letting your AI agent do the heavy lifting. You just tell your agent which zip code you need, and it pulls the city, state, and exact coordinates for you instantly. It turns a multi-step manual search into a single, accurate data point.
What Vinkius changes
Your AI agent gets a direct line to global geographic data without needing any manual API setup.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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-world use case 02
Real Estate Data Cleaning
A data scientist uses the agent to identify which states and cities belong to a large list of postal codes.
- Real-world use case 03
Local Service Mapping
A small business owner asks the agent to find all postal codes in a specific city to define their service area.
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
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.
- 02 Capability
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.
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_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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": {
"url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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": {
"url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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": {
"url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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": {
"url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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 --transport http "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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 coordinators tired of manual address verification, developers building location-aware apps, and data analysts who need clean geographic datasets.
Logistics Coordinator
Verifies shipping destinations and calculates distances for delivery routes on a Tuesday afternoon.
Software Developer
Builds features that require mapping postal codes to coordinates without maintaining a local database.
Data Analyst
Pulls structured geographic data for regional reporting and market analysis.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsZippopotam.us
Free geocoding and postal code lookup. retrieve city, state, and coordinates for any zip code or find postal codes by city.
ZIP Codes API
Manage ZIP code data. audit locations, distances, and regions via AI.
HUD User (USPS Crosswalk)
Map ZIP codes to Census geographies via HUD User USPS Crosswalk API.
CountryStateCity
Access global geographic data. list countries, states, and cities with ISO codes and metadata directly from any AI agent.
TIGER/Line Geocoder (Census)
Access official US Census Bureau geocoding services to convert addresses into coordinates and detailed census geography data.
Smarty
Equip your AI with enterprise-grade location intelligence to validate, autocomplete, and extract US or International addresses instantly.
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 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 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.
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