How to Use the Trimble MCP in Mastra AI

Q: How can I validate addresses using Trimble and Mastra AI?

You run the searchtrimbleaddress tool within your workflow to find specific commercial locations. If a location isn't found, Mastra AI's built-in error handling triggers an alternative notification or manual approval step.

Q: Does Trimble provide sufficient data for complex planning with Mastra AI?

The combination of calculatedrivingisochrone and calculatematrixrouting allows your agent to build a decision tree. For example, it can determine all reachable areas within time limits before committing to the final route calculation.

Build resilient logistics workflows with Mastra AI and the Trimble MCP Server.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Compliant Route Planning

The `calculate_truck_route` tool generates a compliant, optimized route between multiple stops using PC*MILER data. For high reliability, your Mastra AI workflow can automatically retry this calculation if initial routing fails. Moreover, the agent uses `route_by_vehicle_size` to ensure every generated route respects specific vehicle dimensions (height in inches and weight in lbs), handling failure modes gracefully.

Safety and Restriction Checking

Mastra AI can execute a workflow that verifies road restrictions using `get_truck_directions`. This tool checks bridge heights, HazMat rules, and weight limits to ensure the route is safe before moving on. If the check fails, your system can trigger an alternative plan. Another critical step is running `route_avoiding_roads`, which calculates a new path explicitly avoiding certain roads or expressways based on business logic.

Financial and Mileage Auditing

To ensure compliance, the workflow can calculate state mileage using `calculate_state_mileage`. This breaks down total route distance by US state or province. The system then estimates the full financial cost via `calculate_trip_tolls`, returning USD fees for both cash and electronic tolls. These steps allow Mastra AI to build a multi-step process that validates not just the path, but the entire economic feasibility of the trip.

Setup guide

Set up Trimble MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Trimble tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "trimble-mcp-client",
  servers: {
    "trimble-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Trimble Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Trimble tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Trimble transactions"
);
console.log(result.text);

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 Mastra AI

Mastra AI uses the MCP Server to run multi-step processes. You can build a workflow that first checks vehicle size, then calculates tolls, and if either step fails or returns an error code, it automatically retries using different parameters.

Yes. If the primary route calculation fails (e.g., due to a restriction), your Mastra AI workflow can be set up for automatic retries, potentially calling tools like `calculate_matrix_routing` as a fallback step.

The server handles geospatial coordinates (lon/lat), vehicle dimensions, mileage breakdowns by state, and financial data like toll fees in USD. This allows for comprehensive failure handling across different domains.

You run the `search_trimble_address` tool within your workflow to find specific commercial locations. If a location isn't found, Mastra AI's built-in error handling triggers an alternative notification or manual approval step.

The combination of `calculate_driving_isochrone` and `calculate_matrix_routing` allows your agent to build a decision tree. For example, it can determine all reachable areas within time limits before committing to the final route calculation.

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