Google Flights itineraries with fares, legs, carbon emissions and price history, as JSON.
Call this server's tools from your browser. Nothing to install.
HasData API key, created at app.hasdata.com. 1,000 free credits every month, no card.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get Google Flights Results Searches Google Flights for one-way, round-trip, or multi-city itineraries with passenger mix (adults, children, infants in-seat/on-lap), travel class, bags, max price, sort order (price, duration, emissions, departure/arrival time), stops, include/exclude airlines and connections, time windows, layover duration, and deep-search mode. Returns per-itinerary price, total duration, stops, flight legs with airline, flight number, aircraft, departure/arrival airports and times, CO2 emissions, plus booking and departure tokens for round-trip returns or booking options. Use for travel-planning agents, fare monitoring, corporate travel dashboards, emission-aware trip optimization, and comparing routes and airlines across markets.
Specifies the arrival airport code (IATA) or location kgmid. - **IATA Code**: A 3-letter uppercase code (e.g., `SFO` for San Francisco, `LHR` for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search). - **Location kgmid**: A string starting with `/m/`, found in Wikidata under "Freebase ID" (e.g., `/m/02_286` for New York, NY). Multiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).
Specifies the departure airport code (IATA) or location kgmid. - **IATA Code**: A 3-letter uppercase code (e.g., SFO for San Francisco, LHR for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search). - **Location kgmid**: A string starting with `/m/`, found in Wikidata under "Freebase ID" (e.g., `/m/02_286` for New York, NY). Multiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).
The outbound travel date in 'yyyy-MM-dd' format.
The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`.
The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`.
Number of carry-on bags per passenger.
Specifies the type of flight. Options: - `roundTrip` (default) - `oneWay` - `multiCity` (requires `multiCityJson` for flight details) For round trips, retrieve return flight details with a separate request using `departureToken`.
Restrict the number of stops (layovers) in the flight itinerary.
Number of adult passengers (>= 1 if specified).
Sort the flight results based on price, departure time, arrival time, etc.
Number of child passengers.
Parameter defines the currency of the returned prices Provide one exact documented value (71 allowed), e.g. `ALL`, `DZD`.
Maximum price limit for the flight search, in the selected currency.
Enable deep search. Returns the same results as Google Flights in a browser, but takes longer to respond. Default is `false`.
The return travel date in 'yyyy-MM-dd' format. Required when **type** is `roundTrip`.
Indicates whether to include hidden options in the results.
The maximum total flight duration in minutes.
Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter return flights. Each number represents the start of an hour. Examples: - `6,20` → 6:00 AM - 9:00 PM departure - `1,15` → 1:00 AM - 4:00 PM departure - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival
The travel class for the flight (Economy, Premium Economy, Business, or First).
Used to request booking options for selected flights. This token is found in the flight results and cannot be used with `departureToken`.
Number of infants sitting on an adult's lap.
Number of infants occupying seats.
Prefer flight options with lower carbon emissions.
This parameter specifies flight details for multi-city trips. It is a JSON string containing multiple flight objects. Each object must include the following fields: - **departureId** – The departure airport code or location KGMID. Uses the same format as the main `departureId` parameter. - **arrivalId** – The arrival airport code or location KGMID. Uses the same format as the main `arrivalId` parameter. - **date** – The flight date. Uses the same format as the `outboundDate` parameter. - **times** *(optional)* – The time range for the flight. Uses the same format as the `outboundTimes` parameter.
Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter flights. Each number represents the start of an hour. Examples: - `6,20` → 6:00 AM - 9:00 PM departure - `1,15` → 1:00 AM - 4:00 PM departure - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival
Used to select a flight and retrieve return flights for a round trip or the next leg of the itinerary for a multi-city trip.
A comma separated list of airline codes to exclude from results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines.
A comma separated list of airline codes to exclusively include in results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines. `excludeAirlines` and `includeAirlines` parameters can't be used together.
Set the maximum layover duration in minutes to filter flights. For example, `120, 360` filters layovers between 2 hours and 6 hours, while `45, 180` allows layovers from 45 minutes to 3 hours.
A comma separated list of specific airports to exclude as connections.
A comma separated list of specific airports to allow as connections.
Get Google Flights Results Searches Google Flights for one-way, round-trip, or multi-city itineraries with passenger mix (adults, children, infants in-seat/on-lap), travel class, bags, max price, sort order (price, duration, emissions, departure/arrival time), stops, include/exclude airlines and connections, time windows, layover duration, and deep-search mode. Returns per-itinerary price, total duration, stops, flight legs with airline, flight number, aircraft, departure/arrival airports and times, CO2 emissions, plus booking and departure tokens for round-trip returns or booking options. Use for travel-planning agents, fare monitoring, corporate travel dashboards, emission-aware trip optimization, and comparing routes and airlines across markets.
| Argument | Type | Description |
|---|---|---|
| gl | string | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. |
| hl | string | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. |
| bags | number | Number of carry-on bags per passenger. |
| type | string | Specifies the type of flight. Options: - `roundTrip` (default) - `oneWay` - `multiCity` (requires `multiCityJson` for flight details) For round trips, retrieve return flight details with a separate request using `departureToken`. |
| stops | string | Restrict the number of stops (layovers) in the flight itinerary. |
| adults | number | Number of adult passengers (>= 1 if specified). |
| sortBy | string | Sort the flight results based on price, departure time, arrival time, etc. |
| children | number | Number of child passengers. |
| currency | string | Parameter defines the currency of the returned prices Provide one exact documented value (71 allowed), e.g. `ALL`, `DZD`. |
| maxPrice | number | Maximum price limit for the flight search, in the selected currency. |
| arrivalId* | string | Specifies the arrival airport code (IATA) or location kgmid. - **IATA Code**: A 3-letter uppercase code (e.g., `SFO` for San Francisco, `LHR` for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search). - **Location kgmid**: A string starting with `/m/`, found in Wikidata under "Freebase ID" (e.g., `/m/02_286` for New York, NY). Multiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`). |
| deepSearch | boolean | Enable deep search. Returns the same results as Google Flights in a browser, but takes longer to respond. Default is `false`. |
| returnDate | string | The return travel date in 'yyyy-MM-dd' format. Required when **type** is `roundTrip`. |
| showHidden | boolean | Indicates whether to include hidden options in the results. |
| departureId* | string | Specifies the departure airport code (IATA) or location kgmid. - **IATA Code**: A 3-letter uppercase code (e.g., SFO for San Francisco, LHR for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search). - **Location kgmid**: A string starting with `/m/`, found in Wikidata under "Freebase ID" (e.g., `/m/02_286` for New York, NY). Multiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`). |
| maxDuration | number | The maximum total flight duration in minutes. |
| returnTimes | string | Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter return flights. Each number represents the start of an hour. Examples: - `6,20` → 6:00 AM - 9:00 PM departure - `1,15` → 1:00 AM - 4:00 PM departure - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival |
| travelClass | string | The travel class for the flight (Economy, Premium Economy, Business, or First). |
| bookingToken | string | Used to request booking options for selected flights. This token is found in the flight results and cannot be used with `departureToken`. |
| infantsOnLap | number | Number of infants sitting on an adult's lap. |
| outboundDate* | string | The outbound travel date in 'yyyy-MM-dd' format. |
| infantsInSeat | number | Number of infants occupying seats. |
| lessEmissions | boolean | Prefer flight options with lower carbon emissions. |
| multiCityJson | string | This parameter specifies flight details for multi-city trips. It is a JSON string containing multiple flight objects. Each object must include the following fields: - **departureId** – The departure airport code or location KGMID. Uses the same format as the main `departureId` parameter. - **arrivalId** – The arrival airport code or location KGMID. Uses the same format as the main `arrivalId` parameter. - **date** – The flight date. Uses the same format as the `outboundDate` parameter. - **times** *(optional)* – The time range for the flight. Uses the same format as the `outboundTimes` parameter. |
| outboundTimes | string | Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter flights. Each number represents the start of an hour. Examples: - `6,20` → 6:00 AM - 9:00 PM departure - `1,15` → 1:00 AM - 4:00 PM departure - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival |
| departureToken | string | Used to select a flight and retrieve return flights for a round trip or the next leg of the itinerary for a multi-city trip. |
| excludeAirlines | string | A comma separated list of airline codes to exclude from results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines. |
| includeAirlines | string | A comma separated list of airline codes to exclusively include in results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines. `excludeAirlines` and `includeAirlines` parameters can't be used together. |
| layoverDuration | string | Set the maximum layover duration in minutes to filter flights. For example, `120, 360` filters layovers between 2 hours and 6 hours, while `45, 180` allows layovers from 45 minutes to 3 hours. |
| excludeConnections | string | A comma separated list of specific airports to exclude as connections. |
| includeConnections | string | A comma separated list of specific airports to allow as connections. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"departureId",
"arrivalId",
"outboundDate"
],
"properties": {
"gl": {
"type": "string",
"description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
},
"hl": {
"type": "string",
"description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
},
"bags": {
"type": "number",
"description": "Number of carry-on bags per passenger.\n"
},
"type": {
"enum": [
"roundTrip",
"oneWay",
"multiCity"
],
"type": "string",
"description": "Specifies the type of flight. Options:\n\n - `roundTrip` (default)\n - `oneWay`\n - `multiCity` (requires `multiCityJson` for flight details)\n\nFor round trips, retrieve return flight details with a separate request using `departureToken`.\n"
},
"stops": {
"enum": [
"nonStop",
"oneStopOrFewer",
"twoStopsOrFewer"
],
"type": "string",
"description": "Restrict the number of stops (layovers) in the flight itinerary.\n"
},
"adults": {
"type": "number",
"description": "Number of adult passengers (>= 1 if specified).\n"
},
"sortBy": {
"enum": [
"topFlights",
"price",
"departureTime",
"arrivalTime",
"duration",
"emissions"
],
"type": "string",
"description": "Sort the flight results based on price, departure time, arrival time, etc.\n"
},
"children": {
"type": "number",
"description": "Number of child passengers.\n"
},
"currency": {
"type": "string",
"description": "Parameter defines the currency of the returned prices Provide one exact documented value (71 allowed), e.g. `ALL`, `DZD`."
},
"maxPrice": {
"type": "number",
"description": "Maximum price limit for the flight search, in the selected currency.\n"
},
"arrivalId": {
"type": "string",
"description": "Specifies the arrival airport code (IATA) or location kgmid.\n\n - **IATA Code**: A 3-letter uppercase code (e.g., `SFO` for San Francisco, `LHR` for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search).\n - **Location kgmid**: A string starting with `/m/`, found in Wikidata under \"Freebase ID\" (e.g., `/m/02_286` for New York, NY).\n\nMultiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).\n"
},
"deepSearch": {
"type": "boolean",
"description": "Enable deep search. Returns the same results as Google Flights in a browser, but takes longer to respond. Default is `false`.\n"
},
"returnDate": {
"type": "string",
"description": "The return travel date in 'yyyy-MM-dd' format. Required when **type** is `roundTrip`.\n"
},
"showHidden": {
"type": "boolean",
"description": "Indicates whether to include hidden options in the results.\n"
},
"departureId": {
"type": "string",
"description": "Specifies the departure airport code (IATA) or location kgmid.\n\n - **IATA Code**: A 3-letter uppercase code (e.g., SFO for San Francisco, LHR for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search).\n - **Location kgmid**: A string starting with `/m/`, found in Wikidata under \"Freebase ID\" (e.g., `/m/02_286` for New York, NY).\n\nMultiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).\n"
},
"maxDuration": {
"type": "number",
"description": "The maximum total flight duration in minutes.\n"
},
"returnTimes": {
"type": "string",
"description": "Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter return flights. Each number represents the start of an hour.\n\nExamples:\n - `6,20` → 6:00 AM - 9:00 PM departure\n - `1,15` → 1:00 AM - 4:00 PM departure\n - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival\n"
},
"travelClass": {
"enum": [
"economy",
"premiumEconomy",
"business",
"first"
],
"type": "string",
"description": "The travel class for the flight (Economy, Premium Economy, Business, or First).\n"
},
"bookingToken": {
"type": "string",
"description": "Used to request booking options for selected flights. This token is found in the flight results and cannot be used with `departureToken`.\n"
},
"infantsOnLap": {
"type": "number",
"description": "Number of infants sitting on an adult's lap.\n"
},
"outboundDate": {
"type": "string",
"description": "The outbound travel date in 'yyyy-MM-dd' format.\n"
},
"infantsInSeat": {
"type": "number",
"description": "Number of infants occupying seats.\n"
},
"lessEmissions": {
"type": "boolean",
"description": "Prefer flight options with lower carbon emissions.\n"
},
"multiCityJson": {
"type": "string",
"description": "This parameter specifies flight details for multi-city trips. It is a JSON string containing multiple flight objects. Each object must include the following fields:\n\n- **departureId** – The departure airport code or location KGMID. Uses the same format as the main `departureId` parameter.\n- **arrivalId** – The arrival airport code or location KGMID. Uses the same format as the main `arrivalId` parameter.\n- **date** – The flight date. Uses the same format as the `outboundDate` parameter.\n- **times** *(optional)* – The time range for the flight. Uses the same format as the `outboundTimes` parameter.\n"
},
"outboundTimes": {
"type": "string",
"description": "Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter flights. Each number represents the start of an hour.\n\nExamples:\n - `6,20` → 6:00 AM - 9:00 PM departure\n - `1,15` → 1:00 AM - 4:00 PM departure\n - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival\n"
},
"departureToken": {
"type": "string",
"description": "Used to select a flight and retrieve return flights for a round trip or the next leg of the itinerary for a multi-city trip.\n"
},
"excludeAirlines": {
"type": "string",
"description": "A comma separated list of airline codes to exclude from results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines.\n"
},
"includeAirlines": {
"type": "string",
"description": "A comma separated list of airline codes to exclusively include in results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines.\n\n`excludeAirlines` and `includeAirlines` parameters can't be used together.\n"
},
"layoverDuration": {
"type": "string",
"description": "Set the maximum layover duration in minutes to filter flights. For example, `120, 360` filters layovers between 2 hours and 6 hours, while `45, 180` allows layovers from 45 minutes to 3 hours.\n"
},
"excludeConnections": {
"type": "string",
"description": "A comma separated list of specific airports to exclude as connections.\n"
},
"includeConnections": {
"type": "string",
"description": "A comma separated list of specific airports to allow as connections.\n"
}
},
"additionalProperties": false
}