How to Use the Geocodio MCP in Vercel AI SDK

Q: Can Vercel AI SDK stream batch geocoding results from Geocodio?

Yes. When your agent calls batchgeocodeaddresses, the framework streams the resulting coordinate array back to your React or Svelte UI as it resolves.

Q: What happens if an address fails to parse?

The geocodeusaddress tool returns a match failure. Your agent sees this context and can prompt the user for clarification right in the chat interface.

Stream US and Canadian geocoding data directly into your React frontends 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 Geocodio MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Coordinates with the Vercel AI SDK MCP Server

The `geocode_us_address` tool parses raw text into precise latitude and longitude boundaries across US and Canadian maps. When a user types a messy address into your Next.js app, this tool hits the geocoder and fixes the formatting instantly. You get clean coordinate data streaming straight to the client without a loading spinner. Building location features usually means stringing together REST endpoints and managing state. You skip that completely here. Pass this MCP tool to `streamText`, and your users watch the map center on their exact location in real time.

Enrich User Profiles with Census Data

The `geocode_enriched_fields` tool extracts structural properties like congressional districts, census tracts, and school zones based on a single location string. Your agent grabs this legislative data and pushes it directly into the UI. You don't have to maintain massive shapefile databases. You can also flip the operation. Send coordinates through `reverse_enriched_fields` to pull the same structured district rules. If someone clicks a map pin, your Vercel AI SDK app immediately shows them their local representatives.

Batch Process Messy Inputs

The `batch_geocode_addresses` tool identifies precise active arrays spanning native location geometries for thousands of inputs at once. Users often upload spreadsheets full of terrible address formatting. Your agent takes the whole list and processes it in one shot. Combine this with `format_coordinate_string` to provision highly-available JSON payloads from those results. The frontend gets a clean array of geocoded points ready for plotting, while the SDK handles the asynchronous streaming under the hood.

Setup guide

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

Install @ai-sdk/mcp. Use createMCPClient with your HTTP transport URL, then pass the Geocodio tools directly into generateText or streamText.

Yes. When your agent calls batch_geocode_addresses, the framework streams the resulting coordinate array back to your React or Svelte UI as it resolves.

The geocode_us_address tool returns a match failure. Your agent sees this context and can prompt the user for clarification right in the chat interface.

Yes. Both the forward and reverse geocoding tools natively trace coordinates across US and Canadian boundaries.

Vinkius runs this integration in an ephemeral V8 Isolate Sandbox. Raw street addresses and coordinates pass through to the API without being logged or stored by our infrastructure.

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