Tools & Modules Registry - FITsociety Developer APIs

FITsociety MCP exposes 33 modules, 145 tools, and 51 write tools from the backend declarative registry. The registry has two subject surfaces:

Company/coach tools are approved by a Manager or Admin coach and operate on company-scoped client, calendar, finance, health, messaging, and nutrition data.
Client AI tools are approved by the client and operate only on that client’s own records in the active company context. The client must be connected to the company, have client AI access enabled, and the company MCP integration feature must be enabled.

Both surfaces use the same remote MCP endpoint:

https://mcp.fitsociety.io/mcp/v1

Module Registry

Module Key	Title	Subject	Sensitivity	Consent Required	Tools	Write Tools
`clients`	Clients	Company/coach	`operational`	None	4	`create_client`
`calendar_events`	Calendar events	Company/coach	`operational`	None	2	None
`bookings`	Bookings Module	Company/coach	`operational`	None	6	`update_attendance` `create_booking`
`subscriptions`	Subscriptions Module	Company/coach	`operational`	None	3	None
`credits`	Credits Module	Company/coach	`operational`	None	3	`adjust_client_credits`
`invoices`	Invoices Module	Company/coach	`operational`	None	3	None
`recurring_bookings`	Recurring Bookings Module	Company/coach	`operational`	None	1	None
`event_templates`	Event Templates Module	Company/coach	`operational`	None	2	None
`calendar_tasks`	Calendar Tasks Module	Company/coach	`operational`	None	5	`create_calendar_task` `cancel_calendar_task` `update_calendar_task`
`measurements`	Measurements	Company/coach	`health`	Health data consent	2	None
`intake`	Intake	Company/coach	`health`	Health data consent	2	None
`checkups`	Checkups	Company/coach	`health`	Health data consent	2	None
`habits`	Habits	Company/coach	`health`	Health data consent	2	None
`goals`	Goals	Company/coach	`health`	Health data consent	2	`update_client_goals`
`client_notes`	Client Notes Module	Company/coach	`private_communication`	Private communication consent	4	`create_client_note` `delete_client_note` `update_client_note`
`documents`	Documents	Company/coach	`health`	Health data consent	2	None
`chats`	Chats	Company/coach	`private_communication`	Private communication consent	2	None
`nutrition_catalog`	Nutrition catalog	Company/coach	`operational`	None	7	`create_recipe` `update_recipe` `archive_recipe`
`nutrition_plans`	Nutrition plans	Company/coach	`operational`	None	9	`create_nutrition_plan` `add_nutrition_plan_item` `materialize_nutrition_day` `update_nutrition_plan` `remove_nutrition_plan_item` `replace_nutrition_plan_item` `archive_nutrition_plan`
`nutrition_logs`	Nutrition logs	Company/coach	`health`	Health data consent	6	`log_nutrition_item` `replace_nutrition_day_item` `add_nutrition_day_item` `remove_nutrition_day_item`
`workout_v2`	Workout V2 Module	Company/coach	`health`	Health data consent	16	`assign_workout_plan` `start_workout_session` `log_workout_performance` `complete_workout_session` `update_workout_machine_preset` `update_workout_equipment_profile`
`wod`	Workout of the Day	Company/coach	`health`	Health data consent	12	`create_wod` `create_custom_wod` `update_wod` `publish_wod` `archive_wod` `update_wod_settings`
`client_ai_workout_v2`	Client AI Workout V2	Client AI	`health`	Health data consent	12	`client_ai_start_or_resume_my_workout_session` `client_ai_log_my_workout_performance` `client_ai_complete_my_workout_session`
`client_ai_wod`	Client AI WOD	Client AI	`health`	Health data consent	8	`client_ai_update_my_wod_preferences` `client_ai_start_my_wod` `client_ai_complete_my_wod`
`client_ai_nutrition`	Client AI nutrition	Client AI	`health`	Health data consent	5	`client_ai_log_my_food`
`client_ai_measurements`	Client AI measurements	Client AI	`health`	Health data consent	3	`client_ai_log_my_measurement`
`client_ai_habits`	Client AI habits	Client AI	`health`	Health data consent	3	`client_ai_check_in_my_habit`
`client_ai_goals`	Client AI goals	Client AI	`health`	Health data consent	2	`client_ai_update_my_goals`
`client_ai_bookings`	Client AI bookings	Client AI	`operational`	None	4	`client_ai_book_my_event` `client_ai_cancel_my_booking`
`client_ai_messages`	Client AI messages	Client AI	`private_communication`	Private communication consent	3	`client_ai_send_message_to_my_coach`
`client_ai_checkups`	Client AI checkups	Client AI	`health`	Health data consent	3	`client_ai_submit_my_checkup`
`client_ai_documents`	Client AI documents	Client AI	`private_communication`	Private communication consent	2	None
`client_ai_account`	Client AI account	Client AI	`operational`	None	3	None

Write Tool Registry

Write tools are hidden unless the grant is not read-only and the exact tool name is present in allowedWriteTools.

Tool	Module	Subject	Description
`create_client`	`clients`	Company/coach	Create a new client account associated with the company, or link an existing client account to the company if the email already exists.
`update_attendance`	`bookings`	Company/coach	Mark a booked client’s attendance status for a booking as attended, no-show, or unknown. Use `list_bookings` or `get_booking` first to resolve the booking ID.
`create_booking`	`bookings`	Company/coach	Book a client onto a specific calendar event. Supports product-based and free booking modes.
`adjust_client_credits`	`credits`	Company/coach	Manually adjust a client’s credit balance. Requires a reason and the target credit ID.
`create_calendar_task`	`calendar_tasks`	Company/coach	Create a new operational task for one or more coaches within the caller’s company. Recurrence, locations, and overrides are excluded in v1.
`cancel_calendar_task`	`calendar_tasks`	Company/coach	Cancel or delete a calendar task within the caller’s company.
`update_calendar_task`	`calendar_tasks`	Company/coach	Update title, notes, timing, or assigned coaches for an existing calendar task. Recurrence edits, locations, and overrides are rejected.
`update_client_goals`	`goals`	Company/coach	Update safe stored goal fields for an existing client.
`create_client_note`	`client_notes`	Company/coach	Create a new coach note or comment on a specific client’s profile.
`delete_client_note`	`client_notes`	Company/coach	Hard-delete a client note by note ID and client ID.
`update_client_note`	`client_notes`	Company/coach	Update an existing coach note’s title, text, or client visibility.
`create_recipe`	`nutrition_catalog`	Company/coach	Create a new recipe in the nutrition catalog. Supports both modern and legacy schemas based on company settings.
`update_recipe`	`nutrition_catalog`	Company/coach	Update an existing recipe in the nutrition catalog.
`archive_recipe`	`nutrition_catalog`	Company/coach	Soft-delete or archive an existing recipe in the nutrition catalog.
`create_nutrition_plan`	`nutrition_plans`	Company/coach	Create a coach-authored nutrition plan for a client.
`add_nutrition_plan_item`	`nutrition_plans`	Company/coach	Add one food product, recipe, supplement, or custom item to an existing Nutrition V2 plan slot.
`materialize_nutrition_day`	`nutrition_plans`	Company/coach	Create or refresh a concrete Nutrition V2 day for a client/date from one of the client’s plans.
`update_nutrition_plan`	`nutrition_plans`	Company/coach	Update metadata, status, date window, target macros, notes, and existing slot definitions on a Nutrition V2 plan.
`remove_nutrition_plan_item`	`nutrition_plans`	Company/coach	Remove one item from an existing Nutrition V2 plan slot.
`replace_nutrition_plan_item`	`nutrition_plans`	Company/coach	Replace one planned Nutrition V2 item with another food product, recipe, supplement, or custom item.
`archive_nutrition_plan`	`nutrition_plans`	Company/coach	Archive or soft-delete a client’s Nutrition V2 plan.
`log_nutrition_item`	`nutrition_logs`	Company/coach	Log a consumed nutrition item for a client, supporting Nutrition V2 slots and legacy V1 days.
`replace_nutrition_day_item`	`nutrition_logs`	Company/coach	Replace a planned or suggested item on a client’s concrete Nutrition V2 day slot.
`add_nutrition_day_item`	`nutrition_logs`	Company/coach	Add a planned or suggested item to a client’s concrete Nutrition V2 day slot.
`remove_nutrition_day_item`	`nutrition_logs`	Company/coach	Remove a planned or suggested item from a client’s concrete Nutrition V2 day slot.
`assign_workout_plan`	`workout_v2`	Company/coach	Assign visible days of a company Workout V2 template to one accessible client.
`start_workout_session`	`workout_v2`	Company/coach	Start or safely resume a client’s non-WOD plan-day or freestyle Workout V2 session.
`log_workout_performance`	`workout_v2`	Company/coach	Upsert logged sets for one exercise in an accessible client’s active non-WOD session.
`complete_workout_session`	`workout_v2`	Company/coach	Complete an accessible client’s non-WOD session without awarding duplicate XP on replay.
`update_workout_machine_preset`	`workout_v2`	Company/coach	Merge bounded setup-field changes into a coach- or company-scoped exercise preset.
`update_workout_equipment_profile`	`workout_v2`	Company/coach	Replace selected equipment for the company gym or one accessible client’s home.
`create_wod`	`wod`	Company/coach	Create a draft WOD from an existing company workout template and plan moment.
`create_custom_wod`	`wod`	Company/coach	Create a custom draft WOD and backing workout plan after validating every exercise.
`update_wod`	`wod`	Company/coach	Update WOD content without changing its publication state.
`publish_wod`	`wod`	Company/coach	Publish a WOD when coach access, company settings, and publish permission allow it.
`archive_wod`	`wod`	Company/coach	Archive a WOD while retaining it for later republishing.
`update_wod_settings`	`wod`	Company/coach	Update company WOD visibility, notification, publication, approval, and score-verification settings.
`client_ai_start_or_resume_my_workout_session`	`client_ai_workout_v2`	Client AI	Start or resume the authenticated client’s assigned plan-day or freestyle session; WOD and group sessions are rejected.
`client_ai_log_my_workout_performance`	`client_ai_workout_v2`	Client AI	Upsert allowlisted sets and client-owned setup values in the authenticated client’s active non-WOD, non-group session.
`client_ai_complete_my_workout_session`	`client_ai_workout_v2`	Client AI	Complete the authenticated client’s active non-WOD, non-group session through the completion and XP core.
`client_ai_update_my_wod_preferences`	`client_ai_wod`	Client AI	Update WOD participation or notifications for the authenticated client without changing company settings.
`client_ai_start_my_wod`	`client_ai_wod`	Client AI	Start a fresh published WOD session; an existing session must be resumed in the client app.
`client_ai_complete_my_wod`	`client_ai_wod`	Client AI	Complete the authenticated client’s WOD through the scoring, verification, leaderboard, and XP flow.
`client_ai_log_my_food`	`client_ai_nutrition`	Client AI	Log a consumed food item or recipe for the authenticated client.
`client_ai_log_my_measurement`	`client_ai_measurements`	Client AI	Record a new measurement entry for the authenticated client.
`client_ai_check_in_my_habit`	`client_ai_habits`	Client AI	Submit a check-in value for an already assigned habit.
`client_ai_update_my_goals`	`client_ai_goals`	Client AI	Update safe stored goals for the authenticated client.
`client_ai_book_my_event`	`client_ai_bookings`	Client AI	Book an available calendar event for the authenticated client.
`client_ai_cancel_my_booking`	`client_ai_bookings`	Client AI	Cancel a planned booking for the authenticated client, respecting cancellation rules.
`client_ai_send_message_to_my_coach`	`client_ai_messages`	Client AI	Send a text message to a coach in the active company.
`client_ai_submit_my_checkup`	`client_ai_checkups`	Client AI	Submit answers for an assigned open check-up form.

Tool Execution

Call tools through standard JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": "example-1",
  "method": "tools/call",
  "params": {
    "name": "search_clients",
    "arguments": {
      "query": "Jane"
    }
  }
}

Use tools/list after authorization to see the exact tools available for the current grant. The result is filtered by subject type, modules, consent flags, read-only state, write-tool permissions, and the relevant feature gate. Company grants require the company MCP integration feature. Client AI grants require client AI access for the connected company.

​Module Registry

​Write Tool Registry

​Tool Execution

Module Registry

Write Tool Registry

Tool Execution