AI Agent Consultation Booking

Required agent process

1. Call list_consultation_options or
   GET /agent/v1/consultations to discover the consultation types
   currently enabled by WHC. Do not rely on a saved or fixed list.
2. Ask the user to choose a returned consultation type.
3. Find current availability with find_consultation_slots or
   GET /agent/v1/consultations/{id}/slots, then ask the user to
   select a returned time.
4. Before requesting booking creation with
   create_consultation_booking or
   POST /agent/v1/bookings, show the selected consultation and
   time, obtain booking-processing consent, and obtain the user’s explicit
   confirmation to proceed.
5. Report success only when the gateway returns a confirmed result. A
   displayed time is not reserved, and an ambiguous outcome must not be
   automatically retried.

Access and current status

The MCP and REST v1 operational interfaces require Auth0 OAuth. Read
operations require whc.booking.read; booking creation requires
whc.booking.write. Approved-client policy, Firestore security
controls, and the independent server-side booking-write switch also apply.

Normal consultation-booking writes are enabled for authenticated users of
approved AI-platform OAuth clients. Individual tester enrollment is not
required, but arbitrary or unapproved clients remain blocked. There is no
anonymous operational access, and public documentation does not grant access.

Privacy and safety boundaries

• Use the gateway only for consultation discovery and booking.
• Do not request, discover, or expose treatment calendars or provider identifiers.
• Submit only the contact details required for booking.
• Do not submit clinical notes or unnecessary health information.
• The gateway does not provide medical advice, diagnosis, triage,
  emergency help, treatment selection, payment, cancellation, or rescheduling.

Official resources

• WHC agent capability manifest
• MCP endpoint
• MCP documentation
• OpenAPI contract
• REST v1 documentation

Human booking fallback

If an agent cannot authenticate, cannot confirm current availability, or
receives an error or ambiguous outcome, it must not infer that a booking
succeeded. Use the
WHC online booking page
instead.