tool_fare_calendar
Find the cheapest day to fly within a month by analyzing day-of-week price tiers and best weeks. Sample departure dates provided for one month.
Instructions
PRICE timing (day-level): cheapest DAY to fly within ONE month.
Samples up to 15 departure dates in one month — day-of-week analysis, price tiers, best/worst weeks. For cheapest MONTH across a year use find_cheapest_month; for best weather use best_month_to_visit.
Args: origin: Origin airport IATA code (e.g., "JFK") destination: Destination airport IATA code (e.g., "LHR") year: Year (default: next occurrence of month) month: Month 1-12 (default: next month) adults: Number of passengers cabin_class: economy | premium_economy | business | first currency: Currency code (e.g., "USD", "EUR", "GBP") trip_length_days: If set, price as round-trip (return = departure + N days)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"origin": "<origin>",
"destination": "<destination>"
},
"name": "tool_fare_calendar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | ||
| month | No | ||
| adults | No | ||
| origin | Yes | ||
| currency | No | USD | |
| cabin_class | No | economy | |
| destination | Yes | ||
| trip_length_days | No |