# Trimble Logistics MCP

> Trimble calculates complex truck routes using enterprise-grade data for fleet managers. It determines accurate driving times, estimates total toll costs, and ensures compliance by calculating state mileage for fuel tax reporting. This MCP handles everything from routing around tight bridges to mapping optimal delivery zones.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** fleet-management, routing, geocoding, logistics, fuel-tax-reporting, spatial-analysis

## Description

Need to plan a haul across multiple states? Don't waste time guessing if your rig can make the drop-off or what the final cost will be. This MCP connects your agent directly to Trimble PC*MILER logistics infrastructure, giving you real-time visibility over complex transport routes. You can ask it to calculate total toll fees for a full trip, breaking down both cash and electronic costs mathematically. Need to know if that route avoids restricted zones or narrow bridges? The system handles those physical constraints automatically. When routing gets complicated—like needing an exact estimate of how far you can travel in one hour from a depot—you just ask your AI client, and it generates the precise boundary map. Accessing this level of detailed logistics data is made simple when connected through Vinkius, allowing any compatible agent to use these tools instantly.

## Tools

### calculate_driving_isochrone
Finds the area you can reach from a center point within a specific amount of time.

### calculate_matrix_routing
Calculates the distances and travel times between several starting points and ending points at once.

### calculate_state_mileage
Breaks down a trip's total mileage by every US state or province it crosses for tax reporting.

### calculate_trip_tolls
Estimates the exact dollar cost, separating cash and electronic fees, for an entire truck route.

### calculate_truck_route
Computes a comprehensive, truck-safe path between multiple stops using specialized logistics data.

### get_truck_directions
Provides turn-by-turn driving directions while accounting for specific physical limits like bridge height and weight restrictions.

### route_avoiding_roads
Calculates a route that explicitly skips certain public roads or restricted expressways.

### route_by_vehicle_size
Generates a truck path specifically tailored using provided vehicle height and weight measurements.

### search_trimble_address
Searches the Trimble database to find specific locations and commercial addresses.

### reverse_geocode
Converts raw geographic coordinates into the nearest recognizable commercial address.

## Prompt Examples

**Prompt:** 
```
Calculate a truck route starting from -74.0,40.7 to -75.0,41.0.
```

**Response:** 
```
Route computed successfully. The total truck-safe distance spans 85.3 miles. Expected travel time is approximately 1 hour and 32 minutes along main highways based on these parameters.
```

**Prompt:** 
```
What are the estimated toll costs passing that exact same route?
```

**Response:** 
```
Checking toll estimators. The total calculated fees are 12.50 USD utilizing verified electronic transponders, scaling higher unpredicted if operating on cash lanes continuously.
```

## Capabilities

### Calculate routes avoiding obstacles
Generates a truck-compliant path that respects specific dimensions like height and weight.

### Estimate total trip costs
Calculates the combined cash and electronic fees for tolls along any given route.

### Report state mileage accurately
Generates summaries that break down precise fuel-tax (IFTA) mileage crossed within individual states.

### Map service area reach
Determines the maximum geographical area reachable from a point given a set time limit.

### Determine multi-stop travel times
Calculates total distances and estimated driving times between multiple start and end points.

## Use Cases

### Planning an interstate haul through multiple states
A fleet manager asks the agent to plan a route from Texas to New York. The agent uses `calculate_truck_route` and then runs `calculate_state_mileage` on the result, instantly providing the compliance report needed for tax filing.

### Determining feasibility around construction zones
A dispatch analyst needs to know if a client's factory can be reached by an oversized vehicle. The agent uses `route_by_vehicle_size` and then runs `get_truck_directions` to confirm the entire path avoids low bridges or weight limits.

### Calculating total budget for complex routes
A sales team member asks how much a cross-country delivery will cost. The agent uses `calculate_trip_tolls` on the initial route to give an accurate, detailed toll estimate, preventing unexpected overhead costs.

### Mapping service boundaries for new clients
A data scientist wants to show a client their maximum delivery area. The agent uses `calculate_driving_isochrone` with the client's main depot coordinates and a fixed time limit, generating a clear service boundary map.

## Benefits

- Avoid costly delays by getting real-time toll estimates. Use `calculate_trip_tolls` to know the exact dollar impact of cash lanes versus electronic transponders before you even hit the road.
- Ensure regulatory compliance every time. The `calculate_state_mileage` tool handles complex fuel-tax reporting (IFTA), giving you precise mileage summaries broken down by state for accounting.
- Never risk a breakdown or accident due to physical constraints. Use `get_truck_directions` and `route_by_vehicle_size` to guarantee the calculated route clears specific bridge heights, weight limits, or HazMat restrictions.
- Plan multi-stop hauls with confidence. Instead of mapping each segment separately, use `calculate_matrix_routing` to get total distances and times between dozens of points in one query.
- Optimize delivery reach quickly. If you need to know what a depot can service within four hours, `calculate_driving_isochrone` generates that maximum reachable zone boundary immediately.

## How It Works

The bottom line is you get enterprise-grade logistics intelligence without needing specialized GIS software.

1. First, provision this connector inside your Vinkius catalog and inject your certified Trimble Developer API Key.
2. Second, tell your agent the necessary parameters, like starting coordinates, destination addresses, or required vehicle dimensions.
3. Third, your AI client invokes the correct tool to generate a detailed route plan, total cost breakdown, or compliance report.

## Frequently Asked Questions

**How does Trimble MCP handle toll costs?**
The `calculate_trip_tolls` tool estimates the total fees for your route. It specifically breaks down whether you'll pay using verified electronic transponders or standard cash lanes.

**Can I calculate a route that avoids specific roads?**
Yes, use `route_avoiding_roads`. You specify the restricted expressways or public roads, and the MCP computes an alternate path that respects those exclusions.

**What if my vehicle dimensions change the route?**
The `route_by_vehicle_size` tool is designed for this. You provide your truck's height and weight, and it recalculates the entire path to ensure safety clearance.

**How do I get tax-compliant mileage using Trimble MCP?**
For fuel tax (IFTA) purposes, run `calculate_state_mileage`. This tool takes a full route and gives you the precise miles driven inside each specific US state or province.

**What is an isochrone calculation with Trimble MCP?**
An isochrone calculates your maximum reachable area from one point within a fixed time limit. You use `calculate_driving_isochrone` to visualize this service radius for planning.