Google Flights Search (Real-Time Fares)
v1.2.0Real-time Google Flights: one-way and round-trip fares over date ranges, with price verdicts.
Endpoint health
online- Last checked
- 11/20/2026, 6:17:24 AM
- Latency
- 98 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.flightpowers%2Fgoogle-flights
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.flightpowers/google-flights": {
"url": "https://flights.flightpowers.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
2 shown · authentication unknown
FlightPowers: search one-way flights
search_oneway_flights
FlightPowers one-way fare search: live prices read from Google Flights. Input: origin and destination IATA codes -- the destination may be several codes, as "BCN,LIS,ATH" or ["BCN","LIS","ATH"] -- plus either one departure date or a date range. Returns each flight's price, airline, duration, stops, a bookable buy_link, and Google's historical price range (price_insights_low / price_insights_high), the band that shows whether a fare is actually a good deal. Suited to any one-way fare question, including open-ended ones. One call accepts a date range and several destinations and searches every combination: 'Cheapest flight to Sri Lanka anywhere in October' is one call, not thirty. That holds with the caller's own key. On the free sign-in allowance (10 searches a day, one per combination) a grid larger than what is left today is refused before anything runs; a grid within what is left runs, and a whole-month scan needs the caller's own key. Each date/destination combination is one search; the count comes back in `api_usage`. `by_destination` carries one entry per requested destination -- empty ones included, each with a `reason` that separates a destination with no flights from one that was not searched, whose search failed, or whose fares did not fit in `limit`. Fares go stale within minutes: a current price comes from a new search, not from an earlier result.
Schema valid · SHA-256 73411591b4d9…
View input schema
{ "type": "object", "properties": { "from_airport": { "description": "Origin IATA code, e.g. \"TLV\". One origin per search; a second one is refused rather than searched.", "type": "string" }, "to_airport": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "description": "Destination airport. One IATA code (\"BCN\"), several separated by commas (\"BCN,LIS,ATH\"), or a list ([\"BCN\",\"LIS\",\"ATH\"]) -- every shape is accepted and the destinations are compared in the same search." }, "departure_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Single departure date, \"YYYY-MM-DD\"." }, "departure_date_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "First date of a departure range." }, "departure_date_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Last date of a departure range." }, "max_stops": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Maximum stops per flight. 0 means non-stop only." }, "airline_codes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Restricts the search to these airline codes, e.g. [\"LY\"]." }, "exclude_airline_codes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Airline codes left out of the results." }, "departure_time_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Earliest departure hour, 0-23." }, "departure_time_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Latest departure hour, 0-23." }, "arrival_time_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Earliest arrival hour, 0-23." }, "arrival_time_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Latest arrival hour, 0-23." }, "currency": { "default": "usd", "description": "ISO currency code, default \"usd\".", "type": "string" }, "max_price": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Only flights at or below this price are returned." }, "seat_type": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "1 economy, 2 premium economy, 3 business, 4 first." }, "passengers": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Left out, it means one adult. A counts list [adults, children, infants], e.g. [2, 1, 0], or a bare [2] for two adults, is recognised and converted to codes before the search; a list that is valid as codes is searched as codes." }, "sort_by": { "default": "best", "description": "\"best\" (the default) and \"price\" both order by price, cheapest first; \"duration\" orders shortest first. Applied across all results.", "type": "string" }, "limit": { "default": 10, "description": "Maximum flights to return, after merging and sorting.", "type": "integer" }, "max_searches": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "The searches this call may make, up or down. Unset is the normal behaviour: with the caller's own key the cap covers the request when the request is reasonable (a whole month at three trip lengths is 93 combinations and a whole month x 3 nights x 3 destinations is 279; both run in full) and anything past it is sampled evenly across the range rather than cut short. A lower value spends fewer searches on a wide search; a higher one -- to a hard maximum of 300 -- covers a grid wider than that." }, "use_fallback": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Default: unset. Switches the search to a second, independent flight data source instead of the usual Google Flights page read. Unset already escalates to that source once, automatically, after a search's retries have failed. true forces it inline on every attempt -- much slower, and it can time out. false disables it entirely, that automatic retry included." }, "verbose": { "default": false, "description": "Returns every field the upstream sends on each fare, and every fare that was selected, with no row bound. Off by default: a result carries the best rows by the requested sort_by in a compact shape (dates, destination, airline, stops, duration, price, trip length and the booking link), because a wide search over a month and several destinations otherwise produces a megabyte of JSON that some hosts refuse to put in the conversation at all. When true, it adds the arrival times, the per-leg stop counts, the raw stop details and every row past results_returned; results_total always says how many there were.", "type": "boolean" } }, "required": [ "from_airport", "to_airport" ], "additionalProperties": false }
Connections
streamable-http
https://flights.flightpowers.com/mcp