SlickTrip

[
  {
    "name": "search_flights",
    "title": "Search flights",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Call this tool to find flights once the traveler has told you their dates. It handles one-way trips, round trips, two possible dates each way, and up to three airports on each side at once.\n\nBefore you call it, you need four things from the traveler: where they are flying from, where they are flying to, the date they want to leave, and, for a round trip, the date they want to come back. If the traveler has not told you any of these, ask them for everything that is missing in one question. Do not"
  },
  {
    "name": "search_return_flights",
    "title": "Search return flights",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use after search_flights when the traveler wants a specific return, or the next leg of a multi-city trip (once per remaining leg). Takes an outbound itinerary_id; returns complete itineraries with the trip total, needs_leg false once the trip is whole. Filters apply to the leg being chosen. Not needed for an outbound watch."
  },
  {
    "name": "price_calendar",
    "title": "Price calendar",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use price_calendar only for a traveler who is flexible within a period they named (for example \"sometime in March\", \"any weekend in December\", \"this winter\"), has told you how many nights they want to stay, and wants to know which days are cheapest.\n\nIt shows the cheapest fare for each departure day, across about two months starting with the month you give. With max_stops=0 it also shows which days have a nonstop flight, for a traveler who is flexible within a period they named and wants a nonst"
  },
  {
    "name": "track_flight",
    "title": "Track a flight's price",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to start price alerts on an itinerary from a search, after the traveler confirms (asking for alerts is confirming). One way: any itinerary_id from search_flights. Round trip: an outbound itinerary_id from search_flights watches that outbound with its cheapest return; a complete itinerary_id from search_return_flights tracks that exact pairing. Multi-city: a complete itinerary_id. Alerts go to the account's channels on a new low; alert_rule any hears every move; target_price_usd sets a bar."
  },
  {
    "name": "list_tracked_flights",
    "title": "List tracked flights",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use to see the flight price alerts on the signed-in account: route, dates, cabin, alert settings, each itinerary's current price against the price when tracking began, and the search_key and fid that stop_tracking_flight and update_flight_tracking take."
  },
  {
    "name": "stop_tracking_flight",
    "title": "Stop tracking a flight",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to stop price alerts for a tracked route (search_key from list_tracked_flights), or one itinerary in it (fid). Cannot be undone; confirm first."
  },
  {
    "name": "recent_deals",
    "title": "Recent deals",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use for 'any deals right now?': the freshest price-drop alerts SlickTrip actually sent, by category (flights, hotels, seats, flexible routes). Not a search; no account needed."
  },
  {
    "name": "find_places",
    "title": "Find airport and city codes",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when unsure of an airport or city code before searching. Matches a place name or code and returns the code to pass as origin or destination, whether it is one airport or all airports in a city, and the airports a city code covers. Not needed for well-known codes like JFK or LHR."
  },
  {
    "name": "booking_options",
    "title": "Sellers for an itinerary",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler wants to book flights they have chosen: the sellers offering that exact itinerary (airline direct and agencies), each with its price and a link that opens its checkout on the seller's site. Takes a complete itinerary_id: one-way from search_flights, round trip from search_return_flights. Not for an outbound alone (choose a return first) and not a price watch (track_flight)."
  },
  {
    "name": "hotel_booking_options",
    "title": "Sellers for a hotel",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler wants to book a hotel from search_hotels: every seller quoting it for those dates (the hotel itself and booking sites), each with the stay total and a link that opens its checkout on the seller's site. Takes the search_key and hotel_id from search_hotels. Not a price watch (track_hotel)."
  },
  {
    "name": "hotel_details",
    "title": "Hotel details",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler asks for the details, more information, photos, rooms or description of one hotel from search_hotels: description, photos, guest rating, amenities, the sellers' stay totals, the rooms, check-in and check-out times. Takes the search_key and hotel_id from search_hotels. Not for prices across dates (hotel_price_calendar). Booking links are hotel_booking_options; call that only when they say book."
  },
  {
    "name": "flight_lookup",
    "title": "Flights on a route that day",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Call this tool when the traveler wants to know which flights operate on a route on a given date, or when you need a flight number for seat_availability or track_seats. It returns the departure and arrival times, the airline, the aircraft and the stops. It does not return prices. To find prices, use search_flights."
  },
  {
    "name": "shared_trip",
    "title": "Open a shared trip",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler pastes a slicktrip.com/share link: the shared itinerary or bucket list and its current price, so they can start their own watch on it. Takes the link or its code. Not for making a link (share_link)."
  },
  {
    "name": "route_airlines",
    "title": "Airlines on a route",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler asks who flies a route, or before filtering by airline: the carriers on the route, nonstop ones first, with the codes the airlines filters take. Not a fare search."
  },
  {
    "name": "explore_destinations",
    "title": "Cheapest places to go",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler wants the cheapest place to fly from somewhere, or ideas for where to go, instead of a destination they already chose: \"the cheapest flight from Warsaw, anywhere\", \"where can I go cheaply\", \"the cheapest city in Brazil\". Returns destinations cheapest first with the airline, stops and a search_url: priced on the traveler's dates when you give depart_date (and return_date for a round trip), else each on its own cheapest dates in the coming months."
  },
  {
    "name": "search_hotels",
    "title": "Search hotels",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use when the traveler wants a place to stay for known dates. Returns hotels cheapest first with star class, guest rating, per-night and whole-stay price, hotel_ids and a search_key for track_hotel and hotel_price_calendar, and a search_url. Filters match the site: price, stars, guest rating, property kinds, amenities, free cancellation, hotels or vacation rentals, bedrooms (rentals), sort. Not for flexible months (add_hotel_bucket_list)."
  },
  {
    "name": "track_hotel",
    "title": "Track a hotel's price",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to start price alerts on one hotel from search_hotels for those dates, after the traveler confirms. Alerts go to the account's channels when the price drops."
  },
  {
    "name": "list_tracked_hotels",
    "title": "List tracked hotels",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use to see the hotel price alerts on the signed-in account: stay dates, guests, each hotel's current price against the price when tracking began, and the tracking_id and hotel_id the update and stop tools take."
  },
  {
    "name": "stop_tracking_hotel",
    "title": "Stop tracking a hotel",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to stop price alerts for a tracked stay (tracking_id from list_tracked_hotels), or one hotel in it (hotel_id). Cannot be undone; confirm first."
  },
  {
    "name": "seat_availability",
    "title": "Seat availability",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use to see which seats are open right now on one flight (needs a signed-in SlickTrip account; nothing is charged or changed): open seat numbers by row, counts of window, aisle, middle and exit-row seats, and rows with two seats together. Needs the flight number, route and date. Then track_seats to be told when a seat opens. Not for prices."
  },
  {
    "name": "track_seats",
    "title": "Track seats on a flight",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to start seat alerts on one flight, after the traveler confirms: named seats, or every seat of a kind (window, aisle, middle, any), optionally only when N seats open together in a row. Alerts go to the account's channels when a watched seat opens."
  },
  {
    "name": "list_tracked_seats",
    "title": "List tracked seats",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Use to see the seat alerts on the signed-in account: flight, departure, cabin, the seats watched and which are open now, and the tracking_key the update and stop tools take."
  },
  {
    "name": "stop_tracking_seats",
    "title": "Stop tracking seats",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use to stop the seat alert on one flight (tracking_key from list_tracked_seats). Cannot be undone; confirm first."
  },
  {
    "name": "add_flight_bucket_list",
    "title": "Add a flight bucket list",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Call this tool when the traveler wants to be alerted about a route over flexible dates, for example \"tell me when New York to Tokyo drops under $700 this winter\". SlickTrip keeps searching the months or dates the traveler chose and alerts them when a fare is under their price limit. It returns a bucket_id.\n\nWhen the traveler asks to be alerted, call it now: that is their go-ahead. Otherwise offer it first.\n\nUse the months, the number of nights and the price limit the traveler gave you, and the d"
  },
  {
    "name": "add_hotel_bucket_list",
    "title": "Add a hotel bucket list",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Use for flexible-date hotel watches on a place or one named hotel: SlickTrip keeps searching stays of the given length across the chosen months or date window and alerts when a stay clears the per-night bar. Returns a bucket_id. When the traveler asks to be alerted, call it now; otherwise offer it first. Not for fixed dates (search_hotels, then track_hotel)."
  }
]