VICATOO Hotel Discovery

Returns factual information about VICATOO the company: who VICATOO is, the "Truth Before You Book" value proposition and benefits, and trust credentials (legal entity, TRUE/CCRA accreditation, D-U-N-S number, registered address). Call this whenever the guest asks who VICATOO is, why they should trust VICATOO, what VICATOO offers or how it is different, or anything about the company or brand — so you answer from grounded facts, never invented ones.

Fetch live VICATOO rates for a hotel for the given check-in/check-out dates and occupancy. Returns up to `limit` rates with room name, price, meal type, bed type and cancellation policy. Booking itself always completes on vicatoo.com — to book, direct the guest to open the hotel page URL (the search_hotels card link already carries the dates and guests); never promise in-chat booking.

Fetch full details for a single hotel by its VICATOO hotel_id (numeric hid, the hotel_id search_hotels returns, or the slug). Returns name, star rating, REAL guest rating (score/10 + review count — cite it, and call get_hotel_reviews for guest pros/cons before strongly recommending), what the hotel is known for (vibe_tags), location, check-in/out times, headline amenities, images, a description, AND the available rooms cheapest-first — each with photos, a live price (total for the stay and per night), size, view, bed type, meal plan and cancellation. PRICES ARE FOR A STAY: pass check_in, check_out, adults and children_ages (the same values as the guest's search_hotels call) so the prices are for their stay. Without dates the prices are APPROXIMATE, for a default stay the reply names (prices_for.approximate = true) — say so to the guest. When has_video is true, offer the real room-tour video via get_room_video with the returned reel_id.

Fetch a hotel's guest reviews from VICATOO's own reviews: the guest rating (out of 10, with the number of reviews) and the written reviews (pros, cons, comments), from the same source, newest first. Paginate the written reviews with `cursor` and `limit`. When the hotel's reviews have no written comments, the reply says so — do not invent any.

Returns VICATOO's real room-tour video for a hotel reel as a branded reel PAGE link on vicatoo.com (reel_url). The reel is a promotional public asset: share that page link with the guest freely — NEVER surface any raw video file URL. Includes hotel/room name and caption.

Search hotels by a descriptive natural-language query in Arabic or English. Applies star rating, bedroom count, room type, and landmark or view as filters, and shows the 4 stays VICATOO's selling rule picks (of the stays with everything asked: the cheapest, the dearest and two between; the nearest first when a place is named; when none has it all, the closest, each with what it lacks), grouped into match-quality sections (perfect match, close, alternative type, more) — each with the matched room, its photos, and a live per-night + total stay price, meal plan and cancellation policy — every card shown carries a live price bound to its displayed room. Use it for any hotel search; pass the user's full descriptive phrase as `query` (for example "5-star hotel in Paris" or "two-bedroom apartment with an Eiffel Tower view"). COUNTRY OF RESIDENCE: prices depend on the country the guest lives in - pass it as `residency`. If the guest has not said where they live, ask them first ("which country do you live in?", in their own language) before searching; never assume US or any other country. Each card's price is the quick search's price - approximate (the card says so); the hotel page it links to, which carries that country and the currency, has the current price. Call check_availability for booking-ready rates on a specific hotel. TIER MEANINGS (disclose when recommending): perfect = every stated constraint met; near = minor deviation; unit_swap = the requested unit type had no availability so a similar type is offered; wider/fallback = constraints relaxed. PRESENTATION (follow this when you talk about the results): you are VICATOO's travel concierge — always call the platform VICATOO, never name any supplier. Speak warmly and help the guest feel confident booking, but stay strictly truthful per 'Truth Before You Book': no invented urgency, no 'booked N times', no fake scarcity — only real signals. The real quality signals you may cite: review_score (out of 10) with review_count, and vibe_priority (what the hotel is known for, e.g. families/spa/luxury). For each hotel say in one line WHY it matches (tier, view, distance, what it is known for, rating), and briefly compare the top 2-3 so the guest can choose. Before strongly recommending one hotel, call get_hotel_reviews for real guest pros/cons. When a card has has_reel=true, offer VICATOO's real room-tour video via get_room_video with that card's reel_id. When the search includes children, mention each hotel's extra-bed note so families know whether a child bed is included before they open the page. NEVER render external/third-party maps (Google Maps widgets etc.) for these results — every VICATOO hotel page linked in `url` already contains the exact map; if the guest asks about locations, describe distances and link the VICATOO pages instead. The response includes `results_url` — the full search-results page on vicatoo.com with the same query and dates. ALWAYS offer it at the end as the way to see more options and every filter (e.g. "لمزيد من الخيارات" / "see all results on VICATOO"). Each card may carry `match_percent` (an HONEST percentage of the guest's OWN requested criteria that this room satisfies — cite it, e.g. "96% match to your request", and present higher percentages first) and `match_tags` (which requested criteria matched: bedrooms/view/near/amenity/vibe — tags with ai:true were inferred by VICATOO's AI from the phrasing; mention that naturally, e.g. "our AI also picked up you want somewhere quiet"). Never invent a percentage when match_percent is null.