MCP Server

booboooking Appointment Booking

com.spocont/booboooking
Business & Operations Public & reachable MCP 2025-11-25

What this MCP does

Lists provider services, checks appointment availability, and creates, retrieves, or cancels bookings.

booboooking_book
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.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider', 'service_id', 'date', 'time'], 'properties': {'date': {'type': 'string', 'description': 'Date in YYYYMMDD format (e.g. "20260415")'}, 'time': {'type': 'string', 'description': 'Start time in HH:MM format (e.g. "09:30") â\x80\x94 use the "time" field from booboooking_check_availability results'}, 'provider': {'type': 'string', 'description': 'Provider identifier'}, 'service_id': {'type': 'string', 'description': 'Service ID from booboooking_list_services'}, 'customer_name': {'type': 'string', 'description': 'Customer full name'}, 'customer_email': {'type': 'string', 'description': 'Customer email address'}, 'customer_phone': {'type': 'string', 'pattern': '^\\+[1-9]\\d{6,14}$', 'description': 'Customer phone number in international E.164 format, e.g. "+36201234567" â\x80\x94 convert local-format numbers (e.g. "06201234567") before calling this tool.'}}}
booboooking_cancel
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.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider', 'reservation_id', 'pin'], 'properties': {'pin': {'type': 'string', 'description': 'The PIN returned from the original booking'}, 'provider': {'type': 'string', 'description': 'Provider identifier (same as the one used for booking)'}, 'reservation_id': {'type': 'string', 'description': 'The `id` returned from the original booking (24-hex MongoDB ObjectId)'}}}
booboooking_check_availability
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider', 'service_id'], 'properties': {'provider': {'type': 'string', 'description': 'Provider identifier'}, 'days_ahead': {'type': 'number', 'description': 'How many days to check (default: 14, max: 30)'}, 'service_id': {'type': 'string', 'description': 'Service ID from booboooking_list_services (the "id" field)'}, 'start_date': {'type': 'string', 'description': 'Start date in YYYYMMDD format (default: today)'}}}
booboooking_find_next_available
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider', 'service_id'], 'properties': {'count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of openings to return (default: 3, max: 10)'}, 'provider': {'type': 'string', 'description': 'Provider identifier'}, 'from_date': {'type': 'string', 'description': 'Start search from this date in YYYYMMDD format (default: today)'}, 'service_id': {'type': 'string', 'description': 'Service ID from booboooking_list_services'}, 'search_days': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Days to search ahead (default: 30, max: 60)'}}}
booboooking_get_booking
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['reservation_id', 'pin', 'provider'], 'properties': {'pin': {'type': 'string', 'description': 'The PIN returned from the original booboooking_book call'}, 'provider': {'type': 'string', 'description': 'Provider identifier (same as used for booking)'}, 'reservation_id': {'type': 'string', 'description': 'The reservation ID returned from booboooking_book (24-char hex MongoDB ObjectId)'}}}
booboooking_list_services
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider'], 'properties': {'provider': {'type': 'string', 'description': 'Provider identifier (e.g. "radnaimark", "tomi")'}}}
Added
booboooking_get_booking
Sept. 17, 2026, 12:37 p.m.
Added
booboooking_find_next_available
Sept. 17, 2026, 12:37 p.m.
Added
booboooking_cancel
Sept. 17, 2026, 12:37 p.m.
Added
booboooking_book
Sept. 17, 2026, 12:37 p.m.
Added
booboooking_check_availability
Sept. 17, 2026, 12:37 p.m.
Added
booboooking_list_services
Sept. 17, 2026, 12:37 p.m.