• DATA
  • LOGISTICS
  • ESTIMATES
  • HUMAN

How to calculate shipping distances with your AI

Connect the ZIP Codes API to your AI client to automate distance lookups. Once connected, your agent handles the math for any two ZIP codes you provide.

Ask AI about this page

Short answer

How can I calculate distance between ZIP codes using AI?

Your AI uses the get_zip_distance tool to pull the exact mileage between two specific ZIP codes. This lets you build route plans or shipping estimates directly in your chat. You'll see the specific outcomes below.

The outcomes

What you get from this task

The AI handles the lookups, leaving you with the final numbers.

DATA

Exact mileage results

The AI pulls the precise distance between two points. You get a clean number instead of a guess.

LOGISTICS

Route planning support

Your agent can take a list of ZIP codes and calculate the distances for each pair. This helps you organize delivery sequences.

ESTIMATES

Shipping cost prep

By knowing the distance, your AI can help you draft shipping quotes. It turns raw data into usable business info.

HUMAN

Final decision making

The AI provides the distance, but you decide which routes are actually feasible. It handles the calculation so you can focus on the strategy.

The workflow

What your AI does when the request arrives.

The AI acts as the bridge between your text instructions and the ZIP code database.

  1. Parse locations

    Your AI reads your message to identify the starting and ending ZIP codes you want to check.

    get_zip_distance

  2. Fetch distance

    The agent calls the tool to pull the exact mileage between those two locations.

    get_zip_distance

  3. Format output

    The AI takes the raw distance data and presents it in your chat interface.

    get_zip_distance

  4. Apply logic

    You can then ask the AI to use that distance to calculate something else, like a delivery fee.

    get_zip_distance

Try it

Copy these to start.

Use these prompts to trigger the distance calculation immediately.

Starting points

Swap the ZIP codes in these examples with the ones you actually need to check.

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"
    }
  }
}
Copy into chat04

  • What is the distance between ZIP code 90210 and 60601?

  • Calculate the distance between 33101 and 10001 for my shipping route.

  • Check the mileage between 75201 and 30301 and tell me if it's over 1000 miles.

  • I have a list of ZIP codes in this spreadsheet; find the distance from 94105 to each of them.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect ZIP Codes API once, then ask.

Just click to connect. Your credentials stay encrypted, and you can start asking for distances in your favorite AI client right away.

Connect ZIP Codes API to your AI

FAQ

How this task behaves

  • 01

    Can the AI calculate the distance between two street addresses?

    No. This tool only works with ZIP codes.

  • 02

    Does the AI automatically book the shipments for me?

    No. The AI only provides the distance data. You must handle the actual booking through your own logistics software.

  • 03

    Can I use this to find the shortest driving route?

    The tool provides the distance between ZIP codes, but it does not provide turn-by-turn navigation or real-time traffic data.

  • 04

    Will the AI change my existing shipping spreadsheets?

    No. The AI only reads data and provides answers in your chat. It cannot modify your local files.

  • 05

    How accurate are these distances?

    The AI pulls the exact distance provided by the ZIP Codes API tool.

  • More questions about ZIP Codes API? The Connector page answers them. See everything the ZIP Codes API Connector can do

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