flight-fares

Returns the cheapest observed one-way fare between two cities, plus the six-month low and the departure date on which the low was observed. Use whenever the user names an origin and a destination and asks about price, the cheapest date to fly, or whether a fare is a good deal. Both arguments are required; neither alone produces a valid answer. Answers are directional and per pair - PAR to BKK is not BKK to PAR and is not PAR to SIN. Prices are cached snapshots, never live quotes: say "last observed", never "current price", and surface live_check_url to any user about to book.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin city. Uppercase IATA city code such as PAR. A city slug such as paris also resolves. If you cannot resolve the city, call resolve_city first - do not guess a code."
    },
    "to": {
      "type": "string",
      "description": "Destination city. Uppercase IATA city code such as BKK. Must differ from from."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

Returns destinations reachable from one origin, sorted cheapest first. Use when the user asks where they can fly cheaply from a city, or wants inspiration rather than one specific pair. One call replaces dozens of page fetches. Prices are cached snapshots.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin city. Uppercase IATA city code such as LON."
    },
    "limit": {
      "type": "integer",
      "description": "How many destinations to return, 1-200. Default 40.",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "from"
  ],
  "additionalProperties": false
}

Turns a spoken city name into the uppercase IATA city code the other tools expect. Call this before find_cheapest_fare whenever you are not certain of a code. Do not invent codes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "City name or partial name, e.g. \"sao paulo\"."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}