Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Zippopotam.us with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Free geocoding and postal code lookup. retrieve city, state, and coordinates for any zip code or find postal codes by city.

Included with plan

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

Complete set · 2 capabilities

The complete Zippopotam.us capability set.

These are the exact actions your AI can choose when you ask it to work with Zippopotam.us.

Capability set01 / 01

01-02

2 capabilities in this set.

Part of 2 available through Zippopotam.us.

  1. 01

    Get location by postal code

    Get location information by postal code

  2. 02

    Get postal codes by city

    Get postal codes by city and state

Observed, not estimated

851ms average. Fast in production.

Zippopotam.us is checked daily against the live service.

Daily averagePeak 1067ms
Aug 20Today
Fastest day
705ms
Slowest day
1067ms
14-day trend
Improving-7%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 2 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 Zippopotam.us, so you can see the experience inside your AI.

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

Zippopotam.us Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/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-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_NLPd3qHtXaIgqvL9hmOUq9oZ5rRm4nvhR6G9FRBA/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

FAQ

Questions Zippopotam.us owners ask.

  • 01

    How can I find the latitude and longitude for a specific zip code?

    Use the get_location_by_postal_code capability. Provide the country code (e.g., 'us') and the postal code. The agent will return the city, state, and precise GPS coordinates.

  • 02

    Can I find all postal codes for a specific city?

    Yes. Use the get_postal_codes_by_city capability. You will need to provide the country, the state abbreviation (e.g., 'ca' for California), and the city name.

  • 03

    What format should I use for the country parameter?

    The API requires ISO 3166-1 alpha-2 country codes. For example, use 'us' for the United States, 'de' for Germany, 'fr' for France, or 'br' for Brazil.

Explore

More in Developer Tools

Suggestions