• LOCATION
  • COORDINATES
  • DATA
  • HUMAN

How to lookup postal code details with your AI

Connect Zippopotam.us to your AI client once. After that, you can pull location data for any zip code just by asking.

Ask AI about this page

Short answer

How do I get city and state info from a zip code using AI?

Your AI uses the lookup_postcode tool to query Zippopotam.us for specific location data. You'll get the city, state, and exact latitude and longitude for the code you provide. Here is what you get.

The results

What you get from a lookup

The AI pulls specific data points from the Zippopotam.us database.

LOCATION

City and state names

The AI identifies the municipality and state associated with the postal code. This helps you verify regional data instantly.

COORDINATES

Exact geographic points

The tool returns latitude and longitude values. You can use these coordinates for mapping or distance calculations.

DATA

Raw location details

The AI extracts the precise location metadata from the query. This data is ready to be used in your spreadsheets or documents.

HUMAN

Manual verification

You decide if the returned city or state matches your specific needs. The AI provides the data, but you confirm the accuracy for your project.

The workflow

What your AI does when a postal code is provided.

The AI handles the API communication so you don't have to visit a website or use a manual search tool.

  1. Identify the request

    Your AI recognizes that you are asking for location information based on a postal code.

    lookup_postcode

  2. Query the database

    The AI uses the lookup_postcode tool to fetch the specific data from Zippopotam.us.

    lookup_postcode

  3. Parse the results

    The AI reads the response to find the city, state, and coordinates.

    lookup_postcode

  4. Deliver the answer

    The AI presents the location details in a clear, readable format in your chat window.

    lookup_postcode

Try it

Copy these to start.

Use these prompts to trigger the lookup immediately.

Starting points

Replace the bracketed zip codes with the actual numbers you want to check.

Zippopotam.us Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/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 — Zippopotam.us capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "zippopotamus-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_m2AdUuOmpmUFiAskGVSXovo0Bhd6hoPtBBaCSGZc/mcp"
    }
  }
}
Copy into chat04

  • Lookup the city and state for zip code 90210.

  • What are the coordinates for the postal code 60601?

  • Find the location details for 10001.

  • Check the state and city for zip code 33101.

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

Start here

Connect Zippopotam.us once, then ask.

Click the link to connect the MCP to your client. Your login credentials stay encrypted, and you can start querying right away.

Connect Zippopotam.us to your AI

FAQ

How this task behaves

  • 01

    Can the AI change the postal code data?

    No. The AI can only read data from Zippopotam.us; it cannot modify any records in the database.

  • 02

    Does the AI provide street addresses?

    No. The tool only provides city, state, and geographic coordinates.

  • 03

    Can I use this for international postal codes?

    No. This specific tool is designed for US postal code lookups.

  • 04

    Will the AI automatically update my spreadsheet with these results?

    No. The AI provides the information in the chat. You must manually copy the data into your spreadsheet or document.

  • 05

    Do I need to visit the Zippopotam.us website?

    No. Once the MCP is connected, your AI handles all the requests directly.

  • More questions about Zippopotam.us? The Connector page answers them. See everything the Zippopotam.us Connector can do

Connect Zippopotam.us to Claude, Cursor, ChatGPT & more