# OptimoRoute MCP for AI Agents AI Agent Connect

> OptimoRoute MCP lets you manage your entire delivery operation through an AI agent. You can create orders, start route optimizations, and track live driver locations without switching tabs. It turns your AI into a logistics coordinator that handles the heavy lifting of fleet management.

## Overview
- **Category:** logistics-supply-chain
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ZK9HgHz0AxhF4nsjzHDYYuCo5sfDY3SnOfGKp26z/ai-agent-connect
- **Tags:** route-optimization, delivery-management, fleet-management, logistics-analytics

## Description

OptimoRoute MCP connects your logistics account to any AI agent so you can manage your entire delivery operation through natural conversation. Managing a fleet usually means jumping between tabs to check where a truck is, what its next stop is, and whether the day's routes are actually optimized. It's a lot of context switching that pulls you away from actual problem-solving. This Connector changes that by letting your AI agent do the digging for you. Instead of hunting for a specific driver's status, you just ask the agent. It handles the data retrieval for order management, route oversight, and real-time tracking. You can initiate optimization tasks and pull performance analytics into a single conversation. Because Vinkius makes it so easy to connect these tools, you can treat your AI like a dedicated dispatcher that knows your fleet inside out. It's about moving from "where is the data?" to "what do we need to do next?"

## Tools

### get_planning_status
Check the status of an optimization task. Use this to see if the AI is still crunching your routes or if they're ready.

### get_analytics
Get delivery performance analytics for your fleet. This lets you see how well your routes are actually performing over time.

### get_order
Get details for a specific order. This pulls up the specific metadata for any single job in your system.

### create_order
Create a new delivery order with specific location details. This helps you add new jobs to the queue without leaving your chat.

### delete_order
Remove a delivery order from the system. Use this when a customer cancels or a job needs to be purged.

### get_driver_locations
Get real-time driver locations. Use this to see exactly where every vehicle is on the map at any second.

### list_routes
List routes for a specific date. This gives you a bird's eye view of the day's planned logistics.

### get_stop_sequence
Get the stop sequence for a specific driver. This shows the exact order of deliveries for a single vehicle.

### list_drivers
List all drivers in your fleet. Use this to quickly see who is active and who is currently on the road.

### start_planning
Start route optimization for a specific date. This triggers the system to find the most efficient delivery paths.

## Prompt Examples

**Prompt:** 
```
Where is our driver for the downtown delivery?
```

**Response:** 
```
I've checked the live fleet status for you.

**Driver Status:**
* **Driver:** John Doe
* **Current Location:** (40.7128, -74.0060)
* **Next 3 Stops:**
  1. 123 Main St (ETA: 10:15 AM)
  2. 456 Oak Ave (ETA: 10:45 AM)
  3. 789 Pine Ln (ETA: 11:20 AM)

John is currently 5 minutes away from his next stop.
```

**Prompt:** 
```
Start the route optimization for all pending orders tomorrow.
```

**Response:** 
```
I've initiated the route optimization for tomorrow's date. 

**Optimization Details:**
* **Status:** In Progress
* **Planning ID:** #98765
* **Estimated Completion:** 2 minutes

I'll let you know as soon as the routes are ready, or you can ask me to check the status at any time.
```

**Prompt:** 
```
Give me a summary of our delivery performance for last week.
```

**Response:** 
```
Here is the delivery performance summary for last week:

| Metric | Result |
| :--- | :--- |
| **Total Deliveries** | 1,240 |
| **On-Time Rate** | 98.2% |
| **Avg. Delay** | 4.2 mins |
| **Total Stops** | 1,310 |

Overall, the fleet performed well with a high on-time rate despite the heavy volume on Wednesday.
```

## Capabilities

### Create new delivery orders
Add new stops to your schedule with specific location data.

### Track live driver locations
See exactly where your fleet is on the road right now.

### Start route optimization
Kick off the process of finding the most efficient paths for your drivers.

### Retrieve delivery performance analytics
Pull hard data on how your deliveries are actually performing.

### View planned routes
See the full schedule for any specific date to keep things organized.

### Get stop sequences
Look up the exact order of stops for a specific driver.

### Delete existing delivery orders
Remove a delivery order from the system when a customer cancels.

### List all drivers
See who is active and who is currently on the road across your fleet.

## Use Cases

### The Morning Rush
A dispatcher sees 50 new orders come in. They ask the agent to create_order for all of them and then use start_planning to organize the day's routes.

### The Customer Inquiry
A customer calls asking where their package is. The manager asks the agent for the real-time location of the driver and the stop_sequence to give a precise ETA.

### The Performance Audit
At the end of the month, a logistics lead asks the agent to get_analytics to see which routes had the most delays and how to fix them.

### The Route Check
A supervisor wants to see if the drivers are on track. They ask the agent to list_routes for today to see the planned path for every vehicle.

## Benefits

- Stop tab-switching by using create_order to add new jobs directly in your chat.
- Get instant answers on fleet movement with get_driver_locations instead of opening a map.
- Save time on planning by using start_planning to automate the hardest part of logistics.
- Make data-driven decisions by pulling performance metrics with get_analytics.
- Keep the team aligned by viewing the full schedule with list_routes for any date.
- Verify driver progress quickly by checking individual stop sequences with get_stop_sequence.

## How It Works

The bottom line is you get a conversational interface for your entire logistics dashboard.

1. Subscribe to the OptimoRoute MCP on the Vinkius marketplace.
2. Enter your OptimoRoute API key in the configuration settings.
3. Ask your AI agent to optimize routes, check driver locations, or create new orders.

## Frequently Asked Questions

**Can I use OptimoRoute MCP to create new orders?**
Yes, you can use it to add new delivery orders with specific location details directly through your AI client. This saves you from having to manually enter data into the dashboard.

**How do I track my drivers in real time with OptimoRoute MCP?**
You can ask your agent for the live location of any driver, and it will pull the current coordinates from your fleet data. It's a great way to get quick updates without opening a map.

**Does OptimoRoute MCP support route optimization?**
It allows you to start optimization tasks for specific dates and check their progress as they complete. You can then see the most efficient paths for your fleet.

**Can I see the specific order of stops for my drivers?**
Yes, you can pull the exact stop sequence for any driver to see their planned route for the day. This helps you provide accurate ETAs to your customers.

**How does OptimoRoute MCP help with logistics analytics?**
You can ask your agent to pull performance analytics to see how your fleet is performing over time. It helps you identify trends and areas for improvement.

**Can I see all my routes for a specific day?**
You can list all planned routes for any date to get a full overview of your daily logistics. It's perfect for morning briefings or end-of-day audits.

**How do I get an OptimoRoute API Key?**
In your OptimoRoute account, go to **Administration** > **API Key**. There you can generate and copy your unique access key.

**Can I see where my drivers are right now?**
Yes! Use the `get_driver_locations` tool to retrieve the real-time coordinates and status of all active vehicles in your fleet.

**Does starting planning affect existing routes?**
The `start_planning` tool initiates the optimization engine for the specified date. It will create or update routes based on the pending orders and driver availability for that day.