Hospitable

Delete an owner statement expense or reimbursement transaction by UUID. Fails if the covering owner statement is already published. Requires the Mogul / Owner Statements entitlement.

delete-owner-statement-transaction

Delete a task by UUID. This soft-deletes the task, marks it as manually deleted, and prevents future recurring-task regeneration from recreating it.

delete-task

Get a paginated list of smart notification alerts for the account. Alerts are operational issues that need attention, such as failed payments, disconnected booking channels, guest issues, security deposits not collected, or low smart-lock battery. Filter by `priority`, `grouping_key`, or `status` to narrow results. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-alerts

Get a single Owner Statements business by UUID, including name and type. Requires the Mogul / Owner Statements entitlement. Use the returned id as business_id on business-level owner statement transactions.

get-business

Get a paginated list of Owner Statements businesses for the account. Requires the Mogul / Owner Statements entitlement. Use this to discover business UUIDs before creating business-level owner statement transactions. Filter by business type when needed. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-businesses

Get a curated changelog of Hospitable MCP server capability changes since late March 2026. Use this when an agent needs to understand which tools, schema contracts, or MCP behaviours recently changed. If a tool is recently added to the changelog, but the AI client does not see the tool available in the tool list, try to refetch the tool list or ask the user to refresh the MCP server connection in the AI agent settings.

get-changelog

List the user's connected channels. Use to discover valid `platform` keys and `user_id` values for scoping/filtering other tools. Use this over guessing platform keys or host identifiers. `homeaway` is `Vrbo`

get-channels

Get the authenticated community user profile for the current token. This is a lightweight identity lookup with no optional includes.

get-community-user

List Hospitable custom codes — reusable, user-defined text snippets inserted into messaging rules, review rules, notification rules, and canned responses via `%%name%%` placeholders. Unlike system-defined short codes, custom codes are scoped to specific platforms, hosts, or properties, and can carry optional conditions (e.g. availability, booking lead time, pet on reservation) that are evaluated when the message is prepared (instant rules) or at scheduled send time (scheduled rules). Each item's `_meta.warnings` field may surface `invalid_short_codes` and `invalid_custom_codes` — placeholders found inside the code's `text` that do not resolve to a known short code or to one of this user's custom codes, and so will be left unresolved when the message is sent. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-custom-codes

List the host's reviews of guests across completed reservations. Filter with `status` to focus on what you need: `pending` for reviews still inside the platform's submission window (use this before `submit-guest-review`), `sent` for the host's previously published reviews, `cancelled` for reviews that have been withdrawn, or omit `status` to get everything. Pending reviews currently surface Airbnb only; sent and cancelled reviews cover Airbnb and VRBO. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-guest-reviews

Get a paginated list of inquiries for specific properties, with optional message recency filtering. Use includes sparingly because property and listing expansions can add substantial nested context. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-inquiries

Get a single inquiry by UUID. Use includes sparingly because message history and expanded property or listing resources can significantly increase the payload.

get-inquiry

Get a single messaging rule template by UUID. Returns per-language message templates.

get-messaging-rule

Get a paginated list of messaging rule templates for the account. Returns messaging rules (automatic replies to reservation events), canned responses (drafts) and review rules (templates for automatic replies to guest reviews). Pass `include=templates` to add per-language message templates or get an individual rule by UUID to get the templates. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-messaging-rules

Get a paginated list of smart notification opportunities for the account. Opportunities are actionable suggestions to improve listing performance or revenue, such as enabling security deposits, connecting dynamic pricing, earning more bookings from Airbnb or Vrbo, or offering early check-in and late checkout upsells. Filter by `priority`, `grouping_key`, or `status` to narrow results. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-opportunities

Get a single owner statement by UUID, including money totals such as total_reservation_income, taxes_to_manager, taxes_to_owner, and total_due_to_owner. Pass include when you need property, owner, reservations, adjustments, or transactions. Requires the Mogul / Owner Statements entitlement. Prefer get-owner-statements to discover statement UUIDs first.

get-owner-statement

Get a single owner statement expense or reimbursement transaction by UUID, including line items with amounts in the smallest currency unit. Requires the Mogul / Owner Statements entitlement.

get-owner-statement-transaction

Get a paginated list of owner statement expense and reimbursement transactions for the account. Filter by properties or businesses and date range. Amounts are in the smallest currency unit. Requires the Mogul / Owner Statements entitlement. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-owner-statement-transactions

Get a paginated list of owner statements for the account. Filter by properties, owner UUIDs, or status. Requires the Mogul / Owner Statements entitlement and returns summary totals such as total_due_to_owner. Use get-owner-statement when you need reservations and adjustments for a single statement. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-owner-statements

Get a single property owner by UUID, including contact details and address. Requires the Mogul / Owner Statements entitlement. Pass `include=ownerships` when you need the owner's properties and ownership dates.

get-owner

Get a paginated list of property owners for Owner Statements on the account. Filter by property, owner type (individual or company), or active ownerships only. Requires the Mogul / Owner Statements entitlement. Use this to discover which owners are linked to which properties before inspecting a single owner. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-owners

Get a single payout by UUID. Use includes sparingly because `transactions` can add a potentially large ledger collection to the payout payload.

get-payout

Get a paginated list of payouts for the authenticated user. Use includes sparingly because adding `transactions` can make each payout much heavier and duplicate ledger data across the response. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-payouts

Get a paginated list of properties for the authenticated user. Use includes sparingly because they can add substantial nested property, booking, and owner context. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-properties

Get the calendar for a property over a date range, including day-by-day availability, pricing, and stay rules. Keep ranges focused so the tool returns only the days the agent actually needs.

get-property-calendar

List the smart locks and thermostats linked to a property by UUID or numeric property id, including current battery level, online status, lock state, and thermostat temperature/setpoints. Use this for battery checks, connectivity audits, and pre-arrival climate verification. Optionally filter by `device_type` to only fetch smart locks or only fetch thermostats. Requires the smart-devices entitlement on the account.

get-property-devices

Get the ordered image gallery for a property by UUID. This returns the direct-booking image set that guests would see, including captions and thumbnail URLs.

get-property-images

Get the Knowledge Hub for a property by UUID. Use this before editing so you can inspect the current topics, item ids, and source summaries.

get-property-knowledge-hub

Get a paginated list of reviews for a property by UUID. Use includes sparingly because `guest`, `reservation`, `property`, and `listing` each expand every review row with nested resources. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-property-reviews

Get a single property by UUID. Use includes sparingly because they expand the payload with listing metadata, detailed property fields, booking context, or owner data.

get-property

Get a paginated list of purchased upsells across the account, ordered by most recently paid first. Each row includes the reservation UUID and code so you can tie an upsell back to a booking without fetching reservations one by one. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-purchased-upsells

Get a single accessible enrichment field for a reservation by UUID and shortcode key, including its current value, description, and example.

get-reservation-enrichment-data

Get the guest and host messages for a reservation. Each message includes `author` (`name` and teammate `id`, or null for guests, automation, and API/MCP sends) and `sender` (the platform identity shown to the guest). Use includes sparingly because `metadata` can add bulky per-message context and `user` adds resolved channel user data.

get-reservation-messages

Get automated messages scheduled for a single reservation (ordered by send time). Each row includes the resolved `message` text. Pass the reservation UUID or reservation code as `identifier`.

get-reservation-scheduled-messages

Get a single reservation by UUID or reservation code. Use includes sparingly because they can expand the payload with guest, property, listing, financial, review, task, or user data.

get-reservation

Get a paginated list of reservations for specific properties, with optional filters for dates, booking time, status, and message recency. Use includes sparingly because they can pull substantial nested guest, property, financial, review, and task data. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-reservations

Restricted to the account owner. Lists secondary users on the account — people who log into Hospitable with feature permissions (inbox, calendar, properties). Different from Operations teammates (cleaners / task assignees). Returns user_id, name, email, is_admin, is_active, all_features, features, all_properties, and properties. When all_features or all_properties is true (including admins), the matching list is empty. Property values are property UUIDs. Does not include the account owner. Secondary users, including admins, cannot list other secondary users.

get-secondary-users

List Hospitable template short codes (e.g. %guest_name%) for messaging rules, canned responses, custom codes and reservation agreements. Only use in saved templates — do not use when sending a message directly to the guest, where codes are not resolved and send as literal text (e.g. the guest sees `%guest_name%`). Optional `event` filter narrows by event context.

get-short-codes

Get a single task by UUID. `start_date` and `end_date` are returned in the property's local timezone (the `timezone` field identifies which one); always report task times to the user in that local timezone rather than UTC. Use includes sparingly because checklist, marketplace, and photo data can add nested detail to the task payload.

get-task

Get a paginated list of tasks for specific properties, with optional filters for dates, reservation UUID, teammate UUID, task types, and machine-readable status values. `start_date` and `end_date` are returned in the property's local timezone (the `timezone` field identifies which one); always report task times to the user in that local timezone rather than UTC. Keep includes sparse on list calls because marketplace data makes each row heavier. Pagination info is in the response `meta`. Call this tool again with the next `page` to get more results.

get-tasks