Stopover
Plans multi-city trips: the cheapest order of cities, the dates, and flights or trains for each leg.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"stopover": {
"url": "https://mcp.flystopover.com/mcp"
}
}
}Remote endpoints
https://mcp.flystopover.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
⚪plan_trip(home, cities, start_date, end_date, flexible, ...)
Use this when someone asks which order to visit several cities in, the cheapest way to see them, or the cheapest dates and flights for a multi-city trip (for example: Dallas to Lisbon, Madrid and Paris in May, what order?). Plans a multi-city trip with Stopover. Given a home city, 2 to 7 cities to visit and a date window, it prices every order of the cities and finds the one that costs least (or balances price and travel time, or is fastest), with the dates and the flight or train for each leg. Fares come from free sources (Kiwi.com, Ryanair and recently seen fares) and are estimates at the time shown. Takes about 10 to 90 seconds. Returns the recommended order and dates, the nights in each city, the total per person in USD and how each fare was priced, the saving against the order the cities were listed in, other orders with their prices, each leg with booking links, and a link to the full plan on flystopover.com. A plan still running after about 200 seconds comes back as a plan id to look up later. Does not book anything, and is not for hotels or car rentals.
Input Schema
{
"type": "object",
"properties": {
"home": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Where the trip starts, and ends unless end_at is set: a city name or airport code, like \"Dallas\" or \"DFW\"."
},
"cities": {
"minItems": 2,
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"description": "The 2 to 7 cities to visit, as city names or airport codes, like [\"Lisbon\", \"Madrid\", \"Paris\"]. Any order unless fixed_order is true."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The first day the trip may start, YYYY-MM-DD."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The last day the trip may end (the day back home), YYYY-MM-DD."
},
"flexible": {
"description": "true (the default): the trip may start and end on any days inside the window, chosen for price. false: leave on start_date and come back on end_date exactly.",
"type": "boolean"
},
"max_days": {
"description": "The longest the whole trip may be, in days, when the window is wider than the trip should be. Only with flexible dates.",
"type": "integer",
"minimum": 2,
"maximum": 60
},
"nights": {
"description": "Nights in each city, as a range, like {\"min\": 2, \"max\": 4}. Without it the planner uses 2 to 4.",
"type": "object",
"properties": {
"min": {
"type": "integer",
"minimum": 1,
"maximum": 30
},
"max": {
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
"nights_by_city": {
"description": "Nights for particular cities, overriding nights for those cities, like [{\"city\": \"Paris\", \"min\": 3, \"max\": 3}].",
"maxItems": 7,
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"min": {
"type": "integer",
"minimum": 1,
"maximum": 30
},
"max": {
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"required": [
"city",
"min",
"max"
],
"additionalProperties": false
}
},
"travelers": {
"description": "How many people travel together on the same flights, 1 to 9. Default 1. Prices are given per person and for the group.",
"type": "integer",
"minimum": 1,
"maximum": 9
},
"fixed_order": {
"description": "true: visit the cities in the order listed, and only choose dates and flights. Default false, which lets the planner choose the order.",
"type": "boolean"
},
"end_at": {
"description": "Where the trip finishes when it is not back home, like \"Chicago\" for a trip that starts in Dubai.",
"type": "string",
"minLength": 2,
"maxLength": 60
},
"must_be_in": {
"description": "Nights that must be spent in a given city, like a wedding in Paris on 2027-06-14: [{\"city\": \"Paris\", \"date\": \"2027-06-14\"}].",
"maxItems": 7,
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD, the night that must be spent in the city."
}
},
"required": [
"city",
"date"
],
"additionalProperties": false
}
},
"max_stops": {
"description": "The most stops one flight may make: 0 for nonstop only, 1 or 2.",
"type": "integer",
"minimum": 0,
"maximum": 2
},
"max_layover_hours": {
"description": "The longest layover allowed on a flight, in hours, 1 to 24.",
"type": "integer",
"minimum": 1,
"maximum": 24
},
"avoid_airlines": {
"description": "Airlines not to fly, as names or two letter codes, like [\"Ryanair\", \"W6\"].",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
},
"flights_only": {
"description": "true: flights only, no trains or buses between cities. Default false, which lets a train or bus take a leg when it is the better buy.",
"type": "boolean"
},
"protected_only": {
"description": "true: only tickets sold as one booking, so a missed connection is the airline's problem. Leaves out self-transfer combinations. Default false.",
"type": "boolean"
},
"airlines_only": {
"description": "true: book with airlines only. Leaves out fares sold by booking sites like Kiwi.com, so every ticket is bought from the airline and no link goes to a booking site. Default false.",
"type": "boolean"
},
"mode": {
"description": "What to optimize: cheapest (lowest total price), balanced (price and travel time, the default) or fastest.",
"type": "string",
"enum": [
"cheapest",
"balanced",
"fastest"
]
}
},
"required": [
"home",
"cities",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"done",
"running",
"error",
"capped",
"invalid"
]
},
"plan_id": {
"type": "string"
},
"plan_url": {
"type": "string"
},
"message": {
"type": "string"
},
"demo": {
"type": "boolean"
},
"mode": {
"type": "string"
},
"order": {
"type": "array",
"items": {
"type": "string"
}
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"travelers": {
"type": "number"
},
"per_person_usd": {
"type": "number"
},
"group_total_usd": {
"type": "number"
},
"fare_basis": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"saving_vs_typed_order_usd": {
"type": "number"
},
"typed_order_per_person_usd": {
"type": "number"
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"order": {
"type": "array",
"items": {
"type": "string"
}
},
"per_person_usd": {
"type": "number"
}
},
"required": [
"order",
"per_person_usd"
],
"additionalProperties": false
}
},
"start_days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"per_person_usd": {
"type": "number"
}
},
"required": [
"date",
"per_person_usd"
],
"additionalProperties": false
}
},
"legs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"mode": {
"type": "string"
},
"carrier": {
"type": "string"
},
"stops": {
"type": "number"
},
"arrives": {
"type": "string"
},
"duration_min": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"price_basis": {
"type": "string"
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"date",
"from",
"to",
"mode",
"price_usd",
"price_basis",
"links"
],
"additionalProperties": false
}
},
"stays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"arrive": {
"type": "string"
},
"leave": {
"type": "string"
},
"nights": {
"type": "number"
}
},
"required": [
"city",
"arrive",
"leave",
"nights"
],
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"priced_at": {
"type": "string"
}
},
"required": [
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_plan(plan_id)
Looks up a Stopover trip plan by its plan id or flystopover.com plan link and returns the same summary plan_trip gives: the order, dates, total per person, each leg with booking links, and the plan page link. Read only: it never starts a new search. When the plan is still being priced it waits up to a minute for it.
Input Schema
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"minLength": 8,
"maxLength": 200,
"description": "A Stopover plan id (16 letters and digits) or a full plan link like https://flystopover.com/plan/<id>."
}
},
"required": [
"plan_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"done",
"running",
"error",
"capped",
"invalid"
]
},
"plan_id": {
"type": "string"
},
"plan_url": {
"type": "string"
},
"message": {
"type": "string"
},
"demo": {
"type": "boolean"
},
"mode": {
"type": "string"
},
"order": {
"type": "array",
"items": {
"type": "string"
}
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"travelers": {
"type": "number"
},
"per_person_usd": {
"type": "number"
},
"group_total_usd": {
"type": "number"
},
"fare_basis": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"saving_vs_typed_order_usd": {
"type": "number"
},
"typed_order_per_person_usd": {
"type": "number"
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"order": {
"type": "array",
"items": {
"type": "string"
}
},
"per_person_usd": {
"type": "number"
}
},
"required": [
"order",
"per_person_usd"
],
"additionalProperties": false
}
},
"start_days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"per_person_usd": {
"type": "number"
}
},
"required": [
"date",
"per_person_usd"
],
"additionalProperties": false
}
},
"legs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"mode": {
"type": "string"
},
"carrier": {
"type": "string"
},
"stops": {
"type": "number"
},
"arrives": {
"type": "string"
},
"duration_min": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"price_basis": {
"type": "string"
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"date",
"from",
"to",
"mode",
"price_usd",
"price_basis",
"links"
],
"additionalProperties": false
}
},
"stays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"arrive": {
"type": "string"
},
"leave": {
"type": "string"
},
"nights": {
"type": "number"
}
},
"required": [
"city",
"arrive",
"leave",
"nights"
],
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"priced_at": {
"type": "string"
}
},
"required": [
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence