How to Use the ZIP Codes API MCP in Vercel AI SDK

Q: How do I search for ZIP Codes API results using Vercel AI SDK?

You call findzipsbycity with the city and state, then stream those results. The Vercel AI SDK handles piping that JSON data directly into your user interface in real time.

Q: What if I need to find ZIP Codes API by county using Vercel AI SDK?

Just use the findzipsbycounty tool. Since it's an MCP Server, your agent client can execute that call and stream all results back to your React frontend for display.

Q: Can Vercel AI SDK handle radius searches with ZIP Codes API?

Absolutely. The findzipsinradius tool finds codes within a given mile range of a starting ZIP. You pass the inputs, and your streaming client displays the resulting list as it comes in.

Q: What is the best way to query ZIP Codes API by state with Vercel AI SDK?

Use findzipsbystate. Your streaming client will take the list of results and let you render them dynamically, improving the perceived speed for your end user.

Real-time ZIP Code Data Streaming with 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 ZIP Codes API MCP to Vercel AI SDK

Create your Vinkius account to connect ZIP Codes API 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 ZIP Codes API with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check ZIPS by City, State

The `find_zips_by_city` tool pulls all relevant ZIP codes using just a city and state name. This means your Next.js frontend can display results instantly as the user types, streaming the list directly into the React component. You won't wait for a loading spinner anymore. Your AI client streams the data from this MCP Server right into the UI, giving users immediate feedback on their location lookups.

Get Distance Between ZIPs

Use `get_zip_distance` to calculate the exact miles separating any two ZIP codes. This function returns a precise numerical value that your client can immediately render into a map view or a simple metric card. Because this data streams through the Vercel AI SDK, users see the calculated distance appear live. It's perfect for real-time logistics checks right in the browser.

Fetch Geographic Details

The `get_zip_details` tool grabs rich geographic and demographic information for any single ZIP code you provide. Your agent can use this to flesh out a profile page, showing more than just the postal code. When your client calls this function via the streaming endpoint, the detailed JSON data appears piece by piece in the UI. This makes complex lookups feel snappy and responsive.

Setup guide

Set up ZIP Codes API 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 ZIP Codes API 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 ZIP Codes API 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 ZIP Codes API. 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 ZIP Codes API 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 ZIP Codes API MCP in Vercel AI SDK

You call `find_zips_by_city` with the city and state, then stream those results. The Vercel AI SDK handles piping that JSON data directly into your user interface in real time.

Just use the `find_zips_by_county` tool. Since it's an MCP Server, your agent client can execute that call and stream all results back to your React frontend for display.

Absolutely. The `find_zips_in_radius` tool finds codes within a given mile range of a starting ZIP. You pass the inputs, and your streaming client displays the resulting list as it comes in.

This server touches geographic and demographic data (ZIP codes). Since you're building user-facing products, make sure your authProvider handles token scope restrictions carefully.

Use `find_zips_by_state`. Your streaming client will take the list of results and let you render them dynamically, improving the perceived speed for your end user.

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