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/Authentication

MCP Authentication

Sign in with your Betterness account, or use an API key.


Two ways in

MethodBest forHow
Sign in (OAuth)Claude, ChatGPT and other apps you use yourselfConnect by signing in
API key (bk_*)Scripts, cron jobs, agents that run without youThis page

Signing in uses OAuth 2.0 with PKCE. The app registers itself (Client ID Metadata Document or Dynamic Client Registration), so there is nothing to set up on your side. The token it gets works only for the server you connected, with the permissions you accepted.

Generate a key

  1. Go to /console/keys
  2. Click Create Key
  3. Name it (e.g. claude-desktop, cursor-laptop)
  4. Copy the key — it starts with bk_ and is shown once

Use it

{
  "mcpServers": {
    "betterness": {
      "url": "https://api.betterness.ai/mcp",
      "headers": {
        "Authorization": "Bearer bk_your_api_key_here"
      }
    }
  }
}

Scopes

A key can be narrowed to the same permissions an app asks for when it signs in. A key with no permissions selected holds all of them, and a key can carry an expiry date.

Rotation

Generate a new key, update your config, then revoke the old one. The two coexist briefly so you don't lose access between rotations.

What happens on a 401

CauseFix
An app you signed in with was disconnected in Connected appsConnect it again and sign in
Missing Authorization headerConfirm the JSON config has the headers block
Expired or revoked keyGenerate a new one in the Console
Wrong format (e.g. dropped Bearer)Header value must be Bearer bk_...

What happens on a 403

Authenticated but missing the tool's permission. An app connected by signing in can ask you for the missing permission and connect again. For a key, create one with that scope.

PreviousConnect with an API KeyNextFirst Tool Call
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.