Auria BeautyGo connector (MCP)

Server URL: https://api-beautygo.technas.fr/mcp
Transport: Streamable HTTP (JSON-RPC 2.0)
Authentication: None for public tools. OAuth 2.1 with PKCE for tools that act on your own appointments.
Publisher: Technas OÜ, publisher of BeautyGo · [email protected]

Overview
Connect in Claude
OAuth sign-in
Tools
Preview and confirm flow
Deposits and payments
Example prompts
Troubleshooting
Privacy and data
Support

Overview

BeautyGo connects clients with beauty providers (hair, barber, lashes and brows, nails, make-up, skin and body care) in France and Togo. Auria is its assistant. The Auria BeautyGo connector exposes BeautyGo to AI assistants through the Model Context Protocol (MCP).

With it, an assistant can:

Without sign-in: find providers by city or name, search services and prices, read profiles, ratings and reviews, and list free time slots.
After you sign in to your BeautyGo account: list your upcoming appointments and your history, and book, reschedule or cancel your own appointments.

The connector only ever acts on the account that signed in. It never charges a payment: when a service requires a deposit, you receive a payment link and pay it yourself (see Deposits and payments).

Connect in Claude

In Claude, open Settings → Connectors.
Find Auria BeautyGo in the connector directory and select Connect. You can also select Add custom connector and paste the server URL https://api-beautygo.technas.fr/mcp.
Enable the connector in your conversation. The public tools (search, profiles, ratings, reviews, free slots) work right away, without an account.
The first time you ask about your appointments or ask to book, reschedule or cancel, Claude asks you to connect (you can also connect from the connector settings). A BeautyGo sign-in page opens: sign in with the same account you use in the BeautyGo app.
Approve the access. You are sent back to Claude, and the account tools now work for your account.

No BeautyGo account yet? Create one for free in the BeautyGo app (beautygo.fr/app) and come back to step 4.

OAuth sign-in

The server follows the MCP authorization specification:

A call to an account tool without a valid token returns 401 with a WWW-Authenticate challenge. This is what makes the client start the sign-in.
Protected resource metadata (RFC 9728): https://api-beautygo.technas.fr/.well-known/oauth-protected-resource/mcp
Authorization server: https://auth.technas.fr/realms/beautygo (OpenID Connect discovery at /.well-known/openid-configuration).
Authorization code flow with PKCE (S256). Dynamic Client Registration is supported, so clients register themselves.
Scopes requested: openid, profile, email. Tokens are sent in the Authorization: Bearer header only.

Disconnect at any time: remove or disconnect the connector in the settings of your assistant. To end every active session of your BeautyGo account, sign out of all devices from your BeautyGo account page.

Tools

The connector exposes 14 tools. Read tools never change anything. Write tools are annotated as such (readOnlyHint: false, and destructiveHint: true for reschedule and cancel), so that the assistant asks for your approval before acting.

Tool	What it does	Sign-in	Type
Find Beauty Providers `beautygo_find_providers`	Finds providers (a person or a salon) by city or by name. Returns their id, @handle, city and public profile link.	No	Read
Get Provider Profile `beautygo_get_provider`	Public profile of a provider from its id: name, city, bio, photo, rating, verification level, profile link.	No	Read
Get Provider Profile by Handle `beautygo_get_provider_by_handle`	The same public profile, looked up by @handle (for example from a beautygo.fr/@handle link).	No	Read
Search Beauty Services `beautygo_search_services`	Searches the service catalog by free text, category, price range, or around a location. Not for city names: use Find Beauty Providers.	No	Read
List Service Categories `beautygo_service_categories`	Lists the service categories available on BeautyGo.	No	Read
List Provider Services `beautygo_list_provider_services`	All services of one provider, with prices, durations and deposit requirements.	No	Read
Get Provider Rating `beautygo_provider_rating`	Average rating, number of reviews and breakdown by star.	No	Read
Get Provider Reviews `beautygo_provider_reviews`	Recent client reviews of a provider, with their comments.	No	Read
Get Available Time Slots `beautygo_available_slots`	Free slots of a provider for one day or a range of up to 31 days, in the local time of the venue. Can be sized to the duration of a service.	No	Read
My Upcoming Appointments `beautygo_my_upcoming_bookings`	Your next appointments, with date, service and provider.	Yes	Read
My Appointment History `beautygo_my_bookings`	Your appointments grouped by status: upcoming, past, cancelled.	Yes	Read
Book an Appointment `beautygo_book_appointment`	Sends a booking request to a provider for a date and time. Preview first, then confirm.	Yes	Write
Reschedule an Appointment `beautygo_reschedule_appointment`	Requests a new date for one of your bookings. Preview first, then confirm.	Yes	Write (destructive)
Cancel an Appointment `beautygo_cancel_appointment`	Cancels one of your bookings. Irreversible. Preview first, then confirm.	Yes	Write (destructive)

The usual chain is: Find Beauty Providers or Search Beauty Services → List Provider Services → Get Available Time Slots → Book an Appointment.

Preview and confirm flow

The three write tools (book, reschedule, cancel) work in two steps. This is what protects you from an action you did not ask for.

Preview. The assistant first calls the tool without confirm: true. This call only returns a preview of what would happen and changes nothing.
Your approval. The assistant shows you the preview: provider, service, date and time, and for a cancellation the consequences on any deposit.
Confirm. Only after you explicitly approve does the assistant call the same tool again with confirm: true. That second call performs the action.

What each action does once confirmed:

Book: creates a booking request. Without a deposit, it is sent to the provider right away (status: pending) and waits for the provider to accept. Each confirmed call creates a new request, so a confirmed booking is never repeated.
Reschedule: a request that is still pending moves to the new date directly. For an appointment that is already confirmed, the new date is only proposed to the provider and applies once the provider accepts. Within 48 hours of a confirmed appointment, rescheduling is refused (reschedule_within_48h) and must be arranged with the provider in the BeautyGo app.
Cancel: irreversible. Depending on the cancellation policy of the provider, a deposit is released, refunded or kept (late cancellation), and a late cancellation can affect your reliability score. Cancelling within 48 hours of a confirmed appointment may require the agreement of the provider.

Deposits and payments

The connector never charges you. Some providers ask for a deposit on some services:

The preview says whether a deposit is required and how much it is.
Once you confirm, the request is created awaiting deposit (status: awaiting_deposit) and the assistant gives you a secure payment link. You open it and pay yourself. The assistant is instructed never to open that link.
The provider receives the request only after the deposit is paid. The deposit is held on your card, charged only if the provider accepts, and released otherwise.
If the deposit is not paid before the deadline, the request is cancelled and nothing is charged.

Example prompts

“Find someone who does knotless braids in Nice.”
“What does this provider offer, and at what price?”
“Show me the free slots of this provider next Tuesday afternoon.”
“What are the reviews of this barber in Antibes?”
“When is my next beauty appointment?”
“Book the 14:30 slot for the classic manicure.” (the assistant shows a preview and waits for your yes)
“Move my Thursday appointment to Friday at 10:00.”
“Cancel my appointment of 12 October.”

Troubleshooting

The sign-in page does not open, or I am asked to sign in again and again

Disconnect the connector in the settings of your assistant, then connect it again. Allow pop-ups and third-party cookies for the sign-in page if your browser blocks them, and sign in with the same account you use in the BeautyGo app.

“My appointments” is empty although I have appointments

You are probably signed in with another BeautyGo account (for example one created with another email or with Google or Apple sign-in). Disconnect the connector and connect again with the account you use in the app.

The tools or their descriptions look outdated

Assistants keep the list of tools they received when the connector was added. Disconnect and reconnect the connector to load the current list.

A search for a city returns nothing

City names belong in Find Beauty Providers (its city parameter). Search Beauty Services has no city field: a city typed as free text returns an empty list. If a category search is empty, check the exact category name with List Service Categories.

“This slot is no longer available”

Slots are checked again at booking time and another client may have taken it. Ask for the free slots again and pick another one.

Rescheduling is refused with `reschedule_within_48h`

The appointment is confirmed and less than 48 hours away. Contact your provider in the BeautyGo app to agree on a change.

The deposit payment link expired

An unpaid request is cancelled at the deadline and nothing is charged. Ask the assistant to book again to get a new request and a new link.

An error says authentication is required

Your session expired or was revoked. Reconnect the connector and sign in again. Public tools keep working without an account.

Something else

Write to [email protected] with the name of your assistant, the date and time, and what you asked. Never send your password.

Privacy and data

Public tools return only public information that providers chose to publish on the BeautyGo website. Providers can opt out of being shown to AI assistants.
Account tools read and change only the appointments of the signed-in account. The connector does not expose payment card details.
The connector receives only the tool calls your assistant makes, never your whole conversation. Bookings made through it are processed like bookings made in the app.
Full details: Privacy policy and Terms of use (in French). To delete your account and its data: account deletion.

Support

BeautyGo is published by Technas OÜ, Sepapaja tn 6, 15551 Tallinn, Estonia (registry code 17460697). Contact: [email protected]. See also the legal notice (in French).