ZIP Codes API Connector for AI agents.
6 live capabilities
Manage US and Canadian geographic data and logistics distances.
Waiting for input…
Why people use ZIP Codes API
ZIP Codes API for Logistics and Regional Mapping
This Connector lets your agent do that work for you. Just tell your agent which areas to look at, and it pulls the exact distances and county data into your chat. You get a verified geographic audit without the manual clicks.
What Vinkius changes
Your agent gets instant access to verified US and Canadian geographic data.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Logistics route planning
A manager asks for the distance between two warehouses to see if a new route is viable using get_zip_distance.
- Real-world use case 02
Market research
A researcher wants to find all ZIP codes in a 10-mile radius of a new retail site using find_zips_in_radius.
- Real-world use case 03
Sales territory mapping
A sales lead wants to see all ZIP codes in a specific county to assign leads to a team using find_zips_by_county.
Complete set · 6capabilities
The complete ZIP Codes API capability set.
These are the exact actions your AI can choose when you ask it to work with ZIP Codes API.
01—03
3 capabilities in this set.
Part of 6 available through ZIP Codes API.
- 01 Capability
Find zips by city
List every ZIP code associated with a specific city and state. This helps group data by urban centers.
- 02 Capability
Find zips by county
Find all ZIP codes within a specific county. Use this to manage regional logistics or local government boundaries.
- 03 Capability
Find zips by state
Find every ZIP code in a specific state. This helps when you need to see the full geographic spread of a region.
04—06
3 capabilities in this set.
Part of 6 available through ZIP Codes API.
- 04 Capability
Get zip distance
Calculate the exact mileage between two ZIP codes. Use this to plan delivery routes or shipping costs.
- 05 Capability
Find zips in radius
Identify all ZIP codes within a set mile radius of a starting point. This is perfect for finding nearby competitors or customers.
- 06 Capability
Get zip details
Pull geographic and demographic info for a specific ZIP code. It gives you the city, state, and county in one go.
Set up in minutes
One URL. Then ask ZIP Codes API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use ZIP Codes API 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_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable ZIP Codes API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API URL.
- Step 03
Save and start
Save the connection and enable ZIP Codes API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"zip-codes-api": {
"url": "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API
Open Agent mode in chat and ask: "Using ZIP Codes API, help me...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"zip-codes-api": {
"url": "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API
Ask Copilot: "Using ZIP Codes API, help me...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"zip-codes-api": {
"url": "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API
Open Cascade and ask: "Using ZIP Codes API, help me...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"zip-codes-api": {
"url": "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API
Ask Cline: "Using ZIP Codes API, help me...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add zip-codes-api --transport http "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/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 ZIP Codes API
Ask Claude: "Using ZIP Codes API, show me...". 6 tools are ready
Where the request belongs
Work ZIP Codes API can move forward.
This is for logistics managers tired of manual mileage tracking, market researchers mapping demographics, and sales ops leads who need to audit lead locations without clicking through dozens of map tabs.
Logistics Manager
Checking delivery zones and calculating mileage between warehouses on a Tuesday afternoon.
Market Researcher
Identifying regional clusters and demographic distributions for new retail site选址.
Sales Operations Lead
Auditing lead locations and finding nearby ZIP codes for territory assignments.
Operations Lead
Automating geographic data queries to manage regional teams and distribution zones.
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.
Smarty
Equip your AI with enterprise-grade location intelligence to validate, autocomplete, and extract US or International addresses instantly.
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.
Precisely
Equip your AI with precise location intelligence. geocode addresses, resolve property risks, calculate local taxes, and analyze demographics globally.
FCC Geo
Instantly convert geographic coordinates into precise US Census Blocks and Telecommunication zones with zero authentication.
Bring your own AI
Change the model, client or framework. Keep ZIP Codes API 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 ZIP Codes API.
The practical details behind the request, access and result.
Can the ZIP Codes API MCP find codes near my store?
Yes, you can ask your agent to identify every ZIP code within a specific mile radius of any starting point. This is great for seeing which neighborhoods are nearby.
How does the ZIP Codes API MCP calculate distances?
The Connector provides the exact mileage between any two ZIP codes. It's perfect for logistics planning and getting accurate shipping estimates.
Can I use the ZIP Codes API MCP for Canadian addresses?
Yes, this Connector provides authoritative geographic data for both the United States and Canada.
Does the ZIP Codes API MCP provide county information?
It does. You can retrieve the county associated with a specific ZIP code or find all ZIP codes that belong to a specific county.
How do I get the coordinates for a ZIP code using the ZIP Codes API MCP?
Your agent can retrieve the exact latitude and longitude for any given ZIP code, which is helpful for mapping and spatial analysis.
How do I find my Zip-codes.com API Key?
Log in to your Zip-codes.com account, and you will find your API Key under the 'API Settings' or 'My Account' section. Copy and paste it below.
Does it support Canadian postal codes?
Yes. Zip-codes.com provides extensive data for both United States ZIP codes and Canadian Postal Codes (forward sortation areas).
Can the agent calculate distances?
Yes. The get_zip_distance capability calculates the point-to-point distance in miles between any two valid ZIP codes instantly.
One connection away
Give your agent a direct line to ZIP Codes API.
Connect ZIP Codes API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available