# Axle MCP MCP

> Axle MCP delivers real-time visibility for entire logistics operations. Your agent tracks vehicle GPS locations, audits driver Hours of Service (HOS), monitors load progress, and pulls specific shipping documents without needing a dedicated dashboard.

## Overview
- **Category:** shipping-logistics
- **Price:** Free
- **Tags:** logistics-automation, vehicle-tracking, driver-management, shipment-monitoring, transportation-management, supply-chain-visibility

## Description

Managing a fleet means juggling location data, compliance records, and physical paperwork—it’s complex. By connecting Axle via Vinkius, your agent becomes the central dispatch coordinator. You stop interacting with heavy transportation dashboards and start talking to your system. Your agent can instantly pinpoint where any vehicle is right now, check if a driver has enough hours left for today, or pull the manifest for an active load just by asking. If you're managing anything from local deliveries to cross-country hauls, this MCP lets your AI client handle the real-time status checks and document retrieval automatically.

## Tools

### get_account_check
Runs a check to verify Axle's connection and overall system health.

### get_driver_availability
Checks how many hours of service (HOS) a specific driver has left today.

### get_driver
Retrieves specific profile information for any driver in the system.

### get_load
Pulls detailed information for one particular shipment load.

### get_vehicle_location
Returns the last known GPS location of a specific vehicle in the fleet.

### get_vehicle
Gets the full profile details for a single vehicle by its ID or VIN.

### list_documents
Retrieves all scanned shipping documents attached to various shipments.

### list_drivers
Lists every driver profile currently registered in the system.

### list_loads
Generates a list of all active and past shipments/loads managed by Axle.

### list_vehicles
Lists every vehicle currently registered in the entire fleet.

### update_driver_status
Changes a driver's current duty status, such as moving them from 'On Duty' to 'Driving'.

### update_load
Updates key details about an active load or shipment progress.

## Prompt Examples

**Prompt:** 
```
Where is vehicle ID 'TRUCK-101' right now?
```

**Response:** 
```
Checking GPS location for TRUCK-101... The vehicle was last seen 2 minutes ago at 123 Main St, moving at 45 mph heading North.
```

**Prompt:** 
```
List all active loads and their current status.
```

**Response:** 
```
I've retrieved 5 active loads. Load #9876 is 'In Transit' to Chicago, while Load #5432 is 'Pending Dispatch'. Would you like full details for any of them?
```

**Prompt:** 
```
Check the available Hours of Service (HOS) for driver 'John Doe'.
```

**Response:** 
```
Driver John Doe has 4 hours and 15 minutes of drive time remaining for today. His current duty status is 'Driving'.
```

## Capabilities

### Check System Status
Verifies the connection integrity of Axle and reports on current system health.

### List Vehicles
Provides a full roster of all vehicles registered in your fleet, along with their technical details.

### Locate Vehicle
Retrieves the last known GPS coordinates and status for any specific vehicle ID.

### Audit Drivers
Lists all drivers, checks their current duty status, and verifies remaining Hours of Service (HOS).

### Manage Loads
Retrieves details on specific shipments or allows you to update the progress of an active load.

### Access Documents
Pulls scanned shipping manifests and required paperwork linked to a particular shipment for auditing.

## Use Cases

### The urgent roadside check
A field supervisor asks: 'What's the status of Load #9876 and where is the truck?' The agent uses `get_load` to confirm the destination and then calls `get_vehicle_location` to give the precise GPS coordinates, solving the query in one turn.

### The end-of-day compliance audit
A Compliance Officer asks: 'Check HOS for all drivers on Route 3.' The agent iterates through `list_drivers`, calling `get_driver_availability` for each one, and reports a summary of remaining hours to ensure no overruns.

### The manifest retrieval
A Logistics Coordinator needs the paperwork for a load that was completed last week. They ask the agent to pull documents using `list_documents` linked to the specific shipment ID, bypassing manual file searches.

### The status update workflow
After a driver arrives at a depot, instead of logging into the system, the manager just tells their agent: 'Set John Doe's status to Off Duty.' The agent calls `update_driver_status` and confirms the change.

## Benefits

- Real-time location data: Use `get_vehicle_location` to know exactly where a vehicle is without calling the dispatcher. You get immediate GPS coordinates right in your conversation thread.
- Compliance checks made easy: Never manually calculate HOS again. The `get_driver_availability` tool instantly tells you if a driver has enough driving time left, preventing regulatory issues.
- Full asset visibility: Need to know everything about the fleet? Running `list_vehicles` gives you all registered assets, while `list_drivers` provides the personnel roster.
- Documentation instant access: Instead of digging through shared drives, calling `list_documents` pulls up scanned shipping manifests linked directly to a specific load for immediate auditing.
- State management in plain text: You can use `update_driver_status` or `update_load` and simply tell your agent what needs changing. It handles the API write operation automatically.

## How It Works

The bottom line is that you just talk to your agent; it handles all the API calls and data formatting for you.

1. Subscribe to the Axle MCP on Vinkius, then enter your specific API Key and Base URL into your preferred AI client.
2. Your agent sends a natural language query (e.g., 'Where is truck 401?'), which triggers the correct tool call within the MCP framework.
3. The MCP executes the necessary lookup against Axle's endpoints, returning structured data (like location coordinates or HOS remaining) directly to your chat interface.

## Frequently Asked Questions

**Can Axle MCP track vehicles in real time?**
Yes. Using `get_vehicle_location` lets you pull the last known GPS coordinates of any vehicle instantly, keeping you updated on its position.

**How do I check if a driver can still work today using Axle MCP?**
You run the `get_driver_availability` tool. It checks the specific profile to tell you exactly how many hours of service (HOS) that driver has left for compliance.

**What does 'list_loads' do with Axle MCP?**
Running `list_loads` gives you a comprehensive list of all active and past shipments, which acts as your central index for everything moving through the system.

**Can I update load information using the Axle MCP?**
Yes. You can use `update_load` to change shipment details or status directly via natural language commands, minimizing manual data entry errors.

**How do I use the `get_account_check` tool to verify my Axle API connection?**
It confirms that your credentials and general system health are working before you run any complex queries. Running this first step ensures reliable data retrieval, preventing wasted time on failed calls.

**What does `update_driver_status` do with Axle MCP?**
This tool lets your agent manually adjust a driver's current duty status. You can change them from 'Driving' to 'On Break' or 'Off Duty,' which is critical for maintaining accurate compliance records.

**If I need scanned paperwork, how do I use the `list_documents` tool?**
The `list_documents` tool pulls all associated shipping manifests and supporting paperwork. You just need to provide a load or vehicle ID to get instant access for auditing purposes.

**What is the function of `list_drivers` in Axle MCP?**
It generates a complete directory of every driver profile managed by the system. You use this when you need an overview or audit list of all personnel records, rather than checking one specific person.

**How can I check if a vehicle is currently moving?**
Use the `get_vehicle_location` tool. It returns the last known GPS coordinates, speed, and heading for the specified vehicle ID.

**Can I update a driver's status through the agent?**
Yes. Use the `update_driver_status` tool and provide the new duty status (e.g., 'On Duty', 'Driving', or 'Off Duty') to keep your logs accurate.

**How do I access shipping documents for a load?**
Use the `list_documents` tool. It retrieves all scanned paperwork associated with your shipments, allowing your agent to audit or summarize the contents.