How to Use the IPGeolocation (IP Intelligence & Time) MCP in Vercel AI SDK
Get real-time IP data and local time streaming directly into your Next.js UI using the Vercel AI SDK.
Works with every AI agent you already use
…and any MCP-compatible client
Connect IPGeolocation (IP Intelligence & Time) MCP to Vercel AI SDK
Create your Vinkius account to connect IPGeolocation (IP Intelligence & Time) 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.
Stream instant IP location data in Vercel AI SDK
The `get_location` tool resolves incoming user IP addresses to precise coordinates and ISP data instantly. Your AI client calls this MCP Server tool during a streaming session, letting you render customized local content before the connection closes. This setup avoids the typical loading spinner delay on your frontend. Because it runs on Edge Functions, the IP check executes close to the user, shaving off 100ms of latency compared to traditional backend lookups.
Resolve local timezones on the fly
The `get_timezone` tool provides the exact local time and UTC offset for any resolved IP address. Your frontend agent reads this offset to schedule local events or adjust delivery windows directly in the UI. You don't have to write complex timezone translation libraries or maintain massive database tables. The MCP client handles the translation, feeding structured time data straight into your React components.
Display local sun and moon phases in real time
The `get_astronomy` tool extracts sunrise, sunset, and current moon phases based on the user's IP. Your streaming interface updates dynamically to reflect whether it is day or night at the user's physical location. This direct data injection allows you to toggle dark modes or display local weather-related UI elements dynamically. The Vercel AI SDK processes this astronomy payload on the fly, keeping your client code lightweight. Connecting through this MCP Server setup simplifies your architecture.
Set up IPGeolocation (IP Intelligence & Time) MCP in Vercel AI SDK
Prerequisites
- Node.js 18+ and a TypeScript project
-
ai+@modelcontextprotocol/sdkpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install ai @modelcontextprotocol/sdkplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Create the Streamable HTTP transport
Use
StreamableHTTPClientTransportwith 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 IPGeolocation (IP Intelligence & Time) tools. Pass them directly togenerateText()orstreamText()— 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.
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 IPGeolocation (IP Intelligence & Time) transactions",
});
console.log(text);
await mcpClient.close();Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IPGeolocation. 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.
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 IPGeolocation (IP Intelligence & Time) MCP in Vercel AI SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the IPGeolocation (IP Intelligence & Time) MCP today
We host it, we monitor it, we maintain it. You just paste one token.
