VICATOO Hotel Discovery

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 returns results 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"). 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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "The full descriptive search phrase from the user (city + any room type, view, budget, star rating, bedroom count, or vibe cues). Pass exactly what the user typed — e.g. \"5-star hotel in Paris\" or \"شقة غرفتين إطلالة على برج إيفل\". The backend parses Arabic/English intent and applies stars / bedrooms / landmark as real constraints — do NOT pre-strip the phrase down to a city."
    },
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "adults": {
      "default": 2,
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "children_ages": {
      "default": [],
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 17
      }
    },
    "rooms": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "residency": {
      "default": "us",
      "description": "ISO 3166-1 alpha-2 of guest residency.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "limit": {
      "default": 10,
      "description": "Maximum hotels to return across all sections.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "description": "The user's language as an ISO 639-1 code (e.g. 'ar', 'ru', 'de', 'fr', 'en') for localizing the result cards. Infer it from the conversation language. If omitted, it is detected from the query script.",
      "type": "string"
    }
  },
  "required": [
    "query",
    "check_in",
    "check_out"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch full details for a single hotel by its VICATOO hotel_id (numeric hid or 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, live from-price, size, view, bed type, meal plan and cancellation. When has_video is true, offer the real room-tour video via get_room_video with the returned reel_id.

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        }
      ],
      "description": "VICATOO hotel id — either the numeric hid (e.g., 7476954) or the slug (e.g., \"bentley-hotel-bosphorus-7476954\")."
    },
    "lang": {
      "default": "en",
      "description": "2-letter language code for content (en, ar, de, fr, es, ru, etc.).",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "currency": {
      "default": "USD",
      "description": "3-letter ISO currency for room prices. Defaults to USD so hotel details match the search-result prices; pass the same currency the guest saw in search.",
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "view": {
      "description": "Optional preferred view family (e.g. \"bosphorus\", \"sea\", \"garden\", \"city\", \"pool\"). When the guest arrived from a view-constrained search, pass it so rooms with that view are floated to the top instead of the default cheapest-first ordering.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        }
      ],
      "description": "VICATOO hotel id — numeric hid or slug (same as get_hotel_details)."
    },
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "adults": {
      "default": 2,
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "children_ages": {
      "default": [],
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 17
      }
    },
    "rooms": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "residency": {
      "default": "us",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "room_type_filter": {
      "description": "Optional case-insensitive substring filter on room_name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "currency": {
      "default": "USD",
      "description": "3-letter ISO currency for the rate prices. Defaults to USD so rates match the search-result prices; pass the same currency the guest saw in search.",
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "view": {
      "description": "Optional preferred view family (e.g. \"bosphorus\", \"sea\", \"garden\", \"city\", \"pool\"). When the guest cares about a specific view, pass it so matching-view rates are floated to the top instead of the default cheapest-first ordering.",
      "type": "string",
      "maxLength": 20
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "hotel_id",
    "check_in",
    "check_out"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch guest reviews for a hotel from the VICATOO content API. Supports pagination via `cursor` (page offset) and `limit`. Returns aggregate count and per-review summary (author, rating, pros/cons, stay context).

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        }
      ],
      "description": "VICATOO hotel id — numeric hid OR slug etg_id (the same id search_hotels and get_hotel_details return); slugs are resolved server-side."
    },
    "lang": {
      "default": "en",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "cursor": {
      "default": 0,
      "description": "Page offset (0-based).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 12,
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

{
  "type": "object",
  "properties": {
    "reel_id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d{1,9}$"
        }
      ],
      "description": "Reel primary-key id (numeric)."
    }
  },
  "required": [
    "reel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}