Stopover Planner

Official5 tools

by stopovercity

Live Google Flights search: stopover itineraries, country sweeps, explore anywhere, booking links

com.stopovercity/stopover-planner (MCP Server)

This MCP server provides live Google Flights search capabilities focused on stopover itineraries. It also supports country sweeps and an “explore anywhere” workflow, returning booking links for the resulting flight options.

🛠️ Key Features

Live Google Flights search
Stopover itineraries
Country sweeps
Explore anywhere
Booking links

🚀 Use Cases

Find flight itineraries that include stopovers
Browse destinations via country sweep searches
Use “explore anywhere” to discover travel options across regions
Use returned booking links to proceed with selected flights

⚡ Developer Benefits

Structured access to Google Flights searches within an MCP integration
Consistent retrieval of booking links alongside search results

Captured live from the server via tools/list.

search_stopover_itineraries

Find complete multi-day stopover itineraries between two cities: an outbound leg, 1 to 7 days in an intermediate hub city, then the onward leg, priced as one trip from live Google Flights data (GBP) with a booking link on every leg. One call evaluates dozens of hub cities and date splits. Runs as a background job: returns a jobId immediately; poll get_job_result every few seconds until status is done.

Parameters5

origin	string	required	Origin city or airport, e.g. "London"
destination	string	required	Final destination, e.g. "Tokyo"
deadlineDates	array	required	Latest arrival date(s) at the destination, YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected).
layoverDays	integer	optional	Days to spend in the hub city (default 3)
nonstop	boolean	optional	Nonstop legs only (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin city or airport, e.g. \"London\""
    },
    "destination": {
      "type": "string",
      "description": "Final destination, e.g. \"Tokyo\""
    },
    "deadlineDates": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "date"
      },
      "minItems": 1,
      "maxItems": 31,
      "description": "Latest arrival date(s) at the destination, YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected)."
    },
    "layoverDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "Days to spend in the hub city (default 3)"
    },
    "nonstop": {
      "type": "boolean",
      "description": "Nonstop legs only (default true)"
    }
  },
  "required": [
    "origin",
    "destination",
    "deadlineDates"
  ]
}

search_flights

Live Google Flights prices for one route across one or more dates. Each flight includes airline, GBP price, duration, stops, times, and a Google Flights booking link. Synchronous: typically 5 to 20 seconds.

Parameters5

origin	string	required	e.g. "London"
destination	string	required	e.g. "Madrid"
dates	array	required	Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected).
nonstop	boolean	optional	Default true
oneway	boolean	optional	Default true

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "e.g. \"London\""
    },
    "destination": {
      "type": "string",
      "description": "e.g. \"Madrid\""
    },
    "dates": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "date"
      },
      "minItems": 1,
      "maxItems": 31,
      "description": "Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected)."
    },
    "nonstop": {
      "type": "boolean",
      "description": "Default true"
    },
    "oneway": {
      "type": "boolean",
      "description": "Default true"
    }
  },
  "required": [
    "origin",
    "destination",
    "dates"
  ]
}

search_country_sweep

Cheapest live fares from one origin to every destination city in a whole country, in one call (e.g. London to all of Spain). Replaces dozens of route searches. Runs as a background job: returns a jobId; poll get_job_result until done.

Parameters5

origin	string	required	e.g. "London"
country	string	required	Country or continent, e.g. "Spain"
dates	array	required	Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected).
nonstop	boolean	optional	Default true
oneway	boolean	optional	Default true

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "e.g. \"London\""
    },
    "country": {
      "type": "string",
      "description": "Country or continent, e.g. \"Spain\""
    },
    "dates": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "date"
      },
      "minItems": 1,
      "maxItems": 31,
      "description": "Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected)."
    },
    "nonstop": {
      "type": "boolean",
      "description": "Default true"
    },
    "oneway": {
      "type": "boolean",
      "description": "Default true"
    }
  },
  "required": [
    "origin",
    "country",
    "dates"
  ]
}

search_explore_anywhere

Explore everywhere: the cheapest destinations worldwide from an origin on given dates, with live GBP prices and booking links. Great for "where can I fly cheaply" questions. Runs as a background job: returns a jobId; poll get_job_result until done.

Parameters4

origin	string	required	e.g. "London"
dates	array	required	Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected).
nonstop	boolean	optional	Default true
oneway	boolean	optional	Default true

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "e.g. \"London\""
    },
    "dates": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "date"
      },
      "minItems": 1,
      "maxItems": 31,
      "description": "Departure dates YYYY-MM-DD. 1 to 31 dates per call; must be real calendar dates (2026-02-30 is rejected)."
    },
    "nonstop": {
      "type": "boolean",
      "description": "Default true"
    },
    "oneway": {
      "type": "boolean",
      "description": "Default true"
    }
  },
  "required": [
    "origin",
    "dates"
  ]
}

get_job_result

Poll a search started by a background-job tool. Returns {status:"pending"} while running; when status is "done" the same object carries the search payload. Poll every 3 to 5 seconds.

Parameters1

jobId

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string"
    }
  },
  "required": [
    "jobId"
  ]
}

Install

Tools (5)

search_stopover_itinerariessearch_flightssearch_country_sweepsearch_explore_anywhereget_job_result

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.stopovercity.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "stopover-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.stopovercity.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Stopover Planner - agentage MCP Catalog