Autumn

Total food & beverage revenue (gross of tax) for a date range, with optional outlet-level breakdown (restaurant, bar, minibar, breakfast). Includes optional year-over-year comparison. Rows not tied to a reservation (walk-in / POS sales) are included in the total. **Mews-only** — every other PMS returns `unsupportedForPms: true`; surface the capabilityNote instead of $0.

get_fnb_revenue

Get floor and ceiling price guardrails per date and room type for the requested range, plus any active price overrides and the seasons currently in effect.

get_floor_ceiling_prices

Get future occupancy by date. Highlights undersold dates that may need pricing or marketing attention. Defaults to today + 60 days if no range is given. Set include_room_types to also return a per-room-type breakdown.

get_forward_availability

Get Google Analytics (GA4) session traffic broken down by source and medium. Complements get_google_ads_performance by covering organic, direct, referral, and other non-paid channels. Returns aggregate totals plus a daily breakdown. Returns a graceful message when GA4 is not connected.

get_ga4_traffic_sources

Get Google Ads marketing metrics: impressions, clicks, CTR, conversion funnel (add-to-cart, begin-checkout, purchase), campaign breakdown, device split, and abandoned cart recovery. Returns a graceful message when Google Ads is not connected. May take up to 25 seconds to return because it fans out multiple Google Ads API calls in parallel.

get_google_ads_performance

Get a single guest's full booking history and stay aggregates. Match by name (case-insensitive substring match against first name, last name, or the full "first last" string). If the name matches multiple guests, returns a candidates list alongside the top match by stay count. Caps booking history at 50 rows (default 25, newest first). For hotels on Mews the guest identity fields may be empty because Mews does not sync guest names/contact info.

get_guest_detail

Get guest analytics: top repeat guests (with first-stay and last-stay dates), average length of stay, revenue per guest, and nationality distribution. Defaults to the trailing 12 months. Limit defaults to 25 and caps at 50. Use sort_by to rank by stays (default), revenue, or recency. Set lifetime=true to aggregate all synced history instead of a date range.

get_guest_insights

Fetch the list of staff notes attached to a guest profile (allergies, preferences, past incidents, etc.). Returns each note's id, timestamp, text, and author when available. Cloudbeds-only — other PMS types return unsupportedForPms. Pass the guest's PMS id (resolve it first via get_guest_detail or get_reservation_detail when the user asks by name).

get_guest_notes

Get a single guest's booking-behavior patterns: seasonality (stays by month), day-of-week preference, stay-length distribution (min/median/max/modal), booking lead time (avg + median + distribution), channel loyalty, and preferred room types. Match by name (fuzzy, first + last). Available for Cloudbeds and Mews; ResNexus does not sync guest identity so results will be empty for ResNexus hotels.

get_guest_patterns

Top-spending guests for a date range, broken out by rooms revenue, F&B spend, and retail spend. Guests are matched via reservations whose check-in falls in the range; F&B and retail rows are joined via reservationPmsId. Returns an additional walkInTotal object for F&B/retail sales not attributable to any guest (walk-ins, POS).

get_guest_spend_breakdown

Per-keyword Google Ads conversions for a date range. Groups keywords by campaign category (Brand Protection, Discovery & Competitors, Google Hotels & Maps, Other). Returns the top 10 keywords per category ranked by purchases (tie-breaking on purchase value), each with impressions, clicks, CTR, add-to-cart, begin-checkout, purchases, purchase value, and CVR. Use to answer 'which keywords drove bookings?'. Returns a graceful message when Google Ads is not connected.

get_keyword_performance

Get events near the hotel that overlap a date range — conferences, concerts, sports, festivals, public holidays. Each event includes attendance estimates, rank, and labels. Defaults to today + 90 days when dates are omitted.

get_local_events

Get active minimum-length-of-stay (MLOS) restrictions for a date range, plus the current MLOS config (enabled flag, occupancy/pace thresholds, cascade strategy). Use when the user asks 'do I have a 2-night minimum?', 'is MLOS on?', or 'what are my current minimum stays?'. Returns an empty restrictions array when MLOS is off. Defaults to today + 90 days.

get_mlos_restrictions

Compare performance across multiple prior years (default: 2 years back, max 5). Use when the user asks 'how does X compare to prior years' (plural) or wants multi-year trend context. For single-year YoY, prefer get_performance_summary with include_yoy=true — it's cheaper.

get_multi_year_performance

Get hotel performance metrics (occupancy %, ADR, RevPAR, revenue) for a date range. When include_yoy is true, returns a year-over-year comparison matched by day-of-week.

get_performance_summary

Get performance metrics broken down by room type. Shows which room types generate the most revenue and which have the highest or lowest occupancy for the given date range.

get_performance_by_room_type

Get the audit trail of all pushed prices for a date range. Each entry includes the trigger, suggested base price, applied floor/ceiling, whether the floor or ceiling was hit, and competitor rates at the time of push. Answers 'why was my price set to $X on date Y'.

get_pricing_history

Property's configured product catalog (SKUs) live from the PMS — returns id, name, SKU, category, and price per item. Use this for 'what's in my Gift Shop?' / catalog-listing questions. Cloudbeds only today; returns an empty list for PMS types without a catalog endpoint.

get_product_catalog

Get the hotel property information: name, address, timezone, currency, contact info, and PMS connection status (type, last sync time). PMS credentials are never included.

get_property_details

List configured rate plans with PMS identifier, name, service ID, and a flag identifying Autumn's base rate — the rate used as the foundation for all pricing decisions.

get_rate_plans

Get complete detail for a single reservation by code or PMS id: dates, status, source/channel, guest identity + contact info, room + rate plan, nightly price breakdown, cancellation reason, and group id if part of a group booking. Works for Cloudbeds, Mews, and ResNexus.

get_reservation_detail

Total retail / gift-shop revenue (gross of tax) for a date range. Optional year-over-year comparison. Walk-in / POS sales included in the total. **Mews-only**; every other PMS returns `unsupportedForPms: true`.

get_retail_revenue

Get guest review analytics: average rating, sentiment distribution (positive/neutral/negative), top themes across reviews, response rate, and per-channel breakdown when no channel filter is applied. Filter by period (30d, 90d, 6m, 12m, all) and optionally by channel (google, booking, expedia). Defaults to the last 90 days.

get_review_summary

List all active room types with capacity, extra capacity, physical room count, and base-room identification. The base room type is derived from the pricing configuration (user metadata), not from a column on the room type itself.

get_room_types

Search reservations in a date range. Use 'search' to find bookings by guest name (matches first name, last name, or full name). Excludes cancelled reservations by default unless 'status' is set explicitly. Results are paginated: default limit 100, max 500. Use this tool for questions about: • Week/month arrivals or departures — pass the full date range. • Cancellation analysis — pass status='Cancelled' and aggregate by guestName client-side to find top cancellers or lost revenue. • Group bookings — when multiple returned rows share the same guestName + checkinDate, treat them as ONE group booking; sum netPrice across the cluster and report the total group value, not the per-row value.

get_reservations

Get all seasonal pricing rules categorized as active, upcoming, or expired (relative to today in the hotel timezone). Includes weekday/weekend floor and ceiling at the hotel level plus per-room-type overrides.

get_seasonal_settings

Top-selling products in F&B or retail by gross revenue (default) for a date range. Returns product name, total quantity sold, and gross revenue per product. **Mews-only**; returns [] for every other PMS (no product-level sales data available).

get_top_selling_products

List a named guest's upcoming (future) reservations ordered by check-in date ascending. Each row includes room type, rate plan, channel, nightly price, and days until arrival. Merges duplicate guest records that share email/phone so the full upcoming schedule is visible even when the PMS has split the guest across multiple profiles. Works for Cloudbeds and Mews.

get_upcoming_reservations