{
  "schema_name": "whc-agent-capabilities",
  "schema_version": "1.0",
  "status": "operational_protected_production",
  "provider": {
    "name": "The Women's Health Clinic",
    "website": "https://thewomenshealth.clinic/",
    "agent_booking_instructions": "https://thewomenshealth.clinic/ai-agent-booking/",
    "human_booking_fallback": "https://thewomenshealth.clinic/online-booking/"
  },
  "service": {
    "name": "WHC Consultation Booking Gateway",
    "scope": "consultation_booking_only",
    "platform_independent": true,
    "source_of_truth": "GHL",
    "canonical_origin": "https://agent-booking.thewomenshealth.clinic",
    "mcp_endpoint": "https://agent-booking.thewomenshealth.clinic/mcp",
    "mcp_documentation": "https://agent-booking.thewomenshealth.clinic/docs/mcp",
    "openapi_document": "https://agent-booking.thewomenshealth.clinic/openapi.json",
    "rest_base_url": "https://agent-booking.thewomenshealth.clinic/agent/v1",
    "rest_documentation": "https://agent-booking.thewomenshealth.clinic/docs/rest-v1",
    "canonical_routes_status": "active_verified"
  },
  "authorization": {
    "provider": "Auth0",
    "protocol": "OAuth 2.0",
    "required_for_operational_interfaces": true,
    "anonymous_access": false,
    "scopes": {
      "whc.booking.read": "List consultation options, find consultation availability, and retrieve a caller-owned booking record.",
      "whc.booking.write": "Request consultation booking creation when the independent server-side write switch permits it."
    },
    "rollout": "approved_clients_only",
    "approved_client_policy_enforced": true,
    "per_user_tester_enrollment_required": false,
    "firestore_security_controls_enforced": true,
    "booking_writes_enabled": true
  },
  "consultation_options": {
    "dynamic": true,
    "discovery_action": "list_consultation_options",
    "instruction": "Always call list_consultation_options. Do not rely on a permanent calendar list."
  },
  "interfaces": {
    "mcp": {
      "endpoint": "https://agent-booking.thewomenshealth.clinic/mcp",
      "access": "auth0_oauth_approved_clients"
    },
    "rest_v1": {
      "base_url": "https://agent-booking.thewomenshealth.clinic/agent/v1",
      "access": "auth0_oauth_approved_clients",
      "publicly_exposed": true
    }
  },
  "actions": [
    {
      "name": "list_consultation_options",
      "interfaces": {
        "mcp_tool": "list_consultation_options",
        "rest_route": "GET /agent/v1/consultations"
      },
      "required_scopes": [
        "whc.booking.read"
      ],
      "effect": "read"
    },
    {
      "name": "find_consultation_slots",
      "interfaces": {
        "mcp_tool": "find_consultation_slots",
        "rest_route": "GET /agent/v1/consultations/{id}/slots"
      },
      "required_scopes": [
        "whc.booking.read"
      ],
      "effect": "read",
      "returns_opaque_slot_references": true
    },
    {
      "name": "create_consultation_booking",
      "interfaces": {
        "mcp_tool": "create_consultation_booking",
        "rest_route": "POST /agent/v1/bookings"
      },
      "required_scopes": [
        "whc.booking.write"
      ],
      "effect": "write",
      "currently_enabled": true,
      "requires_user_provided_contact_details": true,
      "requires_booking_processing_consent": true,
      "requires_explicit_user_confirmation": true,
      "subject_to_independent_server_side_write_switch": true
    },
    {
      "name": "get_consultation_booking",
      "interfaces": {
        "mcp_tool": "get_consultation_booking",
        "rest_route": "GET /agent/v1/bookings/{id}"
      },
      "required_scopes": [
        "whc.booking.read"
      ],
      "effect": "read",
      "limitation": "Returns caller-owned gateway booking state and does not automatically refresh appointment status from GHL."
    }
  ],
  "boundaries": {
    "consultation_only": true,
    "treatment_calendars_exposed": false,
    "raw_ghl_identifiers_exposed": false,
    "generic_ghl_tools_exposed": false,
    "medical_advice_supported": false,
    "diagnosis_supported": false,
    "triage_supported": false,
    "emergency_help_supported": false,
    "treatment_selection_supported": false,
    "payment_handling_supported": false,
    "cancellation_supported": false,
    "rescheduling_supported": false
  },
  "failure_handling": {
    "availability_is_not_a_reservation": true,
    "success_requires_confirmed_gateway_result": true,
    "ambiguous_outcomes_must_not_be_automatically_retried": true,
    "human_fallback": "https://thewomenshealth.clinic/online-booking/"
  }
}