search_deals
Search the flight fares Sparkflights has found, ranked by cost per mile against each market's limit. Each deal shows when its price was last checked, and prices can change after that; an empty result means Sparkflights has no fare that matches, not that no flights exist. Each deal has the price text of its Sparkflights fare page; url, the fare page; route_url, the route page, which lists the route's fares and price history; and feed_url, the route's JSON feed of new fares. A search naming an origin or destination also returns fares when its deals are fewer than limit: the lowest fares Sparkflights has seen for that place, each with its price, dates, airline, seen_at (when it was seen) and route_url, its route page. A fare has no id or fare page yet.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_deals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order: cpm (default; cost per mile against its market's CPM ceiling, lowest first) or recent (newest first; newest is the same) | |
| cabin | No | Cabin classes, one or more of: economy, premium_economy, business, first | |
| limit | No | Max results, 1-25. Default 10. | |
| origin | No | Where the trip starts: an IATA airport code (JFK) for that airport, or a city for every airport the city's route pages cover: its name (New York), a metro code (NYC), or its name with its country or state (London, UK; Portland, Oregon) | |
| low_cost | No | true returns only budget/low-cost carrier deals; overrides include_budget | |
| max_price | No | US dollars: only deals listed at or under this price | |
| destination | No | Where the trip goes: an IATA airport code (NRT) for that airport, or a city for every airport the city's route pages cover: its name (Tokyo), a metro code (TYO), or its name with its country or state (London, UK; Portland, Maine) | |
| depart_month | No | YYYY-MM, for example 2026-12: only deals whose first departure date is in that month | |
| origin_region | No | Departure regions, one or more of: africa, asia, caribbean, europe, north_america, oceania, south_america. Default: the regions the deal board lists, or every region when origin is given | |
| include_budget | No | Add budget/low-cost carrier deals (Spirit, Frontier, etc.) to the others. Default false — budget deals are on /flights/budget. | |
| destination_region | No | Destination regions, one or more of: africa, asia, caribbean, europe, north_america, oceania, south_america |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deals | No | ||
| error | No | ||
| fares | No |