Order Labs (MCP)

Step 1 — ensure profile is complete

Lab orders need: gender, phone (with dial code), birth date, and complete home address.

1. getProfile() — check fields. Anything N/A blocks the order.
2. If missing, call updateProfile(...) to fill them. Phone requires both phone and phoneDialCode.

The home address must be the user's personal home address. Never use a lab service center, appointment location, or anything from searchLabServiceCenters.

Step 2 — browse and select

listAvailableLabTests requires confirmedUsState and fails closed without it (returns locationRequired: true). Confirm the state with the user first — never guess. Same-named panels can be different sellable products across states, so always reference labs by objectKey, never by display name.

3. listAvailableLabTests(confirmedUsState) — show name, price, included biomarkers, and objectKey
4. Confirm the user wants to proceed before any payment

Step 3 — pay

5. listSavedPaymentMethods() — check for saved cards

If saved cards exist:

6. Show available cards (brand, last 4) and ask which to use
7. purchaseLabTest(labTestObjectKey, paymentMethodExternalId) — order is created and auto-initialized

If no saved cards:

6. purchaseLabTestWithCheckout(labTestObjectKey, successUrl, cancelUrl) — generate Stripe Checkout link
7. Share the complete checkoutUrl with the user (never truncate). Order is created via webhook after payment.

Step 4 — initialize if needed

If auto-init didn't complete (e.g. profile field was missing at purchase time):

8. getUserLabRecords() — check status
9. If status is "Paid": initializeLabOrder(labOrderExternalId). Requires complete profile.

Step 5 — schedule blood draw

10. Ask the user for ZIP code (or use home address)
11. searchLabServiceCenters(zipCode, labOrderExternalId) — show nearby labs
12. User picks a lab → ask for date / time preference
13. getServiceCenterSlots(siteCode, labOrderExternalId, timezone, startDate, rangeDays) — show options. Let the user choose — don't pick automatically.
14. User picks a slot → confirm date/time/location → bookLabAppointment(labOrderExternalId, bookingKey, timezone)

Step 6 — manage appointment

• Reschedule (only while status is "Appointment Scheduled"): getServiceCenterSlots for new options → rescheduleLabAppointment(labOrderExternalId, newBookingKey, timezone). Old appointment auto-cancels.
• Cancel: call cancelLabAppointment(labOrderExternalId) without a reason → show options → call again with reasonId to confirm
• Re-book after cancel: use bookLabAppointment (not rescheduleLabAppointment — reschedule only works on active appointments)

Step 7 — view results

After the user visits the lab, results process automatically. Once status reaches "Completed":

15. searchBiomarkers — view values and ranges
16. getBiologicalAge() — see how it shifts the user's biological age

Status reference

Status	Next step
Paid	Complete profile, then initializeLabOrder
Order Submitted	Wait — no action needed
Requisition Created	Search for labs and book
Appointment Scheduled	Visit at the scheduled time. Can reschedule/cancel.
Appointment Cancelled	bookLabAppointment for a new appointment
Redraw Available	Schedule a new appointment for the redraw
Partial Results	View available, wait for the rest
Completed	View with searchBiomarkers and getBiologicalAge
Failed	Contact support or reorder

Every order from getUserLabRecords includes statusDescription and nextStep fields. Use nextStep as your primary guide.