# Multi-Stop Errand Route Engine AI Agent Connect > Multi-Stop Errand Route Engine solves the headache of scheduling multiple stops. It calculates a feasible sequence by looking at travel times, how long you'll spend at each location, and when those places are actually open. Your AI client uses this data to build itineraries that work in the real world, flagging any stops that are impossible to reach within your timeframe. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0Uf70cWWqXiNcRzOKOhya1twDqSBD3u94uz62BU6/ai-agent-connect - **Tags:** routing, scheduling, logistics, errands, optimization ## Description Stop guessing how much time you need to get through your to-do list. This MCP handles the math of logistics by factoring in travel duration, service windows, and mandatory stops. If you have a list of errands that must happen in a specific order or within certain hours, your agent can use this tool to build a plan that actually fits. It doesn't just look at distance; it looks at the clock. It checks if a store is still open when you're scheduled to arrive and calculates how much time you'll spend driving versus being on-site. If a stop is physically impossible to hit given your constraints, the engine identifies it immediately so you don't waste time on a broken plan. You can use it to generate full itineraries, check individual stop availability, or analyze how much time you're spending on the road. ## Tools ### calculate_errand_route This tool builds an efficient sequence of stops that respects all your mandatory requirements and time limits. ### get_travel_metrics Use this to find the exact travel duration between two specific locations. ### summarize_route_efficiency This tool analyzes a finished route to show you exactly how your time was spent. ### validate_stop_availability This tool checks if a specific location is open and available for a visit at a certain time. ## Prompt Examples **Prompt:** ``` Plan a route starting at 09:00 AM including stops A, B, and C, where C is mandatory. ``` **Response:** ``` The optimal route is [A, C, B]. You will finish at 11:30 AM. Stop B was unreachable due to closing times. ``` **Prompt:** ``` Is the grocery store (ID: store_123) open at 2024-10-25T14:00:00Z? ``` **Response:** ``` Yes, the grocery store is open and available for service at that time. ``` **Prompt:** ``` How much time was spent traveling in my last route? ``` **Response:** ``` The total travel time for your completed route was 45 minutes. ``` ## Capabilities ### Route Sequencing Your agent organizes stops into a logical order based on time and distance. ### Time Window Validation The MCP checks if locations are open during your planned arrival times. ### Mandatory Stop Enforcement Your agent ensures specific locations are included in every generated itinerary. ### Travel Time Calculation The tool calculates the duration between stops to build accurate schedules. ### Efficiency Analysis Your agent reviews completed routes to see how much time was spent driving. ## Use Cases ### Daily Errand Planning Turn a random list of errands into a timed itinerary that respects store hours. ### Service Route Optimization Organize technician visits to ensure they arrive while customers are available. ### Logistics Auditing Review past routes to see how much time was lost to travel between stops. ### Constraint Testing Check if a specific set of mandatory stops can actually be completed in a single afternoon. ## Benefits - Identifies unreachable stops before you leave. - Accounts for real-world constraints like business hours. - Reduces wasted time by optimizing the sequence of stops. - Provides clear data on travel versus service time. ## How It Works Getting a route takes just a few steps through your AI client. 1. Connect the MCP to your client via Vinkius. 2. Provide your list of stops and any time constraints to your agent. 3. The agent calls the routing engine to calculate the sequence. 4. The engine checks for stop availability and travel times. 5. You receive a finished, feasible itinerary. ## Frequently Asked Questions **How does this MCP handle business hours?** The engine checks the operating hours of each stop to ensure you arrive while they are open. It will flag a stop as unreachable if you cannot get there before they close. **Can I force certain stops to be included?** Yes, you can define mandatory stops that the engine must include in the calculated route. **What happens if a stop is impossible to reach?** The engine identifies unreachable locations that cannot be serviced within your required time windows. **Which AI clients can use this?** You can use this MCP with any compatible client like Claude, Cursor, Windsurf, or VS Code. **Does it only look at distance?** No, it calculates routes based on travel time, service duration at each location, and operating hours. **How does the engine handle mandatory stops?** The engine prioritizes mandatory stops. If a mandatory stop cannot be reached within its operating hours after accounting for travel and previous service times, it will be listed in the unreachable stops. **Can I check if a specific location is open before planning a route?** Yes, you can use the `validate_stop_availability` tool to verify if a specific stop can be serviced at a given arrival time based on its operating hours. **What information is needed to calculate a route?** To use `calculate_errand_route`, you need to provide the list of all potential stop IDs, the mandatory stop IDs, the start time, a travel time matrix, service durations, and the operating hours for each stop.