flight-status
ChatGPTCHECK EXISTING FLIGHT STATUS: Use this tool ONLY when the user wants to check the real-time status of a specific existing flight (e.g., 'check status of TK289', 'is flight TK001 on time?', 'what's the gate for TK815?'). This tool requires a specific flight number. DO NOT use this for searching/bookable flights - use 'search_flights' instead. This tool fetches real-time flight status information including departure/arrival times, gate, terminal, and current flight status (on time, delayed, landed, etc.).
flight-status-by-route
ChatGPTCHECK FLIGHT STATUS BY ROUTE: Use this tool ONLY when the user wants to check the real-time status of flights on a specific route for a specific date (e.g., 'what flights are flying from IST to SFO today?', 'check flights from Istanbul to San Francisco tomorrow'). This tool shows the status of flights that are already scheduled/flying on that route. DO NOT use this for searching/bookable flights or finding available flights to book - use 'search_flights' instead. This tool fetches real-time flight status information for flights on a given route and date.
get_airline_promotions
ChatGPTFetch airline promotions. Inputs: country, airports. Use this when the user asks about promotions, special offers, or discounted flights.
get_booking_baggage_allowance
ChatGPTFetch detailed booking baggage information. Tip: Call get_booking_details tool to retrieve the ticket number if not provided. Use this when the user asks about baggage allowance, baggage limits, or extra baggage for their booking.
get_booking_details
ChatGPTRetrieve detailed information about a flight booking using PNR or E-ticket number. Returns passenger details, flight segments, and status. Use this when the user wants to check their reservation, find their ticket number, or see flight details for a specific booking.
get_city_guide
ChatGPTGet a travel guide for a destination city, including what to see, where to go, transportation information, weather, and more. Use this when the user asks about a destination city, wants travel tips, or needs information about a place they're visiting.
search_flights
ChatGPTSEARCH FOR BOOKABLE FLIGHTS: Searches Turkish Airlines flights and returns available options with prices. Provide from, to, departureDate, passengers, and tripType. For round trips, also provide returnDate. For multi-city, use originDestinations array instead of from/to/departureDate. IMPORTANT — next step depends on trip type: (1) INTERNATIONAL round trip: returns outbound only — after user selects, call 'search_inbound_flights' for return flights. (2) DOMESTIC round trip: returns both outbound and inbound — do NOT call 'search_inbound_flights'. (3) One-way: returns all needed information. DO NOT use this for checking flight status — use flight-status tools instead.
search_inbound_flights
ChatGPTSEARCH FOR RETURN FLIGHTS (international round trips only): Call after user selects an outbound from search_flights. Pass the selected outbound details (optionId, recommendationId, segments, fareFamily), the return leg in originDestinations, same passengers, and jSessionId + duTaxBean from the search_flights response. Returns inbound flight options with combined round-trip pricing.
find_flight_price_calendar
ClaudeFind the cheapest fares around a target departure date for a single travel leg. Ideal when the user is flexible with dates and wants to find the best price. For ROUND_TRIP flexibility, call this tool twice — once for the outbound (isReturnFlight=false) and once for the return (isReturnFlight=true). Use BEFORE search_flights when the user asks for 'cheapest', 'best price', or has flexible dates.
flight-status
ClaudeCHECK EXISTING FLIGHT STATUS: Use this tool ONLY when the user wants to check the real-time status of a specific existing flight (e.g., 'check status of TK289', 'is flight TK001 on time?', 'what's the gate for TK815?'). This tool requires a specific flight number. DO NOT use this for searching/bookable flights - use 'search_flights' instead. This tool fetches real-time flight status information including departure/arrival times, gate, terminal, and current flight status (on time, delayed, landed, etc.).
flight-status-by-route
ClaudeCHECK FLIGHT STATUS BY ROUTE: Use this tool ONLY when the user wants to check the real-time status of flights on a specific route for a specific date (e.g., 'what flights are flying from IST to SFO today?', 'check flights from Istanbul to San Francisco tomorrow'). This tool shows the status of flights that are already scheduled/flying on that route. DO NOT use this for searching/bookable flights or finding available flights to book - use 'search_flights' instead. This tool fetches real-time flight status information for flights on a given route and date.
generate_baggage_issue_link
ClaudeGenerate a direct link to the official Turkish Airlines baggage issue tracing form, localized to the user's language. Use when the user reports a baggage problem (lost, damaged, delayed) and wants to file a formal claim. Does NOT handle existing baggage case status (use a future case-status tool) or baggage allowance (use get_booking_baggage_allowance).
get_airline_promotions
ClaudeFetch airline promotions. Inputs: country, airports. Use this when the user asks about promotions, special offers, or discounted flights.
get_booking_baggage_allowance
ClaudeFetch detailed booking baggage information. Tip: Call get_booking_details tool to retrieve the ticket number if not provided. Use this when the user asks about baggage allowance, baggage limits, or extra baggage for their booking.
get_booking_details
ClaudeRetrieve detailed information about a flight booking using PNR or E-ticket number. Returns passenger details, flight segments, and status. Use this when the user wants to check their reservation, find their ticket number, or see flight details for a specific booking.
get_city_guide
ClaudeGet a travel guide for a destination city, including what to see, where to go, transportation information, weather, and more. Use this when the user asks about a destination city, wants travel tips, or needs information about a place they're visiting.
manage_booking_link
ClaudeValidate a booking by PNR + surname and return the deeplink for the user to manage the reservation OR start online check-in on turkishairlines.com. Use this whenever the user wants to cancel, refund, rebook, change, upgrade, add services, add/remove passengers, OR check in online. Set linkType='manage' for booking changes; 'checkin' for online check-in. Do NOT preemptively send users to the website or call center before trying this tool.
pnr_finder
ClaudeSecurely recover a forgotten PNR by triggering Turkish Airlines to send it via SMS or email to the contact on file. Use when the user has lost their booking reference and remembers the flight + passenger details. For security, the PNR is NEVER displayed in chat — it is only sent to the registered phone/email. After this succeeds, ask the user to check their inbox/SMS, then use get_booking_details once they have it.
search_flights
ClaudeSEARCH FOR BOOKABLE FLIGHTS: Searches Turkish Airlines flights and returns available options with prices. Provide from, to, departureDate, passengers, and tripType. For round trips, also provide returnDate. For multi-city, use originDestinations array instead of from/to/departureDate. IMPORTANT — next step depends on trip type: (1) INTERNATIONAL round trip: returns outbound only — after user selects, call 'search_inbound_flights' for return flights. (2) DOMESTIC round trip: returns both outbound and inbound — do NOT call 'search_inbound_flights'. (3) One-way: returns all needed information. DO NOT use this for checking flight status — use flight-status tools instead.
search_hotel_packages
ClaudeBrowse Turkish Airlines Holiday packages (Flight + Hotel, Tours, Circuits) from the catalog. Use when the user asks about holiday packages, all-inclusive trips, flight+hotel deals, or wants recommendations with constraints (destination, budget, star rating, trip type). Specify the locale matching the user's market (e.g. en-US, de-DE, fr-FR). Country and resort filters MUST be in the locale's language. Returns a curated list with prices, hotel ratings, and direct booking links.
search_inbound_flights
ClaudeSEARCH FOR RETURN FLIGHTS (international round trips only): Call after user selects an outbound from search_flights. Pass the selected outbound details (optionId, recommendationId, segments, fareFamily), the return leg in originDestinations, same passengers, and jSessionId + duTaxBean from the search_flights response. Returns inbound flight options with combined round-trip pricing.
