Documentation menu
Small tools.
Complete booking flows.
27 tools for discovering businesses, managing bookings and operating your business. Contracts below come directly from the server registrations.
27 tools · select a tool for its full contract
search_businessesSearches published hotels, restaurants and salons by free-text query, location, type and optional date. Returns up to 10 businesses with price-from, distance and booking links. Results are not sponsored.
get_businessReturns a business's profile, location, opening hours, policies (structured and readable), offerings summary, the JSON Schema for its booking parameters, its booking page URL and its MCP endpoint URL.
list_offeringsLists a business's bookable offerings (room types, table areas or services) with attributes, prices and real photos. Supports simple filters and pagination.
check_availabilityChecks live availability for the given booking parameters, optionally for one offering. Returns available options with total prices and up to 3 alternatives when the request can't be met.
get_quoteReturns the exact price breakdown for one option from check_availability: base price, seasonal adjustments, fees, taxes, deposit due and cancellation terms.
create_holdTemporarily reserves one option (by optionId, or the first available option for params) for a few minutes so the customer can confirm. Returns holdId, expiresAt, the quote and the next step. Does not charge or message the customer.
confirm_bookingConfirms a hold with the customer's contact details. Depending on the business's policies this sends a 6-digit verification code to the customer by WhatsApp, SMS or email, returns a payment link for a deposit, asks the business for approval, or confirms immediately.
verify_bookingSubmits the 6-digit code the customer received. On success the booking moves to its next step (payment, business approval or confirmed) and an accessToken is returned once. At most 5 attempts per hold.
get_bookingReturns a booking's status and details. Requires the bookingId and the accessToken issued when it was confirmed.
cancel_bookingCancels a booking and applies the business's cancellation policy. Returns whether cancellation was free, any fee, and any refund. Notifies the business. This cannot be undone.
reschedule_bookingPreview or apply a replacement for a confirmed future booking. First call mode=preview with new params. Show the quote and priceDifference to the customer. After acceptance, call mode=apply with the returned optionId, acceptedTotalMinor, acceptedCurrency and a new idempotencyKey. Original booking is preserved on failure. Changes requiring a deposit adjustment/refund must be arranged with the business.
get_cancellation_quoteRead the fee and refund that would apply if this booking were cancelled now. Does not cancel it. Show the preview before calling cancel_booking; the actual fee can change at the policy deadline.
release_holdRelease an unpaid held/pending-verification reservation immediately using its holdToken. Frees capacity without charging or messaging. For verified bookings use get_cancellation_quote then cancel_booking.
resend_verification_codeResend a booking code to the contact already on an active hold. Requires holdToken. Wait 60 seconds between sends; at most 3 resends. Does not extend the hold or reset guessing attempts. Ask the customer for the new code, then call verify_booking.
get_booking_progressRead status and nextStep using holdToken before verification or accessToken afterward. A hold token never returns a payment URL or personal details. Use this while waiting for verification, payment or business approval.
search_available_businessesSearch the top 10 matching published businesses and check live availability with exact booking requirements. Requires vertical and matching params. Salon searches may omit offeringId to search each business's services. Returns bookable options, without reserving capacity.
get_availability_calendarCompare available options and starting prices across an inclusive range of up to 31 local dates. Supply non-date booking params; each day replaces date/checkIn/checkOut. For hotels nights is the stay length. For restaurants supply time and partySize; for salons supply offeringId.
update_booking_detailsUpdate the guest name and/or special requests on an active verified booking. Empty notes clears requests. Does not alter dates, prices, verified contact details, or other bookings belonging to this customer. Use reschedule_booking for dates or offerings.
recover_booking_accessRecover a lost booking access token in two calls. request_code requires the existing booking contact; the response does not reveal whether it matches. verify_code requires the returned recoveryId and customer's 6-digit code. Success rotates the token, invalidating the old one. Codes expire in 10 minutes and allow at most 5 guesses.
join_booking_waitlistSubscribe the customer to one email when their requested option becomes available. Requires explicit customer intent to receive the alert. Does not reserve, pay, or auto-book. The entry expires after the requested local date. Separate from the business signup waitlist.
list_bookingsOWNER ONLY. List this owner's business bookings, optionally filtered by status, channel, customer name, booking ID or time window. Requires owner authentication. Returns parent bookings; from/to select overlapping stays or appointments.
get_booking_detailOWNER ONLY. Inspect one parent booking with customer contact, special requests, payments and status history. Requires ownership of businessId; customer access tokens are not used or returned.
approve_bookingOWNER ONLY. Approve a booking awaiting business approval before its deadline. Requires business ownership and an idempotencyKey. Notifies the customer through the existing booking workflow.
decline_bookingOWNER ONLY. Decline a booking awaiting business approval before its deadline. Requires business ownership and an idempotencyKey. Notifies the customer through the existing booking workflow.
mark_booking_outcomeOWNER ONLY. Mark a confirmed booking completed after its scheduled end or no_show after its scheduled start. Updates customer history and triggers the existing completion workflow. Requires ownership and a unique idempotencyKey.
get_business_calendarOWNER ONLY. Read booking allocations, resources and calendar blocks overlapping an explicit window of at most 93 days. Timestamps must include UTC offsets. Requires business ownership. Calendar feed tokens and connection credentials are never returned.
get_business_overviewOWNER ONLY. Read booking totals, conversion, no-show rates and estimated commission savings for the last days (default 30). Money values use minor currency units; commission savings are estimates. Requires business ownership.