How to Use the Zippopotam.us MCP in Vercel AI SDK

Q: Can I use Zippopotam.us with Vercel AI SDK to find zip codes?

Absolutely. You call the lookupnearbycity tool through your agent, and the results for zip codes are streamed right into your application interface. It's perfect for live map displays.

Q: What if I need to find a location by postal code with Zippopotam.us using Vercel AI SDK?

You use the lookuppostcode tool. The data—including the city and state associated with that postcode—streams immediately, allowing your user client to react instantly without any loading delays.

Display live global postal code data using the Vercel AI SDK.

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 Vercel AI SDK

Create your Vinkius account to connect Zippopotam.us to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-Time City Lookup with Vercel AI SDK

When you call `lookup_nearby_city`, your agent handles finding zip codes for a given city. Since this result streams directly into the UI, the user sees the list of results appearing in real time—no waiting for a loading spinner. The Vercel AI SDK ensures that when Zippopotam.us returns coordinates or state data, it flows instantly to your React component, making the whole experience feel live and immediate.

Postcode Location Lookup via Vercel AI SDK

The `lookup_postcode` tool lets you look up a location using just a postal code. Because it’s an Edge Function compatible call, this process executes fast, delivering the city and state data quickly. Your user's agent receives these structured coordinates from Zippopotam.us and streams them to the frontend right away, showing instant feedback as the data arrives.

Global Postal Intelligence with Vercel AI SDK

You can use both `lookup_nearby_city` and `lookup_postcode` together in a single user flow. The system passes the results from Zippopotam.us—like city, state, or zip code—and streams them back to your client. This means you build full-featured tools where users see the data appearing live on screen as your agent pulls global postal intelligence for them.

Setup guide

Set up Zippopotam.us MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Zippopotam.us tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Zippopotam.us transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

The Vercel AI SDK treats the Zippopotam.us MCP Server as a tool endpoint that streams data results directly into your UI components. You don't wait for a single response; you get real-time updates on coordinates and city names.

Absolutely. You call the `lookup_nearby_city` tool through your agent, and the results for zip codes are streamed right into your application interface. It's perfect for live map displays.

You use the `lookup_postcode` tool. The data—including the city and state associated with that postcode—streams immediately, allowing your user client to react instantly without any loading delays.

Yes. You can chain tool calls for both city and postal code lookups. The streaming mechanism handles the back-and-forth data flow, making complex searches appear effortless to the end user.

This MCP Server touches zip codes, city names, state identifiers, and geographical coordinates when your agent calls its tools. This is all structured data that streams to your client.

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