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/Health Profile

Health Profile (MCP)

Discover the schema, read answers, update, reset.


Workflow

Always call getHealthProfileSchema first. Question IDs and value types are essential — types must match exactly.

  1. getHealthProfileSchema() — full schema with sections, IDs, types, examples
  2. getHealthProfile() — current answers (flat map)
  3. Combine schema labels with answer values for a human-readable summary
  4. For a single section: getHealthProfileSection(sectionAcronym)

Sections

AcronymTitle
HWPHealth and Wellness Profile
WEALHWellness Goals & Assessments
DMHMedical History
ELFEarly Life Factors
DADiets and Allergies
FHSSFamily Health
CRClinical History
WHTAdditional Preferences & Data Sharing
BSBody Snapshot
PRSUPPrescriptions & Supplements
FHISFamily History

Updating

updateHealthProfile(data) takes a JSON string with question IDs as keys and answers as values. PATCH semantics. Confirm with the user before calling.

Example shapes by type

// BOOLEAN
{"HWP_HAB_do_you_smoke_cigarettes_or_use_tobacco_products": false}

// ARRAY_STRING
{"DA_do_you_currently_follow_any_of_the_following_diets": ["Vegan", "Gluten-Free"]}

// BOOLEAN_KEY_VALUE_LIST (medications, supplements)
{
  "PRSUP_do_you_take_any_prescription_medications": {
    "boolean": true,
    "keyValueList": [
      {"name": "Metformin", "value": "500mg"},
      {"name": "Lisinopril", "value": "10mg"}
    ]
  }
}

// Array of objects (family members)
{"FHIS_siblings": [
  {"id": "1", "relationship": "Brother", "name": "Carlos", "sex": "Male",
   "livingStatus": "Living", "healthConditionsStatus": "Known",
   "healthConditions": ["Diabetes"]}
]}

Resetting

resetHealthProfileSection(sectionAcronym) clears every answer in a section. Destructive — confirm with the user.

Common errors

ErrorCause
invalidFields array in responseUnknown question ID — re-check schema
Type mismatchValue shape doesn't match the schema's type — copy from example field
Section reset returns errorInvalid acronym — must match table above exactly
PreviousConnect WearablesNextAll Tools
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.