# OptimoRoute MCP for AI Agents AI Agent Connect > OptimoRoute MCP lets you manage your entire delivery fleet from a single chat. Create orders, plan complex routes, track live GPS data, and pull proof of delivery records without switching tabs. It connects your logistics operations directly to your AI agent. ## Overview - **Category:** logistics-supply-chain - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_vCUy5YDPO1Fk1ys9R0VMzE3fzZGKpG7gzFiFIyZo/ai-agent-connect - **Tags:** route-optimization, delivery-management, gps-tracking, fleet-management, proof-of-delivery ## Description This OptimoRoute MCP connects your delivery operations to your AI agent so you can handle logistics without jumping between different dashboard tabs. Instead of manually entering addresses or checking driver locations one by one, you can just ask your agent to handle the heavy lifting. You can tell your agent to create new orders with specific time windows and capacity limits, or ask it to start a new route planning job for a specific set of drivers. If a route is taking too long, you can tell the agent to stop it or check the status of the solver in real-time. You can also grab the final manifests for your drivers or pull real-time GPS coordinates to see exactly where everyone is on the map. For the back office, it handles the tedious stuff like pulling driver signatures and photos for verification or updating driver shifts and speed profiles. It makes managing a fleet feel like a conversation rather than a data entry project. By hosting this on Vinkius, you get a reliable way to bridge your OptimoRoute account with any MCP-compatible client you already use daily. It takes the friction out of route planning by letting you move from a high-level request to a finalized manifest without ever leaving your chat window. You can manage your entire fleet and keep your drivers on schedule without the usual headache of constant context switching. ## Tools ### get_order_pod Get the specific details and structural data that confirm a delivery was successful. This helps you quickly check if a package reached its destination. ### delete_stale_order Remove old or expired orders from your queue to keep your routing data clean. It ensures your agent only focuses on active deliveries. ### get_live_driver_gps Pull the real-time GPS coordinates and telemetry for any driver in your fleet. Use this to see exactly where your drivers are on the map right now. ### download_manifest_routes Export the final optimized routes and stop lists for your drivers to use. This is perfect for sending daily schedules to your team. ### check_planning_status Check if your current route optimization job is still running or finished. It gives you visibility into long-running solver tasks. ### get_order_scheduling Look up the specific scheduled time and location for any order in your plan. This helps you answer customer questions about their delivery windows. ### queue_route_optimization Start a new route planning job for a specific set of drivers and orders. You can trigger the solver for specific dates and driver groups. ### abort_route_planning Stop a route optimization job that is taking too long or needs to be canceled. This prevents your account from getting bogged down by stuck computations. ### update_driver_shifts Update driver working hours, speed profiles, and truck load capacities. Keep your driver profiles accurate as your fleet changes. ### create_route_order Create a new delivery order with specific addresses and constraints in your account. You can set time windows and vehicle capacities directly through the chat. ## Prompt Examples **Prompt:** ``` Where is driver D2 right now? ``` **Response:** ``` Driver D2 is currently at 42.3601, -71.0589 (near Faneuil Hall, Boston). **Status Update:** * **Last Ping:** 12 seconds ago * **Speed:** 28 km/h * **Current Progress:** En route to stop 4 of 8 * **ETA:** ~5 minutes Would you like me to pull the full route manifest for D2? ``` **Prompt:** ``` Start route optimization for tomorrow with drivers D1, D2, and D3. ``` **Response:** ``` I've queued the route optimization for tomorrow. **Planning Details:** * **Planning ID:** PLN-7789 * **Drivers:** D1, D2, D3 * **Pending Orders:** 42 * **Estimated Completion:** ~45 seconds I'll let you know as soon as the solver is finished. Want me to check the status in a moment? ``` **Prompt:** ``` Create a delivery order for 200 Main St, Boston with a 2-hour window from 9 AM to 11 AM. ``` **Response:** ``` Order ORD-4521 has been created successfully. **Order Summary:** * **Destination:** 200 Main St, Boston, MA * **Service Time:** 15 minutes * **Time Window:** 09:00–11:00 The order is now in the queue and ready for the next route optimization run. Should I start the planning job for today now? ``` ## Capabilities ### Create delivery orders Generate new orders with specific addresses, time windows, and capacity constraints. ### Run route optimization Queue new route planning jobs for specific dates and driver groups. ### Track live GPS Get real-time coordinates and telemetry for every driver in your fleet. ### Download manifests Export finalized optimized routes and stop lists for your drivers. ### Retrieve proof of delivery Pull completion details including driver signatures, photos, and notes. ### Update driver shifts Manage driver working hours, speed profiles, and vehicle load capacities. ## Use Cases ### Real-time fleet tracking A dispatcher asks their agent where Driver D2 is located. The agent uses `get_live_driver_gps` to return the exact coordinates and current speed. ### Batch order creation A logistics manager asks the agent to create 20 new orders for a specific zip code with 2-hour windows. The agent processes them via `create_route_order`. ### Audit and compliance An analyst needs to verify a delivery from last Tuesday. The agent pulls the signature and photo using `get_order_pod` for the report. ### Handling stuck optimizations A route planning job is taking too long and freezing the queue. The user tells the agent to stop it using `abort_route_planning`. ## Benefits - Create orders faster with `create_route_order` so you do not have to type every address manually into a web form. This saves your team hours of data entry every week. - Stop wasting time on stuck jobs by using `abort_route_planning` to kill long-running computations instantly. It keeps your workflow moving when the solver hits a snag. - Get instant eyes on your fleet with `get_live_driver_gps` to see exactly where everyone is on the map. You can track progress without opening a separate tracking app. - Pull clean data for audits using `get_order_pod` to grab signatures and delivery photos automatically. It makes compliance reporting much faster for your operations team. - Keep your schedules accurate by using `update_driver_shifts` to manage hours and capacities in one go. This ensures your routing plans always account for current driver availability. - Simplify morning prep with `download_manifest_routes` to give drivers their final stop lists in a single step. It ensures everyone starts their day with the right info. ## How It Works The bottom line is you get a voice-controlled command center for your entire delivery operation. 1. Subscribe to the OptimoRoute MCP on Vinkius. 2. Enter your OptimoRoute API Key in your AI client settings. 3. Start planning routes or creating orders from your preferred chat client. ## Frequently Asked Questions **Can OptimoRoute MCP help with real-time fleet tracking?** Yes. It allows your agent to pull live GPS coordinates and telemetry for any driver in your fleet, giving you instant visibility into where everyone is. **How does OptimoRoute MCP handle delivery proof?** It can retrieve specific details for completed deliveries, including driver signatures and photos, making it easy to pull data for audits. **Can I use OptimoRoute MCP to manage driver shifts?** Absolutely. You can use it to update driver working hours, speed profiles, and vehicle load capacities directly through your chat client. **Does OptimoRoute MCP support multi-driver route planning?** Yes. You can queue optimization jobs for specific groups of drivers and dates, allowing your agent to handle complex fleet planning. **Can OptimoRoute MCP delete old orders?** Yes. It includes a tool to remove stale or expired orders from your queue to keep your active routing data clean and accurate. **How do I get my driver manifests with this Connector?** Your agent can download finalized manifests that show every optimized stop assigned to each driver, which you can then share with your team. **How long does route optimization take to complete?** It depends on the number of orders and drivers. Small batches (under 100 stops) typically finish in under 30 seconds. Large-scale plans can take several minutes. The agent checks the planning status endpoint so you can monitor progress, and you can abort and capture the best partial solution at any time. **Can I verify if a delivery was actually completed with proof?** Yes. The get_order_pod tool pulls completion details including driver-captured signatures, photos, and timestamped notes. This data comes directly from the OptimoRoute driver app and provides auditable proof of delivery for dispute resolution and compliance. **Can I update a driver's working hours and vehicle capacity on the fly?** Yes. The update_driver_shifts tool lets you change working hours, speed profiles, and load capacities for any driver. Changes take effect on the next optimization run. Useful for adjusting schedules when a driver calls in sick or a vehicle needs to be swapped.