# KeepTruckin MCP

> KeepTruckin MCP manages your entire fleet and assets through natural language conversation. Track locations, check reefer sensors for cold chain compliance, analyze vehicle utilization metrics, and manage team dispatches—all without opening a dashboard. It puts real-time logistics control into your agent.

## Overview
- **Category:** shipping-logistics
- **Price:** Free
- **Tags:** asset-tracking, reefer-monitoring, telematics, dispatch-management, vehicle-utilization

## Description

Need to keep tabs on dozens of trucks, trailers, and high-value cargo? This MCP connects your KeepTruckin account directly to your AI client, letting you handle complex fleet operations using simple conversation. You don't need to log into separate portals or juggle multiple dashboards just to know if the temperature is stable or where Unit 47 is right now. Your agent acts as a single point of control for asset management and logistics monitoring. For example, you can ask it to list all company assets or immediately locate equipment by its external ID. It also handles cold chain concerns; simply asking about reefer activity reports gives you instant access to detailed temperature and humidity samples, ensuring your cargo stays safe from origin to destination. This integration lives right here on Vinkius, so once you connect your client, you gain immediate access to thousands of other specialized tools for your business needs.

## Tools

### list_assets
Gets a list of all company assets currently tracked by KeepTruckin.

### list_camera_connections
Retrieves records detailing camera connectivity events for compliance checks.

### create_asset
Adds a brand new asset record to your inventory system.

### create_team_dispatch
Organizes and creates team dispatches, assigning multiple drivers efficiently for one trip.

### locate_asset
Finds the current geographic location of a specific asset unit.

### lookup_asset_by_external_id
Retrieves all details for an asset using its unique external identification number.

### list_reefer_activity_reports
Generates a comprehensive report showing the activity history of refrigerated cargo units.

### list_reefer_sensor_samples
Provides detailed sensor samples, including temperature and humidity readings for reefers.

### update_asset
Modifies or updates information on an existing asset record.

### get_vehicle_utilization
Fetches detailed data showing how much a vehicle was used, including time and fuel metrics.

## Prompt Examples

**Prompt:** 
```
List all active assets in our fleet.
```

**Response:** 
```
I've retrieved the list of active assets. You have 12 assets currently active, including 'Truck-01' (ID: 55021) and 'Trailer-A' (ID: 55022). Would you like to locate one of them?
```

**Prompt:** 
```
Show me the utilization for vehicle ID 55021 from yesterday.
```

**Response:** 
```
Fetching utilization data for vehicle 55021... For yesterday, the vehicle had 6.5 hours of driving time, 42 minutes of idle time, and consumed 38.2 gallons of fuel over 310 miles.
```

**Prompt:** 
```
Locate asset ID 55022 and check its reefer status.
```

**Response:** 
```
Asset 55022 is currently located at 34.0522° N, 118.2437° W (Los Angeles, CA). The reefer activity report shows a set point of 34°F with an ambient temperature of 72°F. Fuel level is at 85%.
```

## Capabilities

### Inventory and Asset Management
List all company assets or look up a specific unit using an external ID number.

### Real-Time Location Tracking
Trigger immediate location updates to know exactly where any piece of equipment is right now.

### Cold Chain Compliance Monitoring
Access detailed reports and sensor samples, including temperature and humidity metrics, proving cargo safety was maintained.

### Performance Analysis
Fetch comprehensive vehicle utilization data that includes driving time, idle time, fuel usage, and distance traveled.

### Safety & Connectivity Checks
Monitor camera connection events to confirm the hardware status of vehicles and associated drivers.

### Dispatch Coordination
Create team dispatches, assigning multiple authorized drivers efficiently to a single trip.

## Use Cases

### Investigating a temperature deviation on cargo
A shipment arrived, and the client claims the reefer was unstable. Instead of manually sifting through logbooks or calling dispatch, you ask your agent to `list_reefer_activity_reports`. The system instantly pulls up the full history, showing when and where the temperature spiked so you can pinpoint the exact failure point.

### Re-routing a team for an emergency pickup
A client needs two trailers picked up simultaneously from different areas. Instead of coordinating assignments via phone calls, you tell your agent to `create_team_dispatch`, giving it the drivers and routes needed in one command.

### Auditing fleet inventory before year-end
You need a complete list of every piece of equipment owned by the company, regardless of its current status. You simply ask your agent to `list_assets` and get an instant, comprehensive report for accounting purposes.

### Checking a unit's history before sale
A potential buyer needs proof of usage for a specific truck model (ID 55021). You ask your agent to `get_vehicle_utilization` and get the exact mileage, idle time, and fuel consumption data over a specified period.

## Benefits

- Know where everything is: Instead of logging into multiple systems, you can simply ask to locate an asset or list all company assets using the `locate_asset` and `list_assets` tools. It's instant visibility across the whole operation.
- Guarantee cold chain safety: You don't have to worry about temperature logs. The MCP gives you access to `list_reefer_sensor_samples`, showing precise temperature and humidity readings so your cargo is always compliant.
- Stop manual dispatching: Assign multiple drivers for one job quickly. Use the `create_team_dispatch` tool to organize assignments without sending out a dozen emails or calling an office manager.
- Understand performance costs: Get immediate, granular vehicle utilization data (driving time, fuel used) via `get_vehicle_utilization`. This cuts down on manual spreadsheet work and helps you negotiate better fuel contracts.
- Keep compliance simple: Safety checks are easy. You can monitor camera connection events using `list_camera_connections` to ensure every vehicle is reporting its status properly.

## How It Works

The bottom line is that you get deep visibility into all physical assets and operations without ever leaving your chat interface.

1. Subscribe to this MCP and enter your KeepTruckin API Key.
2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a natural language question about your fleet or assets.

## Frequently Asked Questions

**How do I check the location of my assets with KeepTruckin MCP?**
You simply ask your agent to locate an asset. It provides the current geographic coordinates and status for any unit you specify, making real-time tracking instant.

**Can KeepTruckin MCP handle temperature compliance reports?**
Yes, it does. You can access detailed sensor samples using `list_reefer_sensor_samples`, which confirms if the cargo stayed within its required temperature range during transit.

**What is the best way to get performance data from KeepTruckin MCP?**
Use the `get_vehicle_utilization` tool. This fetches a comprehensive report detailing driving time, idle minutes, and fuel consumption for any given vehicle.

**How do I add new assets to my system using KeepTruckin MCP?**
You can create new asset records by calling the `create_asset` function. This tool handles the necessary inventory updates so the unit is ready for tracking immediately.

**Does KeepTruckin MCP help with driver assignments and trips?**
Yes, it manages this via team dispatches. You use `create_team_dispatch` to assign multiple authorized drivers efficiently in a single operation.