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/Tools/Lab Tests

Lab Tests Tools

Browse the catalog of orderable lab tests.


listAvailableLabTests

Lists lab tests purchasable in the user's confirmed US state. Lab availability and price are state-specific (NY/NJ have different catalogs than other states), so this tool requires a confirmed state and fails closed without it.

ParameterNotes
confirmedUsStateRequired. Two-letter US state code (e.g. "NY", "NJ", "FL"). The state must be confirmed with the user — never guess.
queryFree-text search by name or description
isPopular"true" or "false"
loincSlugFilter to tests including a specific marker

Fail-closed behavior

If confirmedUsState is missing or blank, the tool returns:

{
  "ok": false,
  "locationRequired": true,
  "tests": []
}

Do not retry with a guessed state. Ask the user to confirm their state, then call again.

Canonical identity

A lab's product identity is externalId + objectKey + provider + state scope + price — not its display name. Two results with the same name can be different sellable products across states or providers (e.g. a "Betterness Baseline" variant for NJ vs other states). Never dedupe by name and never assume two same-named items are interchangeable.

What you get back

Successful response:

{
  "ok": true,
  "locationRequired": false,
  "confirmedUsState": "NJ",
  "tests": [{
    "externalId": "...",
    "objectKey": "betterness-baseline-nj-bioreference",
    "name": "Betterness Baseline",
    "provider": "BioReference",
    "price": 199,
    "stateEligibility": {
      "eligible": true,
      "confirmedUsState": "NJ",
      "scope": "available_in",  // one of: "available_in" | "all_except" | "all"
      "availableIn": ["NJ"],
      "notAvailableIn": [...]
    },
    "includedBiomarkers": [{
      "name": "ApoB",
      "type": "BIOMARKER",
      "loincSlug": "apo-b"
    }]
  }]
}

Each test field:

  • objectKey — canonical identity, needed for purchaseLabTest and purchaseLabTestWithCheckout
  • externalId, name, description, provider, price, isPopular, imageUrl
  • stateEligibility — why the lab is eligible. scope values: "all" (no restrictions), "available_in" (whitelist — only listed states), "all_except" (blacklist — all except listed states)
  • includedBiomarkers — each marker has name, type (BIOMARKER or PANEL), and LOINC identifiers (loincSlug for BIOMARKER, loincSlugs for PANEL)

Pattern: gap-driven test recommendation

  1. searchBiomarkers — see what the user has
  2. getLoincCodes — find slugs for missing biomarkers
  3. Confirm the user's US state if not already known
  4. listAvailableLabTests(confirmedUsState, loincSlug) — find purchasable tests that include those slugs
  5. Recommend by objectKey, price, and full marker list. Never reference labs by name alone.
PreviousDocumentsNextLab Records
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.