AURA 300 BOOKING

Aura 300 Booking — Developer & Product Docs

Remote MCP server for agentic hair salon booking · Support: info@aura300.ai

What is Aura 300 Booking

Aura 300 Booking is agentic booking for hair salons. It's a remote MCP (Model Context Protocol) server that lets AI assistants — Claude, ChatGPT, and any other MCP-compatible agent — search participating businesses, check real-time availability, and book, reschedule, or cancel appointments, in natural language, directly against that business's own booking system (CRM). The same broker also powers a simple end-customer chat page per salon, so a business's own customers can book by chatting, no app required.

Server

Transport	MCP over Streamable HTTP
URL	`https://booking.aura300.ai/mcp`
Auth	OAuth 2.1 (public/directory clients) or a private bearer token (internal integrations)

Tools

Tool	Type	Description
`search_salons`	read	Find bookable salons by name or handle, optionally filtered by city.
`get_services`	read	List services and staff for a salon.
`search_availability`	read	Find available slots for a service in a date range.
`book`	write	Create a booking. Two-step: may come back `held` pending a verification step, or `confirmed` immediately depending on the salon's policy.
`confirm_booking`	write	Complete a held booking after the customer completes the secure hosted browser verification link.
`find_bookings`	read	Look up a customer's upcoming bookings by phone number.
`cancel_booking`	write	Cancel a booking.
`reschedule_booking`	write	Move a confirmed booking to a new time — same booking, updated in place.
`request_booking_access`	write	Request a hosted browser verification link for booking access.

Every tool declares a title, input and output schemas, and explicit readOnlyHint, destructiveHint, and openWorldHint annotations.

Authentication — OAuth 2.1

Aura 300 Booking implements the MCP authorization spec: OAuth 2.1 with mandatory PKCE (S256), protected-resource metadata, and dynamic client registration. Connecting applications do not need a pre-shared secret.

Protected-resource metadata	`GET /.well-known/oauth-protected-resource` (RFC 9728)
Authorization-server metadata	`GET /.well-known/oauth-authorization-server` (RFC 8414)
Dynamic client registration	`POST /oauth/register` (RFC 7591)
Authorize	`GET`/`POST /oauth/authorize` — PKCE `S256` required, `plain` not supported
Token	`POST /oauth/token` — `authorization_code` and `refresh_token` grants
Scopes	`booking:read`, `booking:write`

Full discovery URLs:

https://booking.aura300.ai/.well-known/oauth-protected-resource
https://booking.aura300.ai/.well-known/oauth-authorization-server

An unauthenticated request to the MCP endpoint receives 401 with a WWW-Authenticate: Bearer resource_metadata="…" challenge pointing at the protected-resource metadata above, per spec.

Connect from Claude

In claude.ai, Claude Desktop, or Claude mobile: open Settings → Connectors, then either find Aura 300 Booking in the directory or choose Add custom connector.
For a custom connector, paste the server URL: https://booking.aura300.ai/mcp. In Claude Code: claude mcp add --transport http aura-booking https://booking.aura300.ai/mcp.
Claude registers itself automatically and opens the Aura 300 Booking authorization page — approve it. No Aura account, username, or password is needed.
Ask, in natural language: "Find [salon name] and show me its services" or "Book me a haircut at [salon] on Friday morning."

Connect from ChatGPT

Settings → Apps & Connectors (or Developer mode for internal testing) → Add app / Add MCP server.
Paste the server URL: https://booking.aura300.ai/mcp.
ChatGPT validates the server, lists its tools, and walks you through OAuth authorization.
Ask ChatGPT to find a salon and book an appointment, the same way you would in Claude.

Example prompts

Bookings work at participating hair salons — see the live list at booking.aura300.ai/salons.

"What services does [salon] offer, and how long does each take?"
"Is there anything free at [salon] for a facial this Friday afternoon?"
"Book me the 3pm slot — my name is Sam Taylor, phone +61 400 000 000."
"Move my appointment at [salon] to next Tuesday morning."
"Cancel my booking at [salon]."

Times are always in the salon's local timezone.

Troubleshooting

"Couldn't reach the MCP server" — check the URL is exactly https://booking.aura300.ai/mcp. Service status: /health returns "ok": true when the broker is up.
Authorization fails or the approval page doesn't open — allow pop-ups for claude.ai, remove the connector, and add it again. Approving creates a new connection; nothing else is required.
"No salon has this salon_id" / salon not found — only participating salons are bookable. Search by the salon's name, or check /salons.
"That time was just taken" — availability is live against the salon's own calendar; ask again for current times.
Verification link expired — request a fresh hosted browser verification link. A held slot expires after five minutes; search again before creating a new request.
Can't see or change a booking made elsewhere — bookings are private to the connection that made them. Request booking access and complete the secure hosted browser verification link; then retry the action from the same connection.
Disconnecting — remove Aura 300 Booking under Settings → Connectors. To have your booking data deleted, email info@aura300.ai.

Support & privacy

Questions, bug reports, or integration help: info@aura300.ai. See our Privacy Policy for what data is processed and how.

Security: report a vulnerability or suspected misuse to info@aura300.ai with the subject "Security report". We acknowledge reports and investigate promptly.