How to Use the Upper Route Planner MCP in Vercel AI SDK

Q: How do I check the status of Upper Route Planner using Vercel AI SDK?

Just call the checkupperstatus tool. Your agent can stream this result directly into your React component, confirming the MCP Server's operational status immediately.

Q: Can I get specific stop details using Upper Route Planner with Vercel AI SDK?

Absolutely. After getting a route ID, you call getupperstopdetails and stream the results. This lets you display detailed information for any point on the delivery path right in your client's interface.

Q: What is the best way to start planning routes with Upper Route Planner using Vercel AI SDK?

Start by calling listupperroutes to see existing paths. Then, if you need a new path, use createupperdeliverytask. The real power here is seeing those changes stream into the user view in real-time.

See optimized delivery routes appear live in your Next.js app 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 Upper Route Planner MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time Route Status Checks

You call `check_upper_status` to confirm the API is up and running. This lets you build client features that instantly validate service availability before showing any data. When a user requests route information, your agent can use `get_upper_route_stop` and stream those results directly into the React UI. The data appears live, skipping the usual loading spinner.

Scheduling New Delivery Tasks

`create_upper_delivery_task` lets your application programmatically add new jobs. This is perfect for forms where users submit a package drop-off location. Your agent can process the user input and immediately execute this tool call via `mcpClient`. The resulting task ID streams back, so the UI updates right as you hit send.

Retrieving Driver Lists

Use `list_upper_drivers` to pull a roster of available delivery personnel. This tool populates dropdown menus or initial status reports within your web application. Your client can fetch this list and then use the driver IDs in subsequent calls, like getting specific route details with `get_upper_stop_details`. Everything flows into the frontend without delay.

Setup guide

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

Just call the `check_upper_status` tool. Your agent can stream this result directly into your React component, confirming the MCP Server's operational status immediately.

The server handles delivery driver list information. When you use `list_upper_drivers`, your agent gets the names and IDs of all available personnel to display in your UI.

Absolutely. After getting a route ID, you call `get_upper_stop_details` and stream the results. This lets you display detailed information for any point on the delivery path right in your client's interface.

Start by calling `list_upper_routes` to see existing paths. Then, if you need a new path, use `create_upper_delivery_task`. The real power here is seeing those changes stream into the user view in real-time.

The server manages delivery task creation. Your agent processes the necessary inputs (like location and items) and sends them to `create_upper_delivery_task`. The client handles tokenization, but the raw data type is the new delivery task record.

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