An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect ZIP Codes API to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Get precise US and Canadian geographic data through your AI agent.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 6 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 6 available through ZIP Codes API.

  1. 01

    Find zips by city

    This capability finds all ZIP codes associated with a specific city and state.

  2. 02

    Find zips by county

    Use this to pull a list of all ZIP codes located within a specific county.

  3. 03

    Find zips by state

    This capability retrieves every ZIP code within a designated state.

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through ZIP Codes API.

  1. 04

    Get zip details

    Get specific geographic and demographic information for a single 5-digit ZIP code.

  2. 05

    Find zips in radius

    This capability identifies all ZIP codes located within a specific mile radius of a starting ZIP code.

  3. 06

    Get zip distance

    Calculate the exact distance between two specific ZIP codes.

Real work

What teams actually run

01

Delivery Zone Mapping

A logistics lead uses the radius capability to define exactly which ZIP codes fall within a driver's service area.

02

Market Density Analysis

A researcher asks for all ZIP codes in a specific county to evaluate potential customer clusters.

03

Route Planning

An operations manager calculates distances between hubs to optimize shipping routes.

04

Lead Verification

A sales rep uses the agent to quickly check if a new lead's ZIP code matches their target territory.

Automate a task

Put ZIP Codes API to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

ZIP Codes API works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put ZIP Codes API to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

832ms average. Fast in production.

ZIP Codes API is checked daily against the live service.

Daily averagePeak 1582ms
Oct 3Today
Fastest day
717ms
Slowest day
1582ms
14-day trend
Slowing+80%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of ZIP Codes API, so you can see the experience inside your AI.

It does not authenticate your account with ZIP Codes API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

ZIP Codes API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ZIP Codes API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "zip-codes-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_hlBslbNWY0rbtSVlqUUmZZHf8FgIzxBvV783th8k/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up ZIP Codes API in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work ZIP Codes API owners hand off.

This MCP is built for professionals who need to verify or analyze geographic data without manual searching.

  • 01

    Logistics Managers

    They hand off delivery zone monitoring and distance calculations to their agent.

  • 02

    Market Researchers

    They use the agent to verify regional clusters and demographic distributions.

  • 03

    Sales Operations

    They task their agent with auditing lead locations and finding nearby ZIP codes.

FAQ

Questions ZIP Codes API owners ask.

  • 01

    What geographic regions does this MCP cover?

    This MCP provides data for the United States and Canada.

  • 02

    How do I use this with Claude or Cursor?

    Once you subscribe and add your API key on Vinkius, you simply connect your client to the Vinkius host. Your agent will then see the ZIP code capabilities automatically.

  • 03

    Can I calculate distances between two points?

    Yes, you can use the get_zip_distance capability to find the exact distance between any two ZIP codes.

  • 04

    Do I need my own API key?

    Yes, you will need to provide your own Zip-codes.com API key to authenticate the connection.

  • 05

    Can I find all ZIP codes in a specific city?

    Yes, the find_zips_by_city capability allows you to retrieve all codes associated with a specific city and state.

  • 06

    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.

  • 07

    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).

  • 08

    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.

Explore

More in Data Management

Suggestions

Connect ZIP Codes API to Claude, Cursor, ChatGPT & more