# Multi-City Trip Route Planner AI Agent Connect

> Multi-City Trip Route Planner MCP handles the math and logic behind complex travel schedules. Your AI client uses it to check if your city sequences meet stay requirements, calculate total trip costs, and compare different route options to find the fastest or cheapest path.

## Overview
- **Category:** travel
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jkowP5XzxWSF9DuYptyvjOcH5pM7xawI0BpH4UWx/ai-agent-connect
- **Tags:** itinerary, route-optimization, travel-planning, trip-metrics, logistics

## Description

Planning a trip through several cities involves a lot of moving parts. You have to track how much time you spend in each location, ensure you aren't moving too fast to actually enjoy a stop, and keep an eye on the total budget. This MCP gives your AI agent the specific tools needed to manage those logistics. Instead of you manually adding up flight costs or checking if a three-day stay in London meets your personal requirements, you just tell your agent what you want to do. It can run through different route combinations to see which one saves you the most money or time. It also keeps a clear record of your time distribution so you don't end up with a trip that's too rushed. It's a way to turn a messy list of cities into a structured, validated itinerary.

## Tools

### calculate_route_metrics
This tool sums up the total cost and travel time for a specific sequence of trip legs.

### compare_routes
Use this to find the most efficient path by comparing two different valid route sequences based on time or cost.

### get_stay_summary
This tool provides a clear breakdown of how much time is spent in each city within your route.

### validate_route_sequence
This tool checks your city sequence against minimum stay constraints to ensure your plan is actually feasible.

## Prompt Examples

**Prompt:** 
```
Is my route [Paris, London, Berlin] valid if I stay 2 nights in Paris and 1 night in London, given a 2-night minimum for Paris and 2-night minimum for London?
```

**Response:** 
```
No, the route is invalid because the stay in London (1 night) does not meet the minimum requirement of 2 nights.
```

**Prompt:** 
```
What is the total cost for a trip from New York to Tokyo to Seoul with legs costing $800 and $500?
```

**Response:** 
```
The total cost for the trip is $1,300.
```

**Prompt:** 
```
Show me a summary of my stay in [Rome, Florence, Venice] if I stay 3 nights in Rome and 2 nights in Florence.
```

**Response:** 
```
Rome: 3 nights, Florence: 2 nights.
```

## Capabilities

### Route Validation
Your agent checks if your planned stops meet your specific minimum stay rules.

### Cost and Time Aggregation
The AI calculates the total financial and temporal investment for a full itinerary.

### Route Comparison
Your agent evaluates two different paths to pick the one that is cheaper or faster.

### Stay Breakdown
The AI generates a summary of time spent in every city on your list.

## Use Cases

### Optimizing Multi-Stop Tours
Compare different city sequences to find the cheapest way to visit five different locations.

### Constraint Checking
Ensure a complex itinerary doesn't violate minimum stay rules for specific destinations.

### Budget Tracking
Get a total cost estimate for a multi-leg journey by aggregating individual leg costs.

### Itinerary Auditing
Review a planned trip to see exactly how many nights are spent in each city.

## Benefits

- Eliminates manual math for total trip costs and travel durations.
- Prevents invalid itineraries by checking stay requirements automatically.
- Speeds up decision making by comparing route efficiency.
- Provides instant visibility into time distribution across multiple cities.

## How It Works

Connect the MCP to your client and start asking questions about your routes.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Provide your list of cities and stay durations to your agent.
3. Ask the agent to validate the sequence or calculate costs.
4. Review the calculated metrics or comparisons provided by the agent.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the Vinkius catalog once, and the MCP becomes available as a tool within your Claude interface.

**Can this MCP compare two different trips?**
Yes, you can ask your agent to use the compare_routes tool to find the most efficient path between two sequences.

**Does it check for minimum stay requirements?**
Yes, the validate_route_sequence tool checks if your itinerary follows your specific stay constraints.

**What kind of metrics can it calculate?**
It can calculate the total cost and the total travel time for any given sequence of trip legs.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How do I know if my route is valid?**
You can use the `validate_route_sequence` tool. It checks if the number of nights spent in each city meets the required minimum stay rules.

**Can I compare two different travel plans?**
Yes, the `compare_routes` tool allows you to compare two validated routes to see which one is better based on your preference for either cost or travel time.

**How are total trip costs calculated?**
The `calculate_route_metrics` tool aggregates the costs and durations of all transport legs provided in your sequence.
