# Driving Shift Planner MCP for AI Agents MCP

> Driving Shift Planner helps logistics managers and long-haul drivers plan complex routes while staying compliant with safety regulations. It automatically calculates mandatory rest periods, breaks down long trips into legal driving segments, and verifies that your planned itinerary doesn't violate labor laws. If you need to know exactly when a driver can legally pull over or how long a 1,000km trip will actually take with required breaks, this is the tool to use.

## Overview
- **Category:** transportation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cIbk4vDeCXQ9ziBUDX9kinMRkQlhwuATgDrUWQVG/mcp
- **Tags:** driving, logistics, safety, planning, itinerary

## Description

Planning a cross-country haul isn't just about the distance between two points; it's about the legal requirements of the road. If you're trying to move freight across state lines, you have to juggle driving limits, mandatory rest windows, and shift changes without getting hit with heavy fines or risking driver fatigue. This MCP takes that manual math off your plate by letting your AI agent handle the heavy lifting of schedule construction. Instead of pulling out a spreadsheet to figure out where a driver needs to stop for a 30-minute break or how many hours they have left before they hit a limit, you can just ask your agent to build a viable itinerary. It handles the logic of splitting a 12-hour drive into compliant segments. You can see the full schedule of driving blocks and rest periods in one view, ensuring everyone stays safe and on schedule. By connecting this to the Vinkius catalog, you get a reliable way to turn raw trip data into a legally sound roadmap. It’s about moving from guessing the timing to knowing the schedule before the truck even leaves the lot.

## Tools

### verify_drive_compliance
Check if a specific driving segment meets all legal time limits and safety requirements. This helps you avoid fines by catching illegal shifts before they start.

### calculate_total_duration
Determine the total elapsed time for a journey, including all required rest periods. This ensures your delivery estimates stay accurate even with mandatory breaks.

### get_driving_itinerary
Create a full schedule of driving segments and mandatory breaks for a long-distance trip. It builds a complete roadmap for your drivers to follow.

## Prompt Examples

**Prompt:** 
```
I need a schedule for a 600km trip at 80km/h. The driver needs a 30-minute break every 3 hours. What's the plan?
```

**Response:** 
```
Here is your driving schedule for a 600km trip at 80km/h with 30-minute breaks every 3 hours:

| Segment | Activity | Duration |
| :--- | :--- | :--- |
| 0h to 3h | Driving | 3 hours |
| 3h to 3:30h | **Rest Period** | 30 minutes |
| 3:30h to 6h | Driving | 3 hours |
| 6h to 6:30h | **Rest Period** | 30 minutes |
| 6:30h to 9h | Driving | 3 hours |
| 9h to 9:30h | **Rest Period** | 30 minutes |
| 9:30h to 12h | Driving | 3 hours |
| 12h to 12:30h | **Rest Period** | 30 minutes |
| 12:30h to 15h | Driving | 3 hours |

**Total Trip Time: 15 hours**
```

**Prompt:** 
```
Is it legal for a driver to do a 5-hour straight drive if the limit is 4 hours?
```

**Response:** 
```
No, that 5-hour driving segment is not legal.

Since your limit is 4 hours, this segment exceeds the maximum allowed driving duration. You will need to split this into two segments with a mandatory rest period in between to stay compliant.
```

**Prompt:** 
```
How long will a 1,200km trip take if we have to stop for 45 minutes every 4 hours of driving?
```

**Response:** 
```
For a 1,200km trip at 100km/h with 45-minute rests every 4 hours, here is the breakdown:

*   **Driving Time:** 12 hours
*   **Rest Periods:** 3 stops (45 minutes each)
*   **Total Elapsed Time:** 13 hours and 45 minutes

Your total journey time will be **13 hours and 45 minutes**.
```

## Capabilities

### Generate full itineraries
Create a complete schedule of driving blocks and mandatory rest periods for long trips.

### Check segment legality
Verify if a specific planned driving duration meets all safety and labor laws.

### Calculate total trip time
Get the total elapsed time for a journey including every required break.

### Split long journeys
Break down a massive drive into smaller, legally compliant segments.

### Verify compliance
Ensure your planned route stays within the allowed driving limits.

### Plan multi-driver shifts
Organize handoffs and rest periods for teams moving goods over long distances.

## Use Cases

### Planning a 1,200km freight route
A logistics manager needs to plan a route for a truck and wants to know the exact rest stops required by law.

### Checking driver hours remaining
A dispatcher wants to know if a driver who has already worked 4 hours can safely drive another 2 hours.

### Providing accurate delivery windows
A trucking company wants to see the total time for a trip to give customers realistic delivery estimates.

### Mapping out multi-state hauls
An independent driver wants to see a 3-day itinerary for a long haul with specific 30-minute breaks.

## Benefits

- Eliminate manual math by using get_driving_itinerary to build full schedules instantly.
- Avoid safety violations by running verify_drive_compliance on every planned segment.
- Get accurate arrival times by using calculate_total_duration to factor in mandatory breaks.
- Reduce driver fatigue by automatically splitting long journeys into manageable, legal blocks.
- Improve fleet reliability by ensuring every driver follows the same standardized rest protocols.

## How It Works

The bottom line is you get a legally compliant driving schedule without doing the manual math.

1. Provide the AI with trip details like distance, speed, and mandatory rest rules.
2. The agent uses the MCP to calculate the sequence of driving and resting blocks.
3. You get a detailed itinerary showing exact start and stop times for every segment.

## Frequently Asked Questions

**Can the Driving Shift Planner help me stay compliant with trucking laws?**
Yes, it is designed specifically to check if your driving segments stay within legal limits. It helps you avoid fines by catching illegal shifts before they start.

**Does the Driving Shift Planner calculate mandatory rest periods?**
It does, automatically building them into the itinerary so you don't have to guess. This ensures your schedules are realistic and safe.

**Can I use the Driving Shift Planner for multi-driver shifts?**
Yes, it can help split a long journey between different drivers with proper rest blocks and handoff times.

**How does the Driving Shift Planner help with delivery windows?**
It gives you a realistic total trip duration that includes all necessary stops, making your estimates more accurate for your customers.

**Is the Driving Shift Planner good for long-haul logistics?**
It is ideal for that because it handles the complex math of breaking down long trips into legal segments for long-distance transport.

**Can the Driving Shift Planner tell me if a specific drive is too long?**
Yes, you can use it to verify if a planned segment exceeds the allowed driving time for your region, ensuring you stay within the law.

**How can I see my full trip schedule?**
Use the `get_driving_itinerary` tool with your total distance and speed.

**Can it check if a specific drive time is legal?**
Yes, use `verify_drive_compliance` to check against maximum allowed hours.

**Does it include rest breaks?**
Yes, the itinerary includes all mandatory rest periods required by your settings.