Booboooking Appointment Booking MCP

List available services for a provider on booboooking.com. Returns service names, IDs, duration, and price. Call this first to find the service ID needed for availability and booking.

• providerstringrequiredProvider identifier (e.g. "radnaimark", "tomi")

Check available time slots for a provider and service on booboooking.com. Returns available dates with slots — each slot has a "time" field (use this for booboooking_book) and a "display" field (show this to the user). Use this before booking.

• providerstringrequiredProvider identifier
• service_idstringrequiredService ID from booboooking_list_services (the "id" field)
• start_datestringStart date in YYYYMMDD format (default: today)
• days_aheadnumberHow many days to check (default: 14, max: 30)

Book an appointment on booboooking.com (free OR paid services — payment is always in cash at the appointment, no online payment). For customer_name and customer_email, use the signed-in user's profile from your host app — do NOT ask them to retype. Always ask for customer_phone separately (it is not in the sign-in profile). customer_phone MUST be in international E.164 format starting with `+` and country code (e.g. `+36201234567`), no spaces/dashes — convert local-format numbers before calling this tool or the booking will fail validation. On success the response includes `id` and `pin` (MUST remember paired, for cancellation) and optionally `cash_due: { amount, currency }` — if present, remind the user to bring that amount in cash.

• providerstringrequiredProvider identifier
• service_idstringrequiredService ID from booboooking_list_services
• datestringrequiredDate in YYYYMMDD format (e.g. "20260415")
• timestringrequiredStart time in HH:MM format (e.g. "09:30") — use the "time" field from booboooking_check_availability results
• customer_namestringCustomer full name
• customer_emailstringCustomer email address
• customer_phonestringCustomer phone number (mobile)

Cancel a reservation on booboooking.com. Requires the reservation_id AND pin that were returned from the original booboooking_book call — both are needed as proof of booking ownership. If the user asks to cancel but you do not have the pin in your conversation state, you MUST ask them for it — you cannot cancel without it. Never invent or guess a pin.

• providerstringrequiredProvider identifier (same as the one used for booking)
• reservation_idstringrequiredThe `id` returned from the original booking (24-hex MongoDB ObjectId)
• pinstringrequiredThe 4-digit PIN returned from the original booking

Search forward for the next available appointment slots for a provider and service on booboooking.com. Returns up to `count` openings sorted chronologically. Useful when you need "the next available appointment" without a specific date in mind.

• providerstringrequiredProvider identifier
• service_idstringrequiredService ID from booboooking_list_services
• from_datestringStart search from this date in YYYYMMDD format (default: today)
• countintegerNumber of openings to return (default: 3, max: 10)
• search_daysintegerDays to search ahead (default: 30, max: 60)

Retrieve a booking by its reservation ID. Requires the PIN from the original booking response to prove ownership. Returns full booking details including payment state if the reservation was created via the payment flow.

• reservation_idstringrequiredThe reservation ID returned from booboooking_book (24-char hex MongoDB ObjectId)
• pinstringrequiredThe 4-digit PIN returned from the original booboooking_book call
• providerstringrequiredProvider identifier (same as used for booking)