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 Betterness One

Recipes

  • Performance Review
  • Publish an Instagram Post

Tools

  • All Tools
  • Workspace
  • Insights
  • Content
  • Calendar
  • Members
  • Space
  • Perks
Docs/Betterness One/Tools/All Tools

All Betterness One Tools

The complete catalog of https://api.betterness.one/mcp, grouped by domain.


Discovery

The v2 default catalog has 49 tools. Availability depends on the deployed release: tools/list is authoritative. Five optional coaching tools are not included in this default catalog.

Your MCP client lists tools via tools/list when it connects. Every tool except list_workspaces, confirm_post and confirm_workspace_action takes a required workspaceId, from list_workspaces. Each name is exactly as the server exposes it.

Workspace

list_workspacesThe workspaces you can work in
get_workspaceThe business, its goal, team size and Instagram accounts

Workspace tools →

Insights

get_instagram_insightsInstagram overview
get_instagram_historyPosts, reels or stories with their metrics
get_instagram_audienceWho follows and when they are online
get_instagram_hashtagsHashtag results and pairs
connect_instagramConnection state and a link to connect
get_member_insightsWorkspace-wide member numbers

Insights tools →

Content

list_mediaImages and videos in the workspace Library
list_postsInstagram posts made with Quick Create
get_postOne post in full
prepare_postPreview an Instagram post (changes nothing)
prepare_post_updatePreview editing, rescheduling or retrying a post (changes nothing)
cancel_scheduled_postPreview cancelling a scheduled post (changes nothing)
confirm_postPublish, change or cancel the approved post

Content tools →

Calendar

get_calendarThe Marketing Calendar for a range
create_calendar_eventPreview creating an event
update_calendar_eventPreview moving or editing your event
delete_calendar_eventPreview deleting your event (changes nothing)
confirm_workspace_actionRun the approved Calendar, Space or Perks action

Calendar tools →

Members

list_membersMembers visible to your seat in this workspace, including unlinked contacts. Returns memberId, name when permitted and connection state. Search and paginate; assigned-only seats see only their assigned members.
get_member_profileThe workspace member record as Contacts shows it, with field-level privacy. No health data: use get_member_health for that. memberId comes from list_members.
get_member_membershipThe member’s plans, credit balances and pause policies in this workspace. Uses the same access and financial redaction as the app. Requires Contacts and Membership. memberId comes from list_members.
get_member_activityThe member’s bookings, attendance and cancellations in this workspace, paginated. Uses the same access and financial redaction as the app. Requires Contacts and Membership. memberId comes from list_members.
get_member_healthHealth the member shares with this workspace: biomarkers, metrics/workouts, goals and labs. Requires members:health and the seat’s health permission. Returns sharing reasons and a wellness note; every read is audited. MemberId comes from list_members. For wellness support, not diagnosis.

Members tools →

Space

get_spaceRead the saved Space editor, its public version, slug and check-in method. Does not initialize, repair or enrich a Space. Published Spaces may carry a separate unpublished draft. Requires Space access.
get_space_data_sharingRead the Space's live and draft data request and supported categories, without changing anything. This is the request ceiling, not any member's consent; members choose their own sharing.
update_space_contentSave specified Space content fields using the editor's validation. On a published Space, edits stay in the unpublished draft. Does not publish, change the data request or slug. Use prepare_space_publish to preview publication.
add_space_gallery_imageImport one image from the workspace Library or approved Bank source into the Space gallery. Uses the editor's ownership checks, image validation and gallery limit. On a published Space the image stays in the draft until approved publication.
set_space_check_in_methodChange how members check in: front_desk, qr, or self. This operating setting takes effect immediately, independently of the content draft. Owner/admin only; also requires permission to edit Space.
prepare_space_publishPreview publishing the saved Space draft, with before/after content and effects. Writes no Space data. Show the preview and ask for explicit approval, then use confirm_workspace_action. If the Space changes meanwhile, prepare again.
prepare_space_unpublishPreview hiding the public Space and clearing its unpublished draft. The join code stays reserved for republishing. Writes no Space data. Show the effects and ask for explicit approval, then use confirm_workspace_action.
prepare_space_discard_draftPreview dropping the Space's saved unpublished changes and returning to the public version. Nothing is discarded yet. Show the preview, ask for explicit approval, then use confirm_workspace_action.
prepare_space_data_requestPreview replacing the Space's data request. Narrowing removes member access immediately when confirmed; the editor's draft/publish rules still apply. Does not grant member consent. Show the effects, ask for explicit approval, then use confirm_workspace_action.
prepare_space_slugPreview claiming or changing the Space public slug. Owner/admin only. Checks availability but does not reserve it until confirmation. Show the address change and redirect effect, ask for explicit approval, then use confirm_workspace_action.

Space tools →

Perks

list_perksList own, shared or open partner perks, twenty per page. Pure read; does not provision a company.
get_perkRead a perk visible to this workspace. Redemption secrets remain hidden for unaccepted partner perks.
search_perk_partnersSearch active B1 workspaces eligible for perk invitations.
get_perk_partnersRead active and ended collaborators of a perk this workspace owns.
get_perk_analyticsRead the app analytics with its workspace timezone and privacy suppression. Maximum 366 days.
save_perk_draftCreate or edit a draft without publication or emails. Refuses live perks. Omitted fields and partners are preserved on edits. Supply perkId only to edit an existing draft. Use prepare_perk_publish afterwards.
duplicate_perkCopy a perk owned by this workspace into a new draft with draft partner invitations. Sends no emails and does not publish.
prepare_perk_publishPublish a saved draft with its current fields and invitations. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_perk_updateChange a live perk; omitted fields and partners are preserved. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_perk_deleteDisable a perk and remove it from every collaborating Space. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_add_partner_perkHost an eligible open partner perk for this Space members. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_perk_invitation_responseAccept or decline a pending perk invitation. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_leave_perkStop hosting a partner perk in this Space. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.
prepare_manage_perk_partnerResend or cancel an invitation, or remove a collaborating partner. Preview only, with email recipients and effects; makes no business change or email. Show the preview and obtain explicit approval, then call confirm_workspace_action. If state or recipients change, prepare again.

Perks tools →

PreviousPublish an Instagram PostNextWorkspace
Betterness

Product

  • How it works
  • Bett-i

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. Our stories use fictional people.