How to Use the Range MCP in Vercel AI SDK

Q: How do I filter Range updates in my Vercel AI SDK app?

Pass your targetid or foruserid parameters into the listupdates tool call. The Vercel AI SDK handles these arguments naturally within your tool definitions. This ensures you only pull the data relevant to the current user session.

Q: Can the Vercel AI SDK show all Range goals?

Yes, just call listgoals through the MCP client. The response maps directly to your frontend components, letting you render team progress lists instantly.

Stream your team updates directly into your UI using the Range MCP Server and Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Range MCP to Vercel AI SDK

Create your Vinkius account to connect Range to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Range with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Real-time sync for your AI-powered dashboard

Feed live team updates directly into your Next.js frontend without waiting for spinners. By connecting the `list_updates` tool, your interface populates with the latest check-ins as the AI processes them. Your users see information flowing live. It removes the friction of manual refreshes and keeps your app state synced with the actual work happening in your organization.

Query team objectives via AI SDK

Expose your high-level goals by mapping `list_objectives` to your generation functions. The AI client pulls the latest targets and displays them alongside relevant project data. This creates a clear link between daily tasks and company milestones. You build a UI that shows progress against real goals, not just static text.

Targeted updates with specific tool calls

Use `get_update` or `get_snippet` to pull granular details during user interaction. Your application logic triggers these calls to fetch deep context only when needed. It keeps your data payloads small and your application fast. You maintain full control over what information lands on the screen and when.

Setup guide

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

Pass your target_id or for_user_id parameters into the `list_updates` tool call. The Vercel AI SDK handles these arguments naturally within your tool definitions. This ensures you only pull the data relevant to the current user session.

Yes, just call `list_goals` through the MCP client. The response maps directly to your frontend components, letting you render team progress lists instantly.

It does. Since this MCP server uses standard HTTP transport, your edge functions connect to the endpoint and fetch data without cold-start delays.

Your Range data stays within your authorized scope. The server only accesses the specific snippets and objectives you explicitly request through the tool calls.

You need to provide your endpoint token during client initialization. Once set, the server manages your access to team records securely.

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