# OptimoRoute MCP

> OptimoRoute lets you manage your entire delivery workflow through natural conversation. Use this MCP to create, track, and optimize orders instantly—from checking live driver locations to running full route planning simulations. Take control of every movement in your supply chain without opening a dashboard.

## Overview
- **Category:** logistics-supply-chain
- **Price:** Free
- **Tags:** route-optimization, delivery-management, fleet-management, logistics-analytics

## Description

Managing logistics shouldn't mean clicking through ten different tabs just to find out where things are. OptimoRoute lets you talk to your operations data like it's nothing. Need to know if John is stuck on Elm Street? Ask your AI client. Want to see how many orders were delivered last month? Just ask for the analytics. You can use this MCP to handle everything from generating an entirely new delivery order to checking the status of a complex optimization job. All these functions are available through Vinkius, connecting you directly to OptimoRoute's core data. Your agent handles the complexity: it manages your fleet tracking and helps you plan routes while keeping track of every stop sequence required for the day’s deliveries.

## Tools

### create_order
Generates a brand new record for a delivery order, including location details.

### delete_order
Permanently removes an existing delivery order from the system records.

### get_analytics
Pulls aggregated data showing how well your overall deliveries performed over time.

### get_driver_locations
Retrieves the current, live coordinates for every driver on the road.

### get_order
Fetches all specific details associated with one single order number.

### get_planning_status
Checks if a previously started route optimization job is complete or still running.

### list_routes
Provides an overview of all routes that are scheduled for a specific date.

### get_stop_sequence
Determines the exact, ordered list of stops a driver must make in their route.

### list_drivers
Returns a list of all active drivers associated with your account.

### start_planning
Initiates the complex process of optimizing routes for maximum efficiency on a chosen date.

## Prompt Examples

**Prompt:** 
```
Create a new delivery order #ABC-123 for 123 Main St for tomorrow.
```

**Response:** 
```
Order #ABC-123 has been successfully created for the location '123 Main St' scheduled for 2026-10-25.
```

**Prompt:** 
```
Show me the real-time locations of all my drivers.
```

**Response:** 
```
I've retrieved the fleet status. Driver John is at (40.7128, -74.0060), Driver Sarah is at (34.0522, -118.2437), and 3 others are currently on their routes.
```

**Prompt:** 
```
Start route optimization for today's pending orders.
```

**Response:** 
```
Route optimization has been started for 2026-10-24. Planning ID: 98765. You can check the status using the `get_planning_status` tool.
```

## Capabilities

### Create and manage delivery orders
You can generate, fetch details on, or wipe out specific delivery orders using precise location data.

### View real-time fleet status
Get live coordinates for every driver and check the stop sequence they are following right now.

### Plan optimized routes
Start, monitor, and get details on complex route optimization tasks for any given date.

### Audit performance metrics
Extract detailed delivery analytics to audit how your logistics performed over specific time periods.

### Check planned routes
List all scheduled and planned routes for a specified date to maintain daily visibility.

## Use Cases

### A driver needs an immediate address verification.
The dispatcher asks their agent to check the details for order #456. The MCP uses `get_order` to pull all necessary location and customer contact information instantly, verifying that the delivery is scheduled correctly.

### A last-minute change requires a new stop.
The operations team calls in an urgent delivery. They use the agent to `create_order` with the precise location and date, adding it directly into the active manifest for the next planning cycle.

### The fleet needs immediate status checks.
A manager asks: 'Where are all my drivers right now?' The agent executes `get_driver_locations`, providing a clear, consolidated list of current coordinates across the entire city.

### Planning for next week's peak volume.
The logistics manager asks to plan routes for Friday. The MCP uses `start_planning` and then allows them to check progress with `get_planning_status`, ensuring the route is ready before the team starts work.

## Benefits

- Instantly manage orders and fleet status. Instead of navigating multiple forms, simply ask your agent to use `create_order` or `delete_order` to update the manifest immediately.
- Real-time visibility on demand. Get live driver locations using `get_driver_locations`, allowing you to give customers accurate ETA updates without needing a dashboard open.
- Automate complex planning. Start route optimization for the week with `start_planning`. You can then use `get_planning_status` to monitor when that massive job finishes.
- Audit your performance effortlessly. Run a quick query for `get_analytics` and pull detailed reports on delivery efficiency, eliminating manual data compilation.
- Know what's next. Get the exact sequence of stops a driver must follow using `get_stop_sequence`, ensuring teams never miss a mandatory checkpoint.

## How It Works

The bottom line is, your AI client turns complex logistics operations into simple conversations.

1. Subscribe to this MCP on Vinkius, then paste your OptimoRoute API Key into the connection settings.
2. Your AI client recognizes the toolset and allows you to ask natural language questions about deliveries or routes.
3. The agent executes the necessary commands using the underlying tools, giving you immediate answers like current driver locations or optimization status.

## Frequently Asked Questions

**How do I check if a planned route has been completed using OptimoRoute MCP?**
You use the `get_planning_status` tool to verify the progress of any optimization job. This tells you whether the planning process is still running, complete, or if an error occurred.

**Can I use OptimoRoute MCP to add a new delivery order?**
Yes, simply ask your agent to `create_order`. You just need to provide the necessary location details and scheduling information for the new job.

**What is the difference between list_routes and get_stop_sequence in OptimoRoute MCP?**
Use `list_routes` when you want a broad overview of all scheduled routes for a date. Use `get_stop_sequence` when you need the detailed, step-by-step order of stops for one specific driver.

**How do I see where my drivers are right now with OptimoRoute MCP?**
You ask your agent to use `get_driver_locations`. This tool pulls the current, real-time coordinates for every active vehicle in your fleet.

**Does OptimoRoute MCP help me audit past performance?**
Yes. The `get_analytics` tool lets you extract comprehensive delivery performance metrics so you can easily audit and improve your logistics process over time.