How to Use the Country Data Resolver MCP in Vercel AI SDK

Stream ISO country codes directly into your Vercel AI SDK frontends for live, real-time data rendering.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Country Data Resolver MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live code resolution for Vercel AI SDK

The `resolve_country` tool pushes raw alpha-2 codes into full, readable country names instantly. Your React or Next.js components receive these updates as the AI processes them, meaning your users see the final country name on screen without waiting for a backend round trip. This MCP Server handles the lookup logic while your frontend focuses on the layout. You get alpha-3 and numeric codes delivered alongside the name, keeping your data structures clean and consistent.

Real-time international data display

Stop showing cryptic country codes in your UI. This tool maps inputs to localized strings in English, Portuguese, Spanish, or French, ensuring your Vercel AI SDK project speaks the user's language. Simply pass the code and the target language to the tool. The result streams through your pipe immediately, letting you update the DOM as soon as the data arrives.

Edge-ready country lookups

This server runs perfectly inside Edge Functions, keeping your Vercel AI SDK latency low. You aren't hitting a heavy database for simple lookups, so your application stays fast. Just configure your client to connect to the provided endpoint. The tool performs the translation, and your app renders the output before the user even notices a delay.

Setup guide

Set up Country Data Resolver 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 Country Data Resolver 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 Country Data Resolver 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 i18n-iso-countries. 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 Country Data Resolver 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 Country Data Resolver MCP in Vercel AI SDK

Install the MCP package and point your client to our Vinkius endpoint. You then pass the tool definition into your streamText call to give your model the power to resolve codes.

Yes, you can specify the language parameter when calling the tool. It returns the country name in the requested language immediately.

You can loop through your data array and trigger the tool for each code. The SDK handles the sequence, and you get the resolved names back in your stream.

We pull from standard ISO registries. The tool provides the official alpha-2, alpha-3, and numeric codes for every entry.

We only process the country codes you send. Vinkius keeps the connection encrypted, and we never store your input data once the lookup finishes.

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