How to Use the Zippopotam.us MCP in Cline

Q: How do I check city codes with Zippopotam.us and Cline?

You tell Cline to execute the lookupnearbycity tool, passing the city name as an argument. It runs the lookup, writes the data structure, and shows you the diff in your code.

Q: Can I find coordinates using Zippopotam.us and Cline?

Yes. You can run lookuppostcode to get precise lat/long from a postal code. Cline ensures that this data is correctly typed and used in the component it's building.

Write code that finds locations with Cline's end-to-end task execution.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zippopotam.us MCP to Cline

Create your Vinkius account to connect Zippopotam.us to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Zippopotam.us with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Running location lookups in Cline

Need to build a script that validates user input against real-world geography? You can use the `lookup_nearby_city` tool. Just tell Cline the city, and it runs the lookup, providing you with accurate zip codes and coordinates for your component. Alternatively, if you already have the postal code, run `lookup_postcode`. Cline executes this instantly, giving you a structured output that's ready to be used in the file it's writing.

Integrating location data into Cline’s workflow

This MCP Server lets your coding agent interact with global postal intelligence. It takes raw geographic concepts and outputs clean, structured JSON that you can import directly into a new component or test file. If you're staging a commit for a feature that relies on location data, Cline runs the lookup tools first, ensuring your code has fresh, validated coordinates.

Zippopotam.us utility within Cline

Use this MCP Server when writing backend logic for systems dealing with multiple national addresses. It helps validate if a city name or postal code is viable before the user ever sees it. Cline's power means you don't just get the data; it writes the function that uses `lookup_nearby_city` and stages the whole thing—API call, data processing, test file—all in one go.

Setup guide

Set up Zippopotam.us MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type zippopotamus-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Zippopotam.us refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "zippopotamus-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zippopotam.us. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Zippopotam.us now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Zippopotam.us MCP in Cline

You tell Cline to execute the `lookup_nearby_city` tool, passing the city name as an argument. It runs the lookup, writes the data structure, and shows you the diff in your code.

Yes. You can run `lookup_postcode` to get precise lat/long from a postal code. Cline ensures that this data is correctly typed and used in the component it's building.

The easiest way is to let Cline run a sequence of lookups—maybe checking both `lookup_nearby_city` and `lookup_postcode`—and then write a function that compares the results.

It supports lookups by city name via one tool, and lookups by postal code via another. Cline handles running these distinct operations sequentially for you.

This server primarily deals with public geographic data: city names, zip codes, and coordinates. It doesn't touch any sensitive user personally identifiable information.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript