How to Use the Trimble MCP in Vercel AI SDK

Q: How does Trimble integrate with the Vercel AI SDK for routing?

The MCP Server provides tools like calculatetruckroute, which determines distance and time. When using the Vercel AI SDK, these results stream directly to your UI, making the route appear live rather than waiting for a batch response.

Q: Can I check vehicle restrictions with Trimble and the Vercel AI SDK?

Yes. The routebyvehiclesize tool lets you set specific dimensions (height in inches, weight in lbs). Your agent uses this data to calculate a truck route that adheres to those physical constraints.

Q: Does the Trimble MCP Server handle toll data for Vercel AI SDK?

It does. The calculatetriptolls tool estimates total costs in USD, providing both cash and electronic fee breakdowns for any specified truck route.

Q: What type of geographic coordinates can I process with Trimble and the Vercel AI SDK?

You can process raw longitude/latitude pairs using reversegeocode to find the nearest commercial address, or use them as input for calculating isochrones via calculatedrivingisochrone.

Real-time logistics results streaming directly into your UI 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 Trimble MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Dynamic Truck Routing on the Fly

The `get_truck_directions` tool pulls turn-by-turn directions while accounting for critical factors like bridge heights, weight limits, and HazMat restrictions. This means your AI client displays accurate routes immediately as data streams into the React frontend. The `calculate_truck_route` tool generates a compliant route polyline, distance, and estimated time using Trimble PC*MILER. Because results stream in real-time via Vercel AI SDK, users see the optimized path appear live on their map.

Geocoding and Location Validation

You can convert raw geographic coordinates into a commercial address using `reverse_geocode`. This function takes coordinate data and instantly provides the nearest commercial location, perfect for showing users where they are right now. The `search_trimble_address` tool lets your agent pull specific locations from the Trimble database. Streaming results means the user sees the suggested addresses populating in real-time as the client searches.

Complex Route Optimization and Toll Calculation

The `calculate_matrix_routing` tool calculates distances and travel times across multiple origins and destinations, giving your agent a comprehensive comparison view. Streaming this matrix allows users to compare several routes without waiting for a single loading spinner. Furthermore, the system estimates total toll costs using `calculate_trip_tolls`, returning cash and electronic fees in USD. Your Vercel AI SDK client displays these financial results as soon as they are calculated.

Setup guide

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

The MCP Server provides tools like `calculate_truck_route`, which determines distance and time. When using the Vercel AI SDK, these results stream directly to your UI, making the route appear live rather than waiting for a batch response.

Yes. The `route_by_vehicle_size` tool lets you set specific dimensions (height in inches, weight in lbs). Your agent uses this data to calculate a truck route that adheres to those physical constraints.

The server supports commercial addresses through tools like `search_trimble_address` and `reverse_geocode`. This means you can convert raw coordinates into a readable, verified commercial location.

It does. The `calculate_trip_tolls` tool estimates total costs in USD, providing both cash and electronic fee breakdowns for any specified truck route.

You can process raw longitude/latitude pairs using `reverse_geocode` to find the nearest commercial address, or use them as input for calculating isochrones via `calculate_driving_isochrone`.

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