Skip to content
The Bookwise guidev1.1.0Read as Markdown
Documentation menu
Docs/For developers
The complete reference

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_businesses

Searches 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.

ReadDirectory only
get_business

Returns 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.

ReadDirectory + business
list_offerings

Lists a business's bookable offerings (room types, table areas or services) with attributes, prices and real photos. Supports simple filters and pagination.

ReadDirectory + business
check_availability

Checks 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.

ReadDirectory + business
get_quote

Returns the exact price breakdown for one option from check_availability: base price, seasonal adjustments, fees, taxes, deposit due and cancellation terms.

ReadDirectory + business
create_hold

Temporarily 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.

WriteDirectory + business
confirm_booking

Confirms 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.

WriteDirectory + business
verify_booking

Submits 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.

WriteDirectory + business
get_booking

Returns a booking's status and details. Requires the bookingId and the accessToken issued when it was confirmed.

ReadDirectory + business
cancel_booking

Cancels 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.

WriteDirectory + business
reschedule_booking

Preview 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.

WriteDirectory + business
get_cancellation_quote

Read 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.

ReadDirectory + business
release_hold

Release 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.

WriteDirectory + business
resend_verification_code

Resend 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.

WriteDirectory + business
get_booking_progress

Read 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.

ReadDirectory + business
search_available_businesses

Search 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.

ReadDirectory only
get_availability_calendar

Compare 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.

ReadDirectory + business
update_booking_details

Update 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.

WriteDirectory + business
recover_booking_access

Recover 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.

WriteDirectory + business
join_booking_waitlist

Subscribe 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.

WriteDirectory + business
list_bookings

OWNER 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.

ReadOwnerDirectory + business
get_booking_detail

OWNER 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.

ReadOwnerDirectory + business
approve_booking

OWNER ONLY. Approve a booking awaiting business approval before its deadline. Requires business ownership and an idempotencyKey. Notifies the customer through the existing booking workflow.

WriteOwnerDirectory + business
decline_booking

OWNER ONLY. Decline a booking awaiting business approval before its deadline. Requires business ownership and an idempotencyKey. Notifies the customer through the existing booking workflow.

WriteOwnerDirectory + business
mark_booking_outcome

OWNER 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.

WriteOwnerDirectory + business
get_business_calendar

OWNER 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.

ReadOwnerDirectory + business
get_business_overview

OWNER 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.

ReadOwnerDirectory + business