Use this when you need to find a tour operator's ID by their name for filtering tours. Searches tour operators by name and returns matching operators with their IDs. Use the returned operator ID with tour search filters.

Use this when you need to find city IDs for tour search filters like start city, end city, or cities to visit. Searches for cities by name within a specific country. Supports multiple name variants to handle different spellings (e.g., Krakow, Kraków, Cracow).

Use this when you need continent IDs for filtering tours by region. Returns a list of all supported continents with their IDs and names for use in tour search filters.

Use this when you need to look up country IDs for filtering tours or validating country names. Returns a complete list of all supported countries with their IDs, names, and ISO country codes.

Use this when you need to check supported currencies or get currency details like symbols. Returns a list of all supported currencies with their codes (USD, EUR), names, and symbols ($, €).

Use this when you need language IDs for filtering tours by guide language. Returns a list of all supported languages with their IDs, codes, and names for use in tour search filters.

Use this when the user wants information about a tour operator, such as their terms and policies. Fetches operator details including name, code, and terms & conditions based on operator ID.

Use this when the user asks about available departure dates, pricing for specific dates, or needs to validate if a departure date is available. Returns a list of departures for a specific tour within a date range, including availability status, pricing, and booking information.

Use this when the user wants to see detailed information about a specific tour. Fetches comprehensive tour details including itinerary, pricing, operator info, images, and booking links based on tour ID.

Use this when the user has questions about a tour that might be answered in the FAQ section. Returns a paginated list of frequently asked questions and answers about a specific tour, covering topics like inclusions, requirements, and policies.

Use this when the user wants to see tour routes on a map or compare itineraries visually. Fetches tour details for one or more tours and prepares map data with all itinerary locations, coordinates, and day-by-day information for visual display.

Use this when you need tour type IDs for filtering tours by category like adventure, cultural, or wildlife. Returns a hierarchical list of tour type groups and their individual types with IDs and names.

Use this when you need to know the current date, especially before setting departure date filters. Returns the current date and time in ISO format. Essential for calculating valid date ranges for tour searches.

Use this when the user describes what they want in natural language and you need AI-powered semantic search to understand their intent. Before use this tool, please READ all possible filters. PLESE USE FILTERS, when can be used, to make search faster and much more precise. Please use start_city, end_city, cities, countries, start_country, end_country filters if possible. You can use multiple of them. AI-powered semantic search for tours using natural language queries combined with optional filters. Uses Google Vertex AI to understand intent and find relevant tours based on descriptions, themes, or specific requests. Use `vertex-tour-search` when: - The user describes what they want in natural language - You need semantic/AI-powered search to understand intent - Combining natural language with filters for refined results Examples: - "Family-friendly safari with kids under 12" - "Romantic honeymoon trip with beach and mountains" - "Adventure tour with hiking and camping for beginners" - "Cultural immersion experience with local homestays" - "Wine tasting tour through European countryside" ## Input ### Required - `textSearch`: Natural language description of what the user is looking for - `display_mode`: How to display results — `"listing"` (default, carousel of tour cards) or `"map"` (interactive map view) ### Optional Filters #### Location Filters | Filter | Type | Description | | --------------- | -------- | -------------------------------------------------------------------------- | | `start_country` | string[] | Country where tour BEGINS (ISO 3166-1 alpha-2 codes). OR logic. | | `end_country` | string[] | Country where tour ENDS (ISO 3166-1 alpha-2 codes). OR logic. | | `start_city` | number[] | City IDs where tour starts. Use `b2b-cities-search` to find IDs. OR logic. | | `end_city` | number[] | City IDs where tour ends. Use `b2b-cities-search` to find IDs. OR logic. | | `countries` | object | Countries visited DURING the itinerary. Supports AND/OR operator. | | `cities` | object | Cities visited on the itinerary. Supports AND/OR operator. | #### Range Filters | Filter | Type | Description | | ---------------- | ------------------------ | ----------------------------- | | `duration` | `{ min, max }` | Tour length in days | | `max_group_size` | `{ min, max }` | Maximum group size range | | `min_group_size` | `{ min, max }` | Minimum group size range | | `price` | `{ min, max, currency }` | Price range (currency: "EUR") | #### AND/OR Filters These filters support both AND and OR operators: | Filter | Values | Description | | ------------ | ------------------------ | ---------------------------------- | | `departures` | YYYY-MM strings | Filter by departure months | | `countries` | ISO 3166-1 alpha-2 codes | Countries visited during itinerary | | `cities` | City IDs | Cities visited on itinerary | Structure: `{ values: [...], operator: "AND" | "OR" }` - `OR` (default): Tour matches ANY of the specified values - `AND`: Tour must match ALL specified values ## Examples ### Simple text search ```json { "textSearch": "family adventure with wildlife" } ``` ### With location filters ```json { "textSearch": "hiking adventure", "start_country": ["DE", "AT"], "countries": { "values": ["IT", "CH"], "operator": "AND" } } ``` ### With range filters ```json { "textSearch": "luxury beach vacation", "duration": { "min": 7, "max": 14 }, "price": { "min": 2000, "max": 5000, "currency": "EUR" }, "max_group_size": { "min": 1, "max": 16 } } ``` ### With departure dates ```json { "textSearch": "northern lights tour", "departures": { "values": ["2026-01", "2026-02", "2026-03"], "operator": "OR" } } ``` ### Map display mode ```json { "textSearch": "hiking tours in the Alps", "display_mode": "map", "countries": { "values": ["AT", "CH"], "operator": "OR" } } ``` ## Response Returns a list of tours matching the query, each containing: - Tour ID, name, and URL - Operator information - Brief description matching the query context

Search for tours by title using AI-powered semantic search. Returns a list of matching tour IDs and titles. Use this when you need to look up a tour by name. When you know tour id, use b2b-tour-details tool to display details about specific tour

PUBLIC WRITE Open world Use this when the user explicitly wants to book a tour and has provided their contact details. Creates a booking request for a specific tour. Requires real contact details (email, names; phone optional). Always confirm the departure date by checking departures first. Never fabricate or assume user data - always ask for missing information.

PUBLIC WRITE Open world Use this when the user requests a tour brochure or PDF to be sent to their email. Sends a tour brochure (PDF file) to the specified email address. Before using this, ensure the user has provided their email address. If not provided, ask the user for it. Never generate or assume email addresses.