# Omnitracs Fleet Intelligence MCP

> Omnitracs Fleet Intelligence connects your Omnitracs account directly to your AI agent. It lets you query real-time data—vehicle GPS locations, driver status, shipment progress, and full fleet performance metrics—using natural conversation. You manage your entire logistics operation from chat.

## Overview
- **Category:** supply-chain
- **Price:** Free
- **Tags:** gps-tracking, telematics, logistics, driver-management, real-time-monitoring

## Description

Omnitracs Fleet Intelligence connects your Omnitracs account straight into your AI agent. You get direct access to every piece of operational data—vehicle location, driver status, shipment progress, and full fleet performance metrics—all through natural chat conversation. You manage the whole logistics operation without ever leaving your chat window.

Your agent doesn't just read a dashboard; it runs specific, live queries against the Omnitracs system when you ask questions. Here’s what you can do:

**Getting Real-Time Vehicle Status and Location:** You can check the exact coordinates and operational status for any vehicle in your fleet using `get_vehicle_location`. To get a full picture of every asset, run `list_fleet_vehicles` to generate a list of all registered vehicles along with their last known status. 

**Managing Drivers and Personnel:** When you need driver info, use `list_fleet_drivers` to pull up the names and IDs of everyone on file. You can then drill down into specific employee profiles by running `get_driver_details`, which retrieves a driver's full profile details. For immediate oversight of personnel communication, your agent uses `list_fleet_messages` to show recent text exchanges between dispatch and assets or drivers.

**Tracking Routes and Jobs:** You can see exactly what’s moving by running `list_active_routes`, which retrieves a list of all routes currently in progress or scheduled to start soon. For any specific route, you use `get_route_stops` to get a full list of every required stop location on that active ID. To track the cargo itself, run `list_fleet_shipments` to get a list of every shipment currently in transit or waiting for pickup. You can then check out an individual job's current status and details by running `get_shipment_status`, which takes either a tracking number or ID.

**Monitoring the Big Picture:** To analyze overall efficiency, you run `get_fleet_performance`, pulling aggregated metrics that show the total health and efficiency of the entire fleet. You can also get an instant status check on all shipments currently in motion by using `list_fleet_shipments`. 

This setup lets you monitor everything—assets, people, routes, and cargo—from a single place. You ask your agent questions like, “Where's Van-202 right now?” or “What’s the overall fuel efficiency for Q3?” The agent returns actionable data directly, not links to another portal. It’s like having an Operations Manager sitting in your chat window, giving you real-time answers.

## Tools

### get_driver_details
Retrieves specific profile details for a named or ID'd driver.

### get_route_stops
Lists all required stop locations for a specific, active route ID.

### get_shipment_status
Fetches the current status and details for an individual shipment tracking number or ID.

### get_vehicle_location
Returns the live GPS coordinates and operational status of a specific vehicle.

### list_fleet_drivers
Generates a list containing the names and IDs of all registered drivers on file.

### list_fleet_messages
Shows recent text messages exchanged between dispatch and assets/personnel.

### get_fleet_performance
Pulls aggregated metrics showing the overall health and efficiency of the entire fleet.

### list_active_routes
Retrieves a list of all routes that are currently in progress or scheduled to start soon.

### list_fleet_shipments
Lists all shipments that are currently in transit or waiting for pickup.

### list_fleet_vehicles
Generates a list of every vehicle registered to the fleet, including its last known status.

## Prompt Examples

**Prompt:** 
```
List all vehicles currently in my fleet.
```

**Response:** 
```
Retrieving fleet vehicles... I found 25 vehicles registered. Notable units include 'Truck-101' (Active), 'Van-202' (Maintenance), and 'Trailer-303'. Would you like the current GPS location for Truck-101?
```

**Prompt:** 
```
Where is driver 'John Doe' right now?
```

**Response:** 
```
Fetching driver status... John Doe is currently operating vehicle 'Truck-101'. His last reported location was near Chicago, IL, at 10:45 AM. He is currently 'On Duty' and has 4 hours remaining in his shift. Shall I list his assigned stops for today?
```

**Prompt:** 
```
Show me the performance report for the fleet this week.
```

**Response:** 
```
Generating performance report... For this week, your fleet averaged 6.5 MPG with a total idle time of 12%. You had 2 safety alerts for hard braking. Would you like to see which vehicles contributed most to the idle time?
```

## Capabilities

### Get Real-Time Vehicle GPS Location
Fetch the current coordinates and status for any vehicle in your fleet.

### Check Driver Status and Details
Retrieve a driver's profile, current duty status (e.g., On Duty, Off Duty), and full personal details.

### Monitor Shipment Progress
List active shipments and get their estimated delivery times or current status flags.

### View Active Routes and Stops
See which routes are currently running, plus a detailed list of all scheduled stops for those routes.

### Analyze Fleet Performance Metrics
Generate aggregated reports on the entire fleet's performance, including fuel usage and safety incident data.

### Review Dispatch Messaging History
List recent messages sent between dispatch and specific vehicles or drivers for immediate oversight.

## Use Cases

### Emergency Breakdown Check
A driver reports a breakdown near an unmarked location. Instead of calling dispatch and waiting for them to manually check, you ask your agent: 'What is the current GPS location for Truck-101?' The agent runs `get_vehicle_location` and tells you exactly where it broke down, saving critical minutes.

### Daily Manifest Review
It's 8 AM. You need to know which shipments are ready for pickup today. You ask your agent: 'List all active shipments.' The tool runs `list_fleet_shipments`, giving you the names and IDs of every container waiting, letting you build your manifest immediately.

### Driver Compliance Check
You need to verify if a driver has completed their shift or needs an extension. You ask: 'Check John Doe's profile.' The agent uses `get_driver_details`, pulling up his current duty status and any recorded hours remaining.

### Route Deviation Audit
A shipment is late, and you suspect the route was wrong. You ask your agent to compare the route: 'Show me the stops for Route 45.' The tool uses `get_route_stops` and lets you see if any scheduled stops were missed or skipped.

## Benefits

- See where every asset is in real time. Instead of logging into a dedicated portal, you just ask the agent to use `get_vehicle_location` and get the current GPS data for any truck or trailer.
- Manage personnel compliance instantly. Use `list_fleet_drivers` to check who's on duty right now and then run `get_driver_details` if you need their full profile information.
- Know exactly where your goods are. Listing shipments with `list_fleet_shipments` gives an overview, but running `get_shipment_status` provides the confirmed ETA for that specific cargo.
- Automate performance reports. Don't spend an hour compiling spreadsheets. Just ask for fleet metrics and let the agent use `get_fleet_performance` to pull aggregated data instantly.
- Track routes step-by-step. You can list all active journeys with `list_active_routes`, and then drill down using `get_route_stops` to inspect every stop point on that route.
- Keep communication organized. The agent uses `list_fleet_messages` so you don't have to hunt through emails or separate dispatch logs—it pulls the recent chat history directly.

## How It Works

The bottom line is: your AI client acts as a translator between your natural questions and the complex backend APIs of Omnitracs.

1. First, subscribe to the Omnitracs server and provide your API Key.
2. Your AI client then uses natural language (e.g., 'List all vehicles in the maintenance bay') to determine which tool to call.
3. The agent executes the specific function (like `list_fleet_vehicles`), pulls the data from Omnitracs, and formats it for you.

## Frequently Asked Questions

**How do I check a vehicle's live location using get_vehicle_location?**
You simply tell your agent: 'What is the current GPS location for my fleet?' The agent runs `get_vehicle_location`, pulling the real-time coordinates and status directly from Omnitracs.

**Does list_fleet_shipments show me where the cargo is?**
Yes, it lists all active shipments. But if you need the specific ETA or current status of one container, run `get_shipment_status` instead for deeper detail.

**What's the difference between listing vehicles and getting performance metrics?**
Using `list_fleet_vehicles` gives you a roster (who is in the fleet). Running `get_fleet_performance` generates an analyzed report card, showing averages like fuel efficiency or safety incident counts.

**Can I see who is driving right now with list_fleet_drivers?**
Yes. Use `list_fleet_drivers` to get the roster of all personnel. To check their specific status, follow up by asking for details using `get_driver_details`.

**If I need to check all stops for a specific journey, how do I use get_route_stops?**
It retrieves a detailed list of scheduled and active stops for any given route ID. The data includes precise location coordinates, expected service times, and the sequence order for the entire itinerary.

**What specific information does get_driver_details provide about a driver?**
This tool gives comprehensive profile details beyond just their current status. You can pull data like their assigned department, license expiration dates, and remaining hours for shift compliance checks.

**How do I review recent operational communications using list_fleet_messages?**
It fetches a chronological log of all text updates exchanged between dispatch and the vehicles or drivers. This lets you track specific instructions, incident reports, or confirmations given out.

**If I need the precise details for one single delivery, should I use get_shipment_status?**
Yes, this function provides an immediate status report on a single shipment ID. You'll find milestone tracking, current estimated arrival times, and any reported delays from the carrier.

**How do I get an Omnitracs API Key?**
You can obtain an API key by contacting your Omnitracs account representative or through the Omnitracs Customer Portal under the API/Integration settings section.

**Can I see real-time GPS locations?**
Yes! Use the `get_vehicle_location` tool with a specific vehicle ID to retrieve the latest reported GPS coordinates and status.

**What metrics are included in fleet performance?**
Performance metrics typically include fuel consumption data, engine hours, safety events (like hard braking), and overall idle time across the fleet.