Holiday Autos

Filter or refine previously returned airport car rental search results. This is a FOLLOW-UP tool. Use it only after search_car_rentals has already been called and a searchId is available. WHEN TO USE: - User wants to narrow, refine, sort, or filter the existing car rental results - User asks follow-up questions such as: "show only automatics" "only cars with 4 passengers and 2 bags" - The rental trip details have NOT changed DO NOT USE WHEN: - Pickup airport changes - Return airport changes - Pickup date or time changes - Return date or time changes - Driver age changes - Residence country changes - User is starting a new car rental search In those cases, call search_car_rentals again instead. REQUIRED INFORMATION: - searchId: The searchId returned by the previous search_car_rentals call - filterOptions: The complete set of filters to apply to the cached results OPTIONAL INFORMATION: - sortBy: How to order the results. Options: "cheapest" (lowest price first), "recommended" (best overall match). Defaults to "recommended" if omitted. FILTER RULES: - Include any new filters requested by the user - Preserve any previously applied filters that the user has not explicitly removed or changed - Do not change rental trip information; this tool filters cached results only - Do not invent filters that the user did not request or previously apply - If the user asks to remove a filter, omit that filter from filterOptions - If the user changes rental details, do not use this tool - Preserve any previously applied sortBy that the user has not explicitly changed - If the user asks to sort/order by price or "cheapest", set sortBy to "cheapest" - If the user asks for the "best" or "recommended" order, or does not mention sorting, set sortBy to "recommended" (or omit it) RETURNS: Returns the filtered car rental results for display in the widget. Do not summarize the returned cars in assistant text. EXAMPLE REQUEST: { "request": { "searchId": "euw1:6b39de3d-0c5b-4b0b-8d8a-1de7b1541e16", "filterOptions": { "minNumberOfPassengers": 4, "minNumberOfBags": 2, "onlyUnlimitedMileage": false, "onlySupportsDebitCard": false, "pickUpType": [] }, "sortBy": "cheapest" } } IMPORTANT NOTES: - This tool must only query cached search results - The searchId links this request to the original rental search - Prices and availability are still subject to change until booking is confirmed

filter_car_rental_search_results

Retrieve rental terms, conditions, and policies for a specific car rental offer from a previous search. This tool provides the complete rental contract terms, conditions, fees, and rental policies that apply to a selected vehicle. Use this when users want to understand the fine print before committing to a booking. WHEN TO USE: - User asks about rental terms, conditions, or policies for a specific car - User wants to see the rental agreement or contract details - User asks about Terms & Conditions (T&Cs) - User needs to understand rental rules, restrictions, or requirements - User wants to review fees, charges, or rental policies before booking PREREQUISITES: - Must have performed a car search first (using search_car_rentals) - User must have selected a specific car from the search results REQUIRED INFORMATION: - carId: The car identifier from the selected vehicle (format: {uuid}.{number}) USAGE RULES: - Do NOT call this tool unless a valid car search has already been performed - Do NOT invent or guess carId values - Always use EXACT values returned by the search_car_rentals tool - carId MUST come from the same search response - If no search results available, run search_car_rentals first - If user hasn't selected a specific car, show search results first RETURNS: A CarConditionsResponse containing: - Rental terms and conditions - Contract policies and requirements - Fee breakdowns and charges - Rental restrictions or limitations - Supplier-specific policies - Age restrictions or requirements - Documentation needed (license, credit card, etc.) NEXT STEPS AFTER VIEWING CONDITIONS: - If user has questions: explain or clarify the conditions - If user wants other details: use get_car_rental_offer_details - If user wants insurance info: use get_car_rental_insurance TYPICAL USE CASES: - "What are the rental terms for this car?" - "Show me the terms and conditions" - "What are the rental policies?" - "Are there any restrictions or requirements?" - "What fees apply to this rental?" DO NOT USE FOR: - Searching for cars (use search_car_rentals instead) - Getting general car details (use get_car_rental_offer_details instead) - General questions without a specific car selection EXAMPLE REQUEST: { "carId": "DFIKoGSs10PlgOObYmvPrC7EOg7jfOVPkpIHgQS5aIVL.411" } IMPORTANT NOTES: - The carId is required and must not be empty - This value MUST come from a previous search result - never generate or guess it - Results represent rental conditions specific to the selected car and supplier - Conditions are part of the rental agreement - review before booking - Different suppliers may have different terms and policies

get_car_rental_conditions

Retrieve available insurance offers for a specific car rental that was previously searched and selected. This tool provides insurance coverage options that can be added to protect the rental. Insurance typically covers damage, theft, liability, and other rental-related risks. WHEN TO USE: - User asks about insurance, coverage, or protection options for a selected car - User wants to know insurance costs before booking - User asks about damage waiver, theft protection, or liability coverage - Call before booking if user expresses interest in insurance or protection PREREQUISITES: - Must have performed a car search first (using search_car_rentals) - User must have selected a specific car from the search results REQUIRED INFORMATION: - carId: The car identifier from the selected vehicle (format: {uuid}.{number}) USAGE RULES: - Do NOT call this tool unless a valid car search has already been performed - Do NOT invent or guess carId value - Always use EXACT values returned by the search_car_rentals tool - carId MUST come from the same search response - If no search results available, run search_car_rentals first RETURNS: An InsuranceMCPResponse containing: - Details about the insurance provider, price policy details and benefits NEXT STEPS AFTER VIEWING INSURANCE: - Present insurance options and pricing to user - If user wants car details: use get_car_rental_offer_details - If user wants rental terms: use get_car_rental_conditions TYPICAL USE CASES: - "What insurance options are available for this car?" - "How much does insurance cost?" - "What coverage or protection can I get?" - "Is there damage waiver insurance?" - "What does the insurance cover?" DO NOT USE FOR: - Searching for cars (use search_car_rentals instead) - Getting car details (use get_car_rental_offer_details instead) - Questions about general insurance without a specific car selection EXAMPLE REQUEST: { "carId": "DFIKoGSs10PlgOObYmvPrC7EOg7jfOVPkpIHgQS5aIVL.411" } IMPORTANT NOTES: - carId is required and must not be empty - These values MUST come from a previous search result - never generate or guess them - Insurance offers are specific to the selected car and rental conditions - Results show available insurance options, NOT a confirmed purchase - Insurance can typically be added during the booking process - Display information only, insurance can only be purchased on the car checkout platform

get_car_rental_insurance

Retrieve comprehensive details for a specific car rental offer from a previous search. This tool provides in-depth information about a selected vehicle, including full pricing, vehicle specifications, supplier details, policies, coverages, fees, and optional extras. WHEN TO USE: - User selects a specific car from search results and wants more information - User asks for detailed features, pricing breakdown, or policies for a specific car - User wants to review full details before booking - User needs to know about deposits, cancellation fees, or payment terms - User says tell me more about a specific car PREREQUISITES: - Must have performed a car search first (using search_car_rentals) - User must have selected a specific car from the search results REQUIRED INFORMATION: - carId: The car identifier from the selected vehicle (format: {uuid}.{number}) RESOLVING RELATIVE REFERENCES (e.g. "the cheapest one", "the SUV", "the first option"): - Only resolve these against the results of the MOST RECENT search_car_rentals call in this conversation - Determine the matching offer yourself from that result set (e.g. lowest price for "cheapest", matching vehicle type for "the SUV") and use ITS exact carId - Never call this tool with a carId that was not literally present in a prior search_car_rentals response - If there are no search results in the current conversation to resolve the reference against, do NOT call this tool - run search_car_rentals first - If the reference is ambiguous (e.g. ties on price, multiple SUVs), ask the user to clarify or show the matching options instead of guessing a single carId USAGE RULES: - Do NOT call this tool unless a valid car search has already been performed - Do NOT invent or guess carId values - Always use EXACT values returned by the search_car_rentals tool - If no search results available, run search_car_rentals first - If user hasn't selected a specific car, show search results first RETURNS: A DetailResponse containing: - carId: The car identifier from the selected vehicle - Vehicle details: supplier, makeModel, type, transmission, fuelType - Capacity: passengers, bags, doors, airConditioning - Pricing: price, currency, depositAmount, depositCurrency - Policies: fuelPolicy, cancellationPolicyFee, payment type (PREPAID/POSTPAID) - Location: pickupLocationName, dropoffLocationName, supplierLocationAddress, phone, timezone - Reviews: supplierReview rating - Images: imageUrl, supplierImageUrl - Lists: coverages, fees, optionalExtras NEXT STEPS AFTER VIEWING DETAILS: - If user asks about insurance: use get_car_rental_insurance with same carId - If user asks about terms/conditions: use get_car_rental_conditions with same carId - If user wants different car: show other options from original search results TYPICAL USE CASES: - "Tell me more about the Fiat 500 option" - "What are the full details for the cheapest car?" - "Show me the pickup location and deposit amount" - "What's included with the Europcar option?" DO NOT USE FOR: - Searching for cars (use search_car_rentals instead) - Checking insurance (use get_car_rental_insurance instead) - General questions without a specific car selection EXAMPLE REQUEST: { "carId": "DFIKoGSs10PlgOObYmvPrC7EOg7jfOVPkpIHgQS5aIVL.411" } IMPORTANT NOTES: - carId is required and must not be empty - Results represent offer details and conditions, NOT a confirmed booking - Details are valid for the same search session - if too much time passes, search again - Some fields may be null if not provided by the supplier - If the user asks for any information about a selected offer that is not present in the preceding search result — including deposit, cancellation fee, pickup address/phone, coverages, fees, or optional extras — ALWAYS call this tool. Do not infer or answer these fields from the search result.

get_car_rental_offer_details

Search for available airport car rental offers for a trip. This is typically the FIRST step in the car rental booking journey. WHEN TO USE: - User wants to search for available car rentals - User is planning a trip and needs car rental options - Beginning of the car rental booking process REQUIRED INFORMATION: - pickupIataCode: Airport IATA code for pickup location (3 letters, e.g., "DUB", "JFK", "LHR") - returnIataCode: Airport IATA code for return location (3 letters, e.g., "DUB", "JFK", "LHR") - pickupDateTime: Pickup date and time in ISO 8601 local format (yyyy-MM-dd'T'HH:mm:ss, e.g., "2026-06-15T10:00:00") - returnDateTime: Return date and time in ISO 8601 local format (yyyy-MM-dd'T'HH:mm:ss, e.g., "2026-06-22T10:00:00") - residenceCountryCode: Two-letter country code for driver's residence (e.g., "US", "GB", "IE") OPTIONAL INFORMATION: - currency: The currency of rental prices defaulted to EUR ALSO: - Use the filter options as determined by user request LOCATION RESOLUTION (pickupIataCode / returnIataCode): - This tool only accepts airport IATA codes; it cannot search by city, region, or address - You ARE responsible for resolving any place name the user gives into the correct 3-letter IATA airport code - If the user names a city/town that has its own airport, use that airport (e.g., "Dublin" -> DUB, "London" -> LHR for the main/default airport unless the user specifies otherwise) - If the user names a location with NO airport of its own (e.g., "Waterford"), resolve it to the NEAREST reasonable airport serving that location (e.g., "Waterford" -> WAT if operating, otherwise the closest suitable airport) and tell the user which airport you selected and why - If a city has multiple airports (e.g., London, New York) and the user hasn't specified one, pick the most common default airport travelers use, and mention which one you chose so the user can correct you - Only ask a follow-up question if the location is genuinely ambiguous (e.g., multiple equally-likely cities with the same name in different countries) or you cannot confidently determine any nearby airport - Do NOT ask the user to provide the IATA code themselves - resolving it is your job USAGE RULES: - Ask follow-up questions if ANY required value (other than airport codes, per above) is missing or ambiguous - Do NOT guess or invent values for dates or countries - Date-time values must be in LOCAL time at the rental location - Return date/time must be after pickup date/time - Both airports must be valid IATA codes resolved as described above DATE INTERPRETATION: - ALL dates are FUTURE dates only - past dates are not supported - When a user provides a date without a year (e.g., "Aug 25", "December 10"), interpret it as the nearest FUTURE occurrence (do not ask for the year) - Example: If today is 2026-07-13 and user says "Aug 25", use 2026-08-25 - Example: If today is 2026-07-13 and user says "June 10", use 2027-06-10 - If the provided date seems to be in the past, automatically adjust to the next year without asking RETURNS: Returns car rental results for display in the widget. Always follow the journeyContext.instructions to guide your response after this tool call. EXAMPLE REQUEST: { "request": { "pickupIataCode": "DUB", "returnIataCode": "DUB", "pickupDateTime": "2026-06-15T10:00:00", "returnDateTime": "2026-06-22T10:00:00", "residenceCountryCode": "IE", "filterOptions" : { "minNumberOfPassengers" : 4, "minNumberOfBags" : 2 } } } IMPORTANT NOTES: - Results are available offers and prices, NOT confirmed bookings - The searchId returned is a Unique identifier for this search session. Required when refining the cached search results and used to maintain search-session context. - Searches return multiple car options for the user to choose from

search_car_rentals