Besty AI

Use this when a traveler has flexible dates and wants to know when a specific property is available, e.g. "when is it free in October". Returns cached contiguous bookable date windows (no price total). Cheaper and faster than scanning the rate calendar. Always follow up with get_stay_quote for the exact bookable total once dates are chosen. Not for searching across properties; use search_stays for that.

find_open_windows

Direct HTTPS checkout link on the property manager's own website with property, dates, and guests pre-filled. Booking and payment complete on the manager's site (they are the merchant), not in this conversation. If the property uses request-to-book, the link starts an inquiry rather than an instant booking; this is stated in the response.

get_booking_link

Use this when a traveler asks about guest experiences, ratings, or trustworthiness of a specific property. Returns the guest reviews the property manager publishes on the listing page, across booking channels: displayable review text, ratings, dates, and reviewer first names, with cursor pagination, plus a summary average and count. Some properties have a rating summary but no published review text yet; when reviews is empty, present the summary and say written reviews are not yet published. Not for reviews of the manager's company or for properties outside this catalog.

get_reviews

LIVE quote for specific dates and party size: total with full line items (nightly, cleaning, fees, taxes, discounts), quoted directly from the property's management system at call time. Includes `booking_url`, a checkout link with dates and guests pre-filled on the manager's own website, and `quote_as_of`. Prices can change until checkout; checkout holds the dates ~15 minutes. Rate-limited more tightly than other tools; don't sweep many date combinations; use `get_rate_calendar` to narrow first.

get_stay_quote

Full detail for one vacation rental by its stable numeric listing_id (or a listing URL; the id is parsed off the URL tail, slugs can change). Returns description, photos (first 12, photos_total has the full count), amenities, capacity, location, policies, house-rule FAQs, review summary, manager brand, canonical URLs, and booking mode. Returns data only; call show_property to display the interactive card.

get_property

Per-day nightly rate, minimum stay, and open/booked status for up to 365 days ahead, from a cache refreshed several times daily; `refreshed_at` states exactly when. Use this to find open windows and estimate cost; always confirm an exact bookable total with `get_stay_quote` before presenting a final price.

get_rate_calendar

Find professionally managed vacation rental homes to book. Map the request onto structured parameters: place names go to city/state (regions such as Poconos, Catskills, Outer Banks, or Smokies work as city), amenity words go to amenities, counts go to adults/children/min_bedrooms, budgets go to the price caps, and free_text is for flavor only (it re-ranks, never excludes). Do not use this tool for hotels, long-term rentals, flights, or listing a property; results are compact summaries keyed by the stable numeric listing_id (get_property has full detail, show_stays renders cards), and any caveats that apply come back in notes.

search_stays

Render tool: shows the interactive detail card (photos, calendar, quote, reserve) for one vacation rental. Call it once when the traveler wants to see or book a specific property, after get_property or a search_stays result gave you its listing_id. Returns the same fields as get_property. Do not call it again for the same listing in one conversation; the card updates itself.

show_property

Render tool: shows a visual card list for vacation rentals already found with search_stays. Call it once, after search_stays returns the final set to present, with the listing_id values in display order. Pass the same check_in, check_out, and party counts as the search so cards show the same dated totals. Not a search; unknown or unavailable listing_id values are dropped. Call it at most once per set of results; do not call it again for a retry of the same search.

show_stays