# OptimoRoute MCP > OptimoRoute MCP handles complete logistics planning from your AI client. Use it to create new delivery orders, plan optimized multi-day routes for multiple drivers, track vehicle GPS in real time, and verify proof of delivery—all without logging into a separate dashboard. ## Overview - **Category:** logistics-supply-chain - **Price:** Free - **Tags:** route-optimization, delivery-management, gps-tracking, fleet-management, proof-of-delivery ## Description Need to manage complex deliveries? This MCP lets you run your entire route planning process from a single conversation. You can generate new delivery orders, specifying addresses, required service times, or even capacity limits. Once the orders are ready, you tell the agent to queue up an optimization job for specific dates and drivers. The system handles the heavy lifting, allowing you to check the solver status or abort complicated computations if needed. When routes finalize, you can download a full manifest showing every optimized stop assigned to each vehicle. Beyond planning, it monitors operations: get real-time coordinates for any driver in your fleet using the agent, and pull detailed completion records, including photos and signatures, when verifying proof of delivery. Because this MCP lives on Vinkius, connecting to thousands of other services, you can finally keep all your operational data flowing through one central AI client. ## Tools ### get_order_pod Retrieves the official record verifying that a specific delivery was successfully completed. ### create_route_order Adds a new, bounded delivery stop or order to be included in future route calculations. ### delete_stale_order Removes old or inactive orders from the system so they don't mess up current routing plans. ### get_live_driver_gps Gets the most recent, real-time GPS location data for any driver in your assigned fleet. ### download_manifest_routes Generates a structured file listing all optimized stops and the sequence of travel routes for the drivers. ### check_planning_status Checks if a scheduled route optimization job is finished, or if it's still running in the background. ### get_order_scheduling Looks up the specific estimated time of arrival (ETA) for an order within the overall planned schedule. ### queue_route_optimization Starts a new, large-scale route optimization job by feeding in solver logic and required parameters. ### abort_route_planning Stops a running or stuck route planning process that needs to be canceled immediately. ### update_driver_shifts Updates the working hours and operational constraints, like maximum load capacity, for individual drivers. ## Prompt Examples **Prompt:** ``` Create a delivery order for 200 Main St, Boston with a 2-hour time window from 9 AM to 11 AM. ``` **Response:** ``` Order ORD-4521 created successfully. Destination: 200 Main St, Boston, MA. Service time: 15 minutes. Time window: 09:00–11:00. The order is queued and ready for the next route optimization run. Want me to start a route optimization for today? ``` **Prompt:** ``` Start route optimization for tomorrow with drivers D1, D2, and D3. ``` **Response:** ``` Route optimization queued. Planning ID: PLN-7789. Solver is running with 3 drivers and 42 pending orders for April 1. Estimated completion: ~45 seconds. Want me to check the status in a moment? ``` **Prompt:** ``` Where is driver D2 right now? ``` **Response:** ``` Driver D2 is currently at 42.3601, -71.0589 (near Faneuil Hall, Boston). Last ping: 12 seconds ago. Speed: 28 km/h. Currently en route to stop 4 of 8 (ETA: 5 minutes). Want me to pull the full route manifest for D2? ``` ## Capabilities ### Create new orders Adds structured delivery orders to the system with necessary details like addresses and time windows. ### Run route planning jobs Schedules complex routing computations for specific dates and groups of drivers, allowing you to monitor progress or cancel them early. ### Track live vehicle location Pulls immediate GPS coordinates for any driver, giving you a real-time view of the fleet's movements. ### Generate final route manifests Downloads structured reports detailing every optimized stop and assigned sequence for all drivers involved. ### Verify delivery completion records Retrieves the full record of a completed drop-off, including signatures, photos, and notes. ## Use Cases ### The urgent last-minute addition A client calls needing a drop-off in a new neighborhood. Instead of logging into the system and manually inputting everything, you just tell your agent: 'Create a delivery order for 14 Oak Lane with a 3-hour window.' The agent uses `create_route_order` to add it, then suggests running a minor optimization using `queue_route_optimization`. ### Daily operational audit At the end of the day, you need proof that all 50 deliveries were signed off. You ask your agent to pull the completion details for every order via `get_order_pod`. It gathers all signatures and photos into one report for compliance. ### Optimizing a multi-day schedule You're planning next week's runs. You tell your agent: 'Optimize routes for the North Zone using drivers D1, D2, and D3 for May 15th.' The agent uses `queue_route_optimization`, and when it finishes, you download the full manifest with `download_manifest_routes`. ### Mid-day troubleshooting Driver D2 calls saying he's lost. Instead of having him backtrack manually, you ask your agent for his current location using `get_live_driver_gps`. You see where he is and immediately adjust the route schedule by calling `get_order_scheduling`. ## Benefits - Don't waste time navigating dashboards. You can use `create_route_order` to add new stops and then immediately call `queue_route_optimization`—all in one conversation. - Need to know where the fleet is? Instead of calling dispatch, ask your agent for real-time coordinates using `get_live_driver_gps`. It gives you immediate visibility into every vehicle's location. - The audit process gets faster. You can automatically gather proof of delivery details by running `get_order_pod`, pulling signatures and photos without manual data entry. - Managing driver capacity is simple. Use `update_driver_shifts` to set working hours or load limits, ensuring the planned route respects actual operational rules. - If a plan goes wrong, you don't get stuck. You can check progress using `check_planning_status`, and if it gets stuck, use `abort_route_planning` immediately. ## How It Works The bottom line is you manage entire logistics operations using natural chat commands instead of clicking through multiple web dashboards. 1. Subscribe to this MCP and provide your OptimoRoute API Key. 2. Use your AI client to issue commands, like asking the agent to create a new delivery order or queue up an optimization job for tomorrow's routes. 3. The agent calls the necessary tools, processes the data through OptimoRoute, and returns results—like status updates, manifest downloads, or live GPS coordinates. ## Frequently Asked Questions **How do I start route planning with OptimoRoute MCP?** You first need to subscribe and enter your API Key into the agent. Then, you can use `create_route_order` to input all necessary stops before running the optimization via `queue_route_optimization`. **What is the difference between using OptimoRoute MCP for tracking versus planning?** Planning uses tools like `queue_route_optimization` to create a future route. Tracking uses `get_live_driver_gps` to report current, real-time location data during an active run. **Can OptimoRoute MCP handle cancelled stops?** Yes. If a stop is no longer needed, you use `delete_stale_order`. This keeps your routing calculations clean and prevents the agent from trying to route an invalid address. **How do I get all the final delivery proof using OptimoRoute MCP?** Use the `get_order_pod` tool. It automatically collects structured verification data, including photos and signatures, confirming successful delivery for audit purposes.