Model Context Protocol

Build anything with your health data.

The first health & wellness platform with a native MCP server. Connect your wearables, biomarkers, and labs to ChatGPT, Claude, Cursor, or any AI — then build the health tools only you can imagine.

26 tools
7 device integrations
HIPAA secure
Lab ordering built-in

What Can You Build?

Real use cases people are building today with the Betterness MCP. No PhD required.

No code needed

Personal Running Coach

AI coach that knows your VO2 max, resting HR, sleep quality, and recovery. Adjusts training based on real biometrics from your wearables.

getActivityDatagetVitalsgetSleepData

Athletes

No code needed

Longevity Dashboard

Track biological age over time, get alerts when biomarkers drift, know which labs to order next.

getBiologicalAgesearchBiomarkerslistAvailableLabTests

Biohackers

No code needed

Sleep Optimizer

Analyze sleep stages from Oura or Apple Watch, correlate with daytime HRV, get personalized deep sleep recommendations.

getSleepDatagetSleepStagesgetVitals

Anyone

Developer

Client Wellness Portal

Coaches & clinics: pull real-time wearable data and lab results for clients, automate progress reports, flag concerns.

getUserLabDatasearchBiomarkersgetActivityData

Coaches / Clinics

Beginner

Nutrition & Recovery Advisor

Connect body composition with workout history and biomarkers for evidence-based nutrition guidance.

getBodyCompositiongetActivityDatasearchBiomarkers

Fitness

No code needed

Vibe-Code Your Own

Open ChatGPT or Claude, describe what you want, paste your API key. Your personal health agent comes alive. No programming required.

All 26 tools

Everyone

How It Works

From zero to health-aware AI in under 2 minutes.

1

Create Account

Sign up free and connect your wearables — Apple Health, Oura, Garmin, and more.

2

Get API Key

Generate a key from your dashboard in one click. It starts working immediately.

3

Connect Your AI

Paste the config into ChatGPT, Claude, Cursor, or any MCP-compatible tool.

Try It

See what MCP-powered health data looks like — no sign-up required.

Example Conversations

What it feels like to talk to an AI with your health data connected.

You

How has my sleep been this week?

AI
getSleepData

Let me pull your sleep data from the last 7 days...

AI

You averaged 6h 42m of sleep this week, down from 7h 15m last week. Your deep sleep dropped to 48 minutes on Tuesday and Wednesday — coinciding with late workouts. REM was strongest on nights you were in bed before 10:30 PM. Consider an earlier wind-down routine.

Sample Health Data

What the raw MCP tool responses look like.

getActivityData()— sample response
activityData:
  date: "2026-03-05"
  steps: 12847
  distance_km: 9.3
  calories_burned: 2410
  vo2_max: 48.2
  floors_climbed: 14
  workouts:
    - type: "Running"
      duration_min: 42
      avg_hr: 156
      calories: 485
      distance_km: 6.8

Platform Setup Guides

Connect Betterness MCP to your favorite AI platform.

Your Health Data Stack

Comprehensive health and wellness data, device management, and lab ordering.

Activity & Workouts

Steps, calories, distance, VO2 max, workout history from all connected devices

Sleep Architecture

Nightly summaries and minute-by-minute sleep stage transitions (Deep, REM, Core, Awake)

Vital Signs

Heart rate, HRV, blood pressure, SpO2, glucose, respiratory rate

Biomarkers & Labs

Lab results with reference ranges, LOINC codes, and biological age assessments

Body Composition

Weight, body fat %, muscle mass, BMI, visceral fat, and bone mass trends

Lab Ordering

Browse tests, order with saved cards or Stripe checkout, schedule blood draws, track results

Connected Devices

Pull data from any wearable or health platform.

Apple Health
Garmin
Oura
Peloton
Wahoo
Eight Sleep
Withings

26 Tools Available

Health data, device management, biomarkers, lab ordering, payments, and appointment management.

Common Flows

Step-by-step tutorials for the most frequent agent use cases.

🩺

"How am I doing?" — Health Overview

  1. 1
    getUserContactData()— Identify the user
  2. 2
    listConnectedDevices()— See what data sources are available
  3. 3
    getVitals / getSleepData / getActivityData— Pull data from connected wearables
  4. 4
    searchBiomarkers()— Check recent lab results
  5. 5
    getBiologicalAge()— Summarize with biological age trend

Correlate poor sleep with elevated resting heart rate, or reference biomarker trends alongside activity levels.

🧪

"What labs should I get?" — Gap Analysis

  1. 1
    searchBiomarkers()— Check what the user has recent results for
  2. 2
    getLoincCodes()— Look up LOINC codes for specific biomarkers if needed
  3. 3
    listAvailableLabTests()— Find tests covering the identified gaps

Identify gaps (e.g. no recent Vitamin D, thyroid, or lipid panel) and present test name, price, and included biomarkers.

🔬

"Buy a Lab Test" — Full 7-Step Lifecycle

  1. 1
    getUserContactData() → updateUserContactData()— 1. Ensure profile complete (gender, phone, birthdate, address)
  2. 2
    listAvailableLabTests()— 2. Browse and confirm the desired test
  3. 3
    listSavedPaymentMethods() → purchaseLabTest() or purchaseLabTestWithCheckout()— 3. Pay with saved card or Stripe checkout
  4. 4
    getUserLabData() → initializeLabOrder()— 4. Initialize if status is "Paid"
  5. 5
    searchLabServiceCenters() → getServiceCenterSlots() → bookLabAppointment()— 5. Find center, pick slot, book appointment
  6. 6
    rescheduleLabAppointment() / cancelLabAppointment()— 6. Manage — reschedule or cancel if needed
  7. 7
    searchBiomarkers() + getBiologicalAge()— 7. View results once status is "Completed"

Each order from getUserLabData includes statusDescription and nextStep — use them as your primary guide through the lifecycle.

⌚

"Connect My Wearable" — Device Integration

  1. 1
    listConnectedDevices()— See what's already connected
  2. 2
    getAvailableIntegrations()— Show what the user can still connect
  3. 3
    generateUserLinkToken(integrationKey, redirectUrl)— Generate the connection link
  4. 4
    disconnectIntegration(integrationKey)— Remove a connection when needed

The generateUserLinkToken response contains a linkWebUrl field — this is the URL the user must open in their browser to authorize the device connection. Always use this exact URL (do not construct your own). Apple Health requires the Betterness mobile app instead.

📋

"Check My Orders" — Order Status

  1. 1
    getUserLabData()— Unified view of all lab orders and uploaded results
  2. 2
    nextStep field— Follow the nextStep guidance on each order
  3. 3
    initializeLabOrder()— If status is "Paid" and profile is complete
  4. 4
    searchBiomarkers()— View results once status is "Completed"

Every order returned by getUserLabData includes statusDescription and nextStep — use them as your primary guide.

Common Pitfalls

Quick fixes for the most frequent integration issues.

Getting 400 or 405 errors?

You need the 3-step session handshake. The MCP server requires: (1) initialize, (2) notifications/initialized, (3) tools/call — in that order. You cannot skip straight to calling tools. Save the Mcp-Session-Id header from the initialize response and include it on every subsequent request.

Empty or unparseable responses?

MCP responses use Server-Sent Events (SSE) format, not plain JSON. The body contains lines like "event: message" and "data: {...}". You need to parse the "data:" line to extract the JSON-RPC result. Also ensure you send the header Accept: application/json, text/event-stream on every request.

Device connection not working?

Make sure you are using the linkWebUrl field returned by generateUserLinkToken — this is a one-time authorization URL the user must open in their browser. Do not construct your own URL. If the URL has expired, call generateUserLinkToken again to get a fresh one.

Lab test purchase failing?

The user profile must have gender, phone, birthdate, and a complete home address before purchasing. Call getUserContactData to check, then updateUserContactData to fill in any missing fields. Also confirm the user has a saved payment method via listSavedPaymentMethods, or use purchaseLabTestWithCheckout for Stripe-hosted checkout.

Session expired or "invalid session"?

MCP sessions can expire. If you get a session error, run the 3-step handshake again (initialize → notifications/initialized) to establish a new session before retrying your tool call.

Security & Trust

Your health data deserves the highest standard of protection.

HIPAA Compliant

Enterprise infrastructure built to healthcare compliance standards.

End-to-End Encryption

TLS 1.3 in transit, AES-256 at rest. Your data is always encrypted.

OAuth 2.0 via Auth0

Industry-standard authentication. No passwords stored on our servers.

Revocable API Keys

Generate and revoke keys instantly. Full control over access.

Your Data, Your Control

Your health data is never shared, sold, or used for advertising.

The future of health is agentic

Your wearables, your biomarkers, your labs — connected to any AI. Build something only you can imagine.