Betterness
How it worksBett-iTutorialsAboutFor businesses ↗, opens Betterness One in a new tabLog inSign up
How it worksBett-iTutorialsAboutFor businesses: Betterness One ↗, opens Betterness One in a new tab
Log inSign up
Skip to content

Overview

  • What is Betterness

Connect

  • Connect by signing in
  • Claude custom connector
  • ChatGPT custom MCP server
  • Permissions
  • Connected apps
  • Privacy and data

Trust

  • Trust Center
  • Audit Trail
  • Limits & Scopes

Resources

  • Troubleshooting
  • Glossary

Server

Get started

  • Connect with an API Key
  • Authentication
  • First Tool Call

Clients

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • ChatGPT
  • OpenClaw / BetterClaw

Recipes

  • Health Overview
  • Order Labs
  • Upload Lab Results
  • Biomarker Gap Analysis
  • Connect Wearables
  • Health Profile

Tools

  • All Tools
  • Profile
  • Wearables
  • Health Data
  • Nutrition
  • Logging
  • Biomarkers
  • Documents
  • Lab Tests
  • Lab Records
  • Lab Orders
  • Lab Results
  • Purchases
  • Confirming Actions
  • Inbox
  • Training Program
  • Updates
  • Health Profile
Docs/Betterness/Recipes/Order Labs

Order Labs (MCP)

Full purchase-to-results flow via MCP tools.


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.

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

Step 3 — pay

An app connected by signing in (Claude, ChatGPT) skips to If no saved cards: it gets only the checkout link.

  1. listSavedPaymentMethods() — check for saved cards

If saved cards exist:

  1. Show available cards (brand, last 4) and ask which to use
  2. purchaseLabTest(labTestObjectKey, paymentMethodExternalId) — nothing is charged yet: returns a preview (test, price, discount, card) and a pendingId
  3. Show the preview. Only after the user says yes: confirm_action(pendingId) — charges the card and creates the order

If no saved cards:

  1. purchaseLabTestWithCheckout(labTestObjectKey, successUrl, cancelUrl) — generate Stripe Checkout link
  2. 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):

  1. getUserLabRecords() — check status
  2. If status is "Paid": initializeLabOrder(labOrderExternalId) returns a preview (the test and the personal details the lab receives) and a pendingId; after the user approves, confirm_action(pendingId) sends it. Requires complete profile.

Step 5 — schedule blood draw

  1. Ask the user for ZIP code (or use home address)
  2. searchLabServiceCenters(zipCode, labOrderExternalId) — show nearby labs
  3. User picks a lab → ask for date / time preference
  4. getServiceCenterSlots(siteCode, labOrderExternalId, timezone, startDate, rangeDays) — show options. Let the user choose — don't pick automatically.
  5. User picks a slot → bookLabAppointment(labOrderExternalId, bookingKey, timezone) returns a preview (test, date, time, place) and a pendingId. A bookingKey is valid for 30 minutes.
  6. Only after the user says yes: confirm_action(pendingId) books it

Step 6 — manage appointment

  • Reschedule (only while status is "Appointment Scheduled"): getServiceCenterSlots for new options → rescheduleLabAppointment(labOrderExternalId, newBookingKey, timezone) returns a preview of the current and the new appointment → confirm_action(pendingId) after the user says yes. The old appointment is cancelled.
  • Cancel: call cancelLabAppointment(labOrderExternalId) without a reason → show the reasons → call again with the chosen reasonId for a preview → confirm_action(pendingId) after the user says yes
  • 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":

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

Status reference

StatusNext step
PaidComplete profile, then initializeLabOrder
Order SubmittedWait — no action needed
Requisition CreatedSearch for labs and book
Appointment ScheduledVisit at the scheduled time. Can reschedule/cancel.
Appointment CancelledbookLabAppointment for a new appointment
Redraw AvailableSchedule a new appointment for the redraw
Partial ResultsView available, wait for the rest
CompletedView with searchBiomarkers and getBiologicalAge
FailedContact support or reorder

Every order from getUserLabRecords includes statusDescription and nextStep fields. Use nextStep as your primary guide. get_updates reports orders whose status changed since the last call.

If confirm_action answers stale

The price or the appointment changed after the preview. Prepare the action again and show the new preview. See Confirming actions.

PreviousHealth OverviewNextUpload Lab Results
Betterness

Product

  • How it works
  • Bett-i
  • Connect your AI

Resources

  • Tutorials
  • Podcast

Company

  • About
  • News
  • Contact

Legal

  • Privacy
  • Terms
  • Health data
  • Delete your account

For businesses

  • Betterness One ↗, opens Betterness One in a new tab

News from Betterness: the Friday Letter, launches and stories, by email.

  • Instagram ↗, opens in a new tab
  • X ↗, opens in a new tab
  • YouTube ↗, opens in a new tab
  • LinkedIn ↗, opens in a new tab
Download on the App StoreGet it on Google Play
HIPAA, powered by Vanta

HIPAA compliance monitored by Vanta.

Betterness, Inc. · Betterness gives health information, not medical advice.