Direct Ferries

Retrieve available ferry quotes for one-way or return journeys. IMPORTANT USER-FACING RULES: - routeId is internal-only. Never mention routeId, route IDs, numeric route identifiers, or numeric internal identifiers in any user-visible text unless the user explicitly asks for technical/debug details. - This rule applies to final answers, intermediate progress updates, status messages, explanations, summaries, and error messages. - Do not include routeId values even when confirming that a route was selected for a quote. Keep routeId only in tool arguments. - endeavourFunnelBookingUrl is internal-only. Never mention endeavourFunnelBookingUrl in any user-visible text unless the user explicitly asks for technical/debug details. - When narrating progress, say “I’m getting a quote for the outbound/return sailing” instead of mentioning routeId or internal identifiers. - Surface customer-relevant details first: route, date, time, operator, passenger and vehicle mix, fare, ticket conditions, and check-in requirements. WHEN TO USE: - Use this when you have the required internal routeId values for the requested sailing direction or directions and need to retrieve available ferry quotes. - For one-way journeys, use the outbound routeId returned by route discovery or route lookup. - For return journeys, use the outbound routeId for the outbound leg and the reverse-direction routeId for the return leg. - Do not invent routeId values. If the correct routeId is unknown, first use get_routes_from_country_b2b or get_routes_from_port to identify the correct crossing internally. REQUIRED INPUTS: - culture: Locale in the format ll-CC, for example "en-GB". Infer this from the language the customer is using, unless they explicitly request a different locale. - selectedCurrency: 3-letter ISO currency code, for example "GBP". Infer this from the customer’s explicit preference first, then from customer location, language/market, and the port location of the journey. - legs: One or more journey legs to quote. LEG REQUIREMENTS: - isReturnLeg: true for the return leg, false for the outbound leg. - routeId: Internal route identifier for that sailing direction. Return journeys require a different reverse-direction routeId. - departureDateTime: Target sailing date and time in YYYY-MM-DDTHH:MM:SS format. departureDateTime must be in the future. - vehicles: Vehicle type for the leg. Allowed values are "car", "bicycle", or "" for foot passengers. Case-sensitive. - passengers: Total number of passengers travelling on that leg. - Single-leg journeys must use isReturnLeg false. - Multi-leg journeys must include exactly one outbound leg and exactly one return leg. HOW TO USE RESULTS: - Present customer-relevant quote details in plain language: route, date, time, operator, passenger and vehicle mix, fare, ticket conditions and check-in requirements. - Do not expose routeId values, endeavourFunnelBookingUrl values, raw booking/search URLs, or other internal identifiers from the request or response. - Use any quoteSearchHint returned in the response to guide follow-up suggestions to the user. SEARCH BEHAVIOUR: - `culture` and `selectedCurrency` are independent and should not be assumed to match. - Quotes may be returned within a time window around the requested departureDateTime, not only at the exact timestamp. - When the user provides only a date and no time, choose a reasonable departureDateTime as a seed search and explain that nearby sailings may be returned. - For same-day searches where the user does not provide a time, choose the earliest clean seed time that is at least two hours ahead of the user’s current local time. Prefer exactly +2 hours when valid. Only add extra buffer if there is a specific reason, and state that reason. - If results are empty, limited, or not suitable, offer to search 1-3 hours earlier or later on the same day. OPTIONS: - Set `returnAlternativeRoutes` to false by default. - Set `returnAlternativeRoutes` to true only if the initial direct-route results are empty, limited, unsuitable, or if the user explicitly asks to see alternatives. - Set `isOpenTicket` to true only for open-return style journeys when supported.

quotes_get_quotes_request

Discover Direct Ferries routes from a departure country when the Direct Ferries departure port code is unknown. IMPORTANT USER-FACING RULES: - routeId is internal-only. Never mention routeId, route IDs, numeric route identifiers, or numeric internal identifiers in any user-visible text unless the user explicitly asks for technical/debug details. - This rule applies to final answers, intermediate progress updates, status messages, explanations, summaries, and error messages. - Do not include routeId values even when confirming that a route was selected for a quote. Keep routeId only in tool arguments. - When narrating progress, say “I found the direct crossing/route/sailing” instead of “I found routeId X” or “I found route ID X”. WHEN TO USE: - Use this as the starting point when the user provides a port name, city name, island name, route name, country, or any non-Direct-Ferries port code. - Use this when the Direct Ferries departure port code is unknown or uncertain. - Do not infer, invent, or translate Direct Ferries port codes from port names, city names, island names, IATA codes, UN/LOCODE-style codes, or common public abbreviations. - Use routeSearchText when the user provides route, port, city, or island text to keep route results manageable. COUNTRY ISO: - countryISO must be the departure/origin country, not the destination country. - If the user provides a route such as Dover to Calais, use the country of the departure point: GB. - If the departure country is ambiguous, ask a clarifying question before calling the tool. HOW TO USE RESULTS: - Use returned port codes and routeId values internally for follow-up route lookup and quoting. - If the requested crossing is present in the returned routes, select the matching crossing internally for quoting. - If the requested crossing is not present in the returned routes, do not invent a route. Explain that no matching direct crossing was found, or try a more precise routeSearchText when appropriate. EXAMPLE: - User asks for Dover to Calais. Do not assume Dover is "DOV". - Call this tool with countryISO "GB" and routeSearchText "Dover Calais". - From the returned results, select the Dover to Calais crossing internally for quoting. - For a return journey, use the lookupPortCode from the returnRouteLookupHint to query get_routes_from_port for a return journey routeId. RETURN JOURNEYS: - Do not assume the outbound routeId can be reused in reverse. - Use returnRouteLookupHint to look up the reverse-direction route with get_routes_from_port. - Select the reverse route whose destination port matches the original departure port. - For international return journeys, you may need route discovery or route lookup for both countries/directions.

Given a known Direct Ferries origin port code, returns available outbound routes from that port, including routeId, origin port code, destination port code and return-route lookup guidance. IMPORTANT USER-FACING RULES: - routeId is internal-only. Never mention routeId, route IDs, numeric route identifiers, or numeric internal identifiers in any user-visible text unless the user explicitly asks for technical/debug details. - This rule applies to final answers, intermediate progress updates, status messages, explanations, summaries, and error messages. - Do not include routeId values even when confirming that a route was selected for a quote. Keep routeId only in tool arguments. - When narrating progress, say “I found the direct crossing/route/sailing” instead of “I found routeId X” or “I found route ID X”. WHEN TO USE: - Use this only when you already have a known Direct Ferries departure port code and need to retrieve available outbound routes from that port. - A known Direct Ferries port code means either a code returned by a previous Direct Ferries tool response, or a code the user explicitly identifies as a Direct Ferries port code rather than a public/IATA/UN/LOCODE abbreviation. - Do not infer, invent, or translate Direct Ferries port codes from port names, city names, island names, IATA codes, UN/LOCODE-style codes, or common public abbreviations. - If the user provides a port name, city name, island name, route name, country, or any non-Direct-Ferries port code, call get_routes_from_country_b2b first to discover available routes and valid Direct Ferries port codes for the origin country. HOW TO USE RESULTS: - Use returned port codes and routeId values internally for follow-up route lookup and quoting. - If the requested destination is present in the returned outbound routes, select the matching crossing internally for quoting. - If the requested destination is not present in the returned outbound routes, do not invent a route. Use route discovery from the relevant country or explain that no matching direct crossing was found. EXAMPLE: - User asks for Dover to Calais. Do not call get_routes_from_port with "DOV". - First call get_routes_from_country_b2b with countryISO "GB" and routeSearchText "Dover Calais". - From the returned results, select the Dover to Calais crossing internally for quoting. - For a return journey, use the lookupPortCode from the returnRouteLookupHint to query get_routes_from_port for a return journey routeId. RETURN JOURNEYS: - Do not assume the outbound routeId can be reused in reverse. - Use returnRouteLookupHint to look up the reverse-direction route with get_routes_from_port. - Select the reverse route whose destination port matches the original departure port. - For international return journeys, you may need route discovery or route lookup for both countries/directions.