Betterness
Bett-iDocsTutorialsAboutAugmented Wellness

Overview

Trust

Resources

System

Get Started

Clients

Recipes

Tools

Reference

DocsMCPRecipesHealth 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 & Wellness Profile
WEALHWellness Goals & Assessments
DMHDetailed Medical History
DADiets & Allergies
FHSSFamily Health & Safety Screening
WHTWearables & Health Tracking
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
Connect WearablesKnowledge Search
© 2026 Betterness Inc.
Privacy PolicyTerms of ServiceHealth Data