Integrates with Google Flights via SerpAPI to provide real-time flight price searches, destination exploration, multi-city trip planning, open-jaw routing, price insights, and booking links.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@flights-mcp Search flights from London to Tokyo in May"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for holiday flight planning powered by Google Flights via SerpAPI. Give any Claude-compatible AI assistant the ability to search real-time flight prices, discover destinations, compare airports, plan multi-country trips, and get booking links.
Resolve any place name — a city, region, or country — into airport IATA codes. Understands that "Nottingham" means East Midlands (EMA), that "London" covers six airports, that "Argentina" has a dozen options, and that "Patagonia" covers airports across both Argentina and Chile (BRC, USH, FTE, PUQ, NQN, CRD, REL, BBA).
Open-ended holiday planning: "Where can I fly from East Midlands in June for under £500?" Returns destinations with flight prices, hotel prices, best travel dates, flight duration, and stops — all sourced from Google Travel Explore.
Also works for domestic route discovery: explore from AEP (Buenos Aires domestic) to see all Argentine destinations, or SCL to see Chilean routes.
Can filter by interest:
Beaches (/m/0b3yr)
Outdoors (/g/11bc58l13w)
History (/m/03g3w)
Museums (/m/09cmq)
Skiing (/m/071k0)
Full Google Flights search with every filter available:
One-way, round-trip, or multi-city
Economy through First class
Nonstop only or max stops
Specific airlines or alliances (Star Alliance, SkyTeam, Oneworld)
Departure/arrival time windows
Max price, max duration, layover duration
Low-emission flights only
Basic economy exclusion (US domestic)
Returns full flight details: price, duration, stops, airline, aircraft type, legroom, amenities, carbon emissions, and price insights (lowest price, typical range, price history).
Find the cheapest day to fly: "When's the cheapest time to fly London to Buenos Aires in April?" Searches every date in a range and returns results sorted by price. Up to 30 days, one API call per date.
Find the cheapest airport to fly from: "Should I fly from East Midlands, Birmingham, or Manchester to Buenos Aires?" Looks up all airports near a location and searches from each one in parallel, returning a ranked price comparison.
Fly into one country and out of another without backtracking. Handles the full combination search automatically: finds all nearby departure airports, tries both directions (fly into Argentina/out of Chile vs fly into Chile/out of Argentina), and returns both options ranked by total combined price. Only 4 API credits regardless of how many airports are compared.
Get a quick read on whether prices for a route are currently cheap, typical, or expensive — without retrieving full flight listings. Returns the lowest recorded price, typical price range, price level, and a human-readable verdict (e.g. "Prices are 18% below typical — good time to book."). Uses 1 API credit.
The arrival-side counterpart to "compare departure airports". Resolves a destination like "Tokyo" or "Patagonia" to all nearby airports and searches each in parallel, returning a ranked list by price. Answers "Should I fly into EZE or AEP?" or "Which Patagonia airport is cheapest from London?". Uses one API credit per airport.
Search for a split itinerary via a hub city for a set number of days. "I want to fly London to Tokyo but spend 3 days in Dubai on the way — what are the cheapest options?" Searches origin → stopover and stopover → destination as separate one-way legs, optionally including a return leg too. Stopover location is resolved to airports automatically. Uses 2 API credits (3 with return).
Find the cheapest combination of departure and return dates for a round trip. "What's the cheapest week to fly London to New York in July?" Generates every (outbound, return) date pair from two date ranges and searches them all in parallel, returning results sorted by price with trip duration. Capped at 30 combinations. Uses 1 API credit per combination.
Chain together multiple legs for internal/domestic routing within a multi-country holiday. "I'm flying into Buenos Aires on Oct 17, want to visit Patagonia on Oct 23, then end in Santiago on Oct 28 — what are the cheapest flights for each leg?"
Location names are resolved to airports automatically — "Patagonia" becomes BRC, USH, FTE, PUQ, NQN, CRD, REL, BBA and a single search covers all of them. Returns the cheapest flight per leg plus up to 3 alternatives so you can compare specific airports (e.g. cheapest might be BRC/Bariloche but you can see FTE/El Calafate options for Perito Moreno). Uses N-1 API credits for N stops.
After finding an outbound flight, retrieve matching return options using the departure_token from the outbound result.
Get direct booking links from airlines and OTAs for a specific flight using the booking_token from any search result.
Related MCP server: Google Flights MCP
Tool | Description |
| Resolve a city/region/country to airport IATA codes |
| Discover where to fly and for how much |
| Full flight search with all filters |
| Find cheapest day to fly across a date range |
| Find cheapest outbound + return date combination |
| Are prices cheap, typical, or expensive right now? |
| Compare prices from all departure airports near a location |
| Compare prices into all arrival airports near a destination |
| Fly into one country, return from another — find cheapest combo |
| Plan internal legs of a multi-country trip |
| Split a long-haul via a stopover city for N days |
| Get return flights for a chosen outbound |
| Get booking links for a specific flight |
Sign up at serpapi.com and get your API key. The free tier includes 100 searches/month.
cp .env.example .env
# Edit .env and set your key:
# SERPAPI_KEYS=your_key_hereMultiple keys can be comma-separated for automatic rotation when one hits its quota:
SERPAPI_KEYS=key_one,key_two,key_threenpm install
npm run buildEdit your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"flights": {
"command": "node",
"args": ["/absolute/path/to/flights-mcp/build/index.js"],
"env": {
"SERPAPI_KEYS": "your_serpapi_key_here"
}
}
}
}find_airports("Nottingham") → EMA, BHX, MAN, LHR, LGW, STN
explore_destinations(departure_id: "EMA,BHX,MAN", month: 7, travel_duration: 2) → ranked list of destinations with prices
compare_airport_prices(location: "Nottingham", arrival_id: "EZE", outbound_date: "2026-06-01", return_date: "2026-06-15") → ranked by price across EMA, BHX, MAN, LHR, LGW
search_flights_flexible(departure_id: "LHR", arrival_id: "HND,NRT", date_from: "2026-05-01", date_to: "2026-05-31") → price per day sorted cheapest first
plan_open_jaw_trip(departure_location: "Nottingham", destination_a: "Argentina", destination_b: "Chile", outbound_date: "2026-10-17", return_date: "2026-10-31") → compares EMA/BHX/MAN/LHR/LGW → EZE/AEP vs SCL, returns cheapest of: (UK→Argentina, Chile→UK) and (UK→Chile, Argentina→UK) with total prices
check_price_insights(departure_id: "LHR", arrival_id: "HND,NRT", outbound_date: "2026-07-15", return_date: "2026-07-29") → price level, typical range, context string
find_cheapest_arrival_airport(departure_id: "LHR", arrival_location: "Tokyo", outbound_date: "2026-07-15", return_date: "2026-07-29") → ranked comparison of NRT vs HND
find_stopover_flights(departure_id: "LHR", arrival_id: "NRT", outbound_date: "2026-07-15", stopover_location: "Dubai", stopover_days: 3, return_date: "2026-07-29") → LHR→DXB leg + DXB→NRT leg + NRT→LHR return
search_price_calendar(departure_id: "LHR", arrival_id: "JFK,EWR", outbound_date_from: "2026-07-01", outbound_date_to: "2026-07-14", return_date_from: "2026-07-10", return_date_to: "2026-07-31") → up to 30 (outbound, return) combinations sorted by price
plan_multi_stop_trip(trip: [{location: "Buenos Aires", date: "2026-10-17"}, {location: "Patagonia", date: "2026-10-23"}, {location: "Santiago", date: "2026-10-28"}]) → 2 API calls: AEP/EZE → BRC/USH/FTE/PUQ/NQN/CRD/REL/BBA, then those → SCL. Returns cheapest + alternatives per leg with total price.
plan_open_jaw_trip(...) → find cheapest UK ↔ Argentina/Chile international legs
plan_multi_stop_trip(...) → find cheapest internal legs between cities
get_booking_options(booking_token: "...") → direct booking links for each flight
Check whether flight prices for a route are currently cheap, typical, or expensive. Returns price_insights data: lowest recorded price, typical price range, price level, and a human-readable context string (e.g. "Prices are 18% below typical — good time to book.").
Auto-detects round-trip vs one-way based on whether return_date is provided. Uses 1 API credit.
Inputs: arrival_id (required), departure_id (required), outbound_date (required), gl, +5 more.
Find the cheapest departure airport for a trip by searching from all major airports near a location in parallel. Answers "Should I fly from East Midlands, Birmingham, or Manchester to Buenos Aires?".
Uses one API credit per airport searched (default 5, max 10). Results are sorted by cheapest price.
Inputs: location (required), arrival_id (required), outbound_date (required), gl, +9 more.
Discover flight destinations and prices from a departure airport using Google Travel Explore. Ideal for open-ended holiday planning: "Where can I fly from London in June?" or "What's cheap from EMA this summer?".
Returns a list of destinations with flight price, hotel price, best travel dates, flight duration, and stops. Use month + travel_duration for flexible date search, or outbound_date + return_date for specific dates. Filter by interest (beaches, skiing, history, etc.) or region using arrival_area_id.
Also excellent for discovering domestic/internal flights: explore from AEP (Buenos Aires domestic airport) to see all Argentine destinations, or from SCL to see Chilean domestic routes.
Inputs: departure_id (required), gl, hl, bags, +16 more.
Find airport IATA codes by city, region, country, or airport name. Use this before searching flights to resolve place names to airport codes — especially useful for finding all airports near a city (e.g. 'Nottingham' returns EMA, BHX, MAN, LHR...) or all major airports in a country/region (e.g. 'Argentina' returns EZE, AEP, COR...). Returns IATA code, name, city, country, and any additional cities/regions served.
Inputs: query (required), limit.
Find the cheapest airport to fly into at a destination by comparing all airports near a location in parallel. The arrival-side counterpart to compare_airport_prices.
Answers "Which Tokyo airport is cheapest to fly into from London?" or "Should I fly into EZE or AEP in Buenos Aires?". Uses one API credit per airport (default 5, max 10). Results sorted by cheapest price.
Inputs: departure_id (required), outbound_date (required), arrival_location (required), gl, +9 more.
Search for a split itinerary via a stopover city — fly into a hub, spend N days, then continue to your final destination. E.g. LHR → Dubai (3 days) → NRT.
Searches: origin → stopover on outbound_date, stopover → destination on outbound_date + stopover_days. Optionally also searches destination → origin on return_date. Stopover location is resolved to airports automatically.
Uses 2 API credits (3 if return_date provided).
Inputs: arrival_id (required), departure_id (required), outbound_date (required), stopover_days (required), +9 more.
Get booking links and price breakdown for a specific flight. Pass the booking_token from a search_flights or get_return_flights result. Returns booking options from different airlines/OTAs with direct links.
Inputs: arrival_id (required), departure_id (required), booking_token (required), outbound_date (required), +3 more.
After searching one-way outbound flights, use this to get matching return flight options for a selected outbound flight. Pass the departure_token from the outbound search result.
Inputs: arrival_id (required), departure_id (required), outbound_date (required), departure_token (required), +3 more.
Plan a multi-leg trip by searching each leg in parallel. Ideal for internal/domestic routing within a multi-country holiday: "I'll be in Buenos Aires on Oct 17, want to visit Patagonia on Oct 23, then end in Santiago on Oct 28 — what are the cheapest flights?"
Each stop is resolved to nearby airports automatically (e.g. "Patagonia" → BRC, USH, FTE, PUQ, BBA). Uses 1 API credit per leg (N-1 credits for N stops). Returns the cheapest flight per leg plus up to 3 alternatives so you can compare specific airport options (e.g. cheapest into Patagonia might be BRC, but you can see FTE/El Calafate options too).
Inputs: trip (required), gl, hl, stops, +5 more.
Plan an open-jaw trip visiting two destinations — fly into one country and out of another without backtracking. Ideal for "Nottingham to Argentina and Chile in October: what's the cheapest combination?".
Searches all nearby departure airports at once and compares two itinerary directions:
Option A: fly into destination_a, return from destination_b
Option B: fly into destination_b, return from destination_a
Returns both options ranked by total combined price (outbound + return), with flight details and booking tokens for each leg. Uses 4 API credits total.
Inputs: return_date (required), destination_a (required), destination_b (required), outbound_date (required), +10 more.
Search for flights using Google Flights data via SerpAPI. Returns best_flights and other_flights with full details (price, duration, stops, airline, aircraft, legroom, amenities, carbon emissions) plus price_insights (lowest price, typical range, price history).
Each result includes a booking_token (to get booking links) and for one-way results a departure_token (to get matching return flights for round-trips).
Supports one-way, round-trip, and multi-city. Filters include: nonstop only, max price, cabin class, specific airlines, departure/arrival time windows, layover duration, connecting airport exclusions, and emissions.
Inputs: arrival_id (required), departure_id (required), outbound_date (required), gl, +25 more.
Search for flights across a range of dates to find the cheapest day to fly. Returns one result per date sorted by price — ideal for answering "When's the cheapest time to fly to Tokyo in April?".
Uses one API credit per date searched (capped at 30 days). Failures on individual dates are returned as errors rather than failing the whole request.
Inputs: date_to (required), date_from (required), arrival_id (required), departure_id (required), +9 more.
Search a grid of outbound + return date combinations to find the cheapest week to fly. Answers "What's the cheapest combination of July departure and August return for LHR-JFK?".
Generates all (outbound, return) pairs from two date ranges (return must be after outbound), capped at 30 combinations searched in parallel. Returns results sorted by cheapest price with trip_days calculated.
Uses 1 API credit per date combination (max 30).
Inputs: arrival_id (required), departure_id (required), return_date_to (required), outbound_date_to (required), +9 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 13 tools
Every tool has a clearly distinct purpose: search_flights handles standard queries, while flexible, calendar, and stopover variants cover specialized date/route patterns. Follow-up tools (get_return_flights, get_booking_options) chain logically without overlap.
All tools follow a consistent snake_case verb_noun pattern (search_, get_, find_, explore_, compare_, plan_, check_). The naming clearly indicates the action and subject, making the set predictable.
13 tools is well within the ideal range for a flight-search domain. Each tool addresses a distinct user need, from airport lookup to complex multi-city planning, without feeling bloated.
The tool surface covers the full flight planning workflow: resolve airports, search with various flexibility options, compare airports, plan multi-stop/open-jaw itineraries, check price insights, and obtain booking links. No obvious gaps for the stated purpose.
Flight search MCP server providing search, pagination, and itinerary details for AI assistants.
Geo-based flight search MCP server. Find more flights between any two places on earth
Search and compare flight offers through a cache-aware Streamable HTTP MCP server for AI agents.
Skiplagged MCP Server for flight search, hotel booking, and travel planning
