BeautyGo

PREVIEW FIRST: without `confirm: true` this call only returns a preview and changes nothing. Call it again with `confirm: true` only after the user has explicitly approved that preview. Books a beauty appointment for the signed-in user, never for someone else. Requires the provider id (`stylist_id`, from beautygo_search_services or beautygo_find_providers) and the requested date and time (`requested_datetime`, ISO 8601). Provide `service_id` (from beautygo_list_provider_services) unless it is a free-form request. DEPOSIT: services that require a deposit (`deposit_required` in beautygo_list_provider_services) cannot be booked here; the call is refused, nothing is created, and the user books them in the BeautyGo app. Otherwise the request is sent to the provider (`status: pending`) and waits for the provider to accept. This tool never charges the user and never returns a payment link. Each confirmed call creates a new request, so never repeat a confirmed call.

beautygo_book_appointment

PREVIEW FIRST: without `confirm: true` this call only returns a preview and changes nothing. Call it again with `confirm: true` only after the user has explicitly approved that preview. Cancels a booking of the signed-in user. IRREVERSIBLE. Depending on the cancellation policy of the provider, any deposit is released (if it was only authorized on the card), refunded (if it was charged) or kept (late cancellation); a reputation penalty may apply, and cancelling within 48 hours of a confirmed appointment may be refused (it then needs the provider to agree). Always show these consequences in the preview before confirming.

beautygo_cancel_appointment

Main entry point to find beauty PROVIDERS (a person or a salon) by city or by name. Use it as soon as the user asks for people: who does braids in Antibes, a hairdresser in Nice, a barber nearby, or a provider by name. Put a city name in the `city` parameter, never in the free text of beautygo_search_services, which has no city field and would return an empty list. Returns for each provider its id, its @handle, its city and the link to its public profile. Pass the id to beautygo_list_provider_services or beautygo_provider_rating. `total` is the real number of matches and `returned` is how many are included.

beautygo_find_providers

Lists the FREE appointment slots of a provider, for ONE day (`date=YYYY-MM-DD`) or a RANGE (`from` and `to`, 31 days max). Requires the provider id (`stylist_id`, returned by beautygo_find_providers). Passing `service_id` (from beautygo_list_provider_services) sizes the slots to the real duration of that service. Each slot has a `slot_id` (opaque and stable), the local time AT THE VENUE and a timezone-aware ISO 8601 timestamp. Call it BEFORE beautygo_book_appointment or beautygo_reschedule_appointment so that you only offer times that are actually free. Availability is not guaranteed and is checked again when booking.

beautygo_available_slots

Full public profile of a provider from its id (the `stylist_id` returned by beautygo_search_services, or the `id` returned by beautygo_find_providers): name, city, bio, photo, average rating, verification level, and `profile_url`, the link to give to the user to book on BeautyGo.

beautygo_get_provider

Same public profile, looked up by @handle (for example lashesbymarthe). Use it when the user mentions a handle or pastes a link such as beautygo.fr/@someone.

beautygo_get_provider_by_handle

Average rating, total number of reviews and breakdown by star for a provider. Cheap: prefer it over beautygo_provider_reviews when only the rating matters.

beautygo_provider_rating

Reviews left by the clients of a provider, with their comments. Use it when the user asks what people think of a provider, not only the rating.

beautygo_provider_reviews

All services offered by ONE provider, with their prices and durations. Call it after beautygo_search_services or beautygo_find_providers to answer what a provider offers and at what price.

beautygo_list_provider_services

Lists the service categories that exist on BeautyGo. Call it BEFORE beautygo_search_services when unsure about the `category` value: an invented category returns an empty list, which would wrongly suggest that nobody offers the service.

beautygo_service_categories