Workout of the Day - FITsociety Developer APIs

The wod company module manages scheduled Workouts of the Day and exposes verified leaderboard results. Runtime authorization applies WOD feature, company-role, RBAC permission, publication, and settings checks for each action.

Key	Value
Module key	`wod`
Sensitivity	`health`
Consent required	`healthDataConsent`
Feature requirement	WOD enabled for operational WOD reads and mutations

Read tools

`get_wod_settings`

Returns WOD feature, visibility, notification, publication, approval, and score verification settings without creating or changing a settings record.

`list_wods`

Lists company WODs. Optional fields are status (draft, published, or archived), dateFrom, dateTo, page, and limit. Dates use YYYY-MM-DD, the range cannot exceed 366 days, and the page limit is 50.

`get_wod`

Returns one company-scoped WOD and its bounded workout prescription. Requires wodId.

`get_todays_wod`

Returns today’s published WOD using the connected company’s configured timezone. This tool takes no arguments.

`get_wod_by_date`

Returns the published WOD for one canonical date. Requires date in YYYY-MM-DD format.

`get_wod_leaderboard`

Returns a bounded page of verified leaderboard results. Requires wodId; page and limit are optional, with a maximum limit of 50.

Write tools

All write tools require explicit grant approval and params._meta.idempotencyKey. See Connection & Protocol for the durable replay contract. Publish and archive permissions are separate from create and update permissions.

`create_wod` [Write]

Creates a draft WOD from an existing company workout template and plan moment. Requires planId, planMomentId, and scheduledDate. Optional fields include localized title and description, scoring, target, divisions, and score validation. Publishing requires a separate publish_wod call.

`create_custom_wod` [Write]

Creates a custom draft WOD and backing workout plan after validating every exercise. Requires scheduledDate, localized title, and one to 50 exercises; localized description, scoring type, and target are optional.

`update_wod` [Write]

Updates WOD content without changing publication state. Requires wodId; template references, schedule, localized content, scoring, divisions, score validation, and exercises are optional updates.

`publish_wod` [Write]

Publishes a draft or archived WOD when coach access, company settings, and WOD publish permission allow it. Requires wodId.

`archive_wod` [Write]

Removes a WOD from active publication while retaining it for later republishing. Requires wodId and is marked destructive in its MCP annotations.

`update_wod_settings` [Write]

Updates one or more WOD settings: enabled, defaultVisibility, allowClientOptOut, autoNotifyOnPublish, scheduledNotificationTime, coachCanPublish, requireApprovalByAdmin, and scoreVerificationRequired.

Example

{
  "jsonrpc": "2.0",
  "id": "wod-1",
  "method": "tools/call",
  "params": {
    "name": "get_wod_by_date",
    "arguments": {
      "date": "2026-08-10"
    }
  }
}

​Read tools

​get_wod_settings

​list_wods

​get_wod

​get_todays_wod

​get_wod_by_date

​get_wod_leaderboard

​Write tools

​create_wod [Write]

​create_custom_wod [Write]

​update_wod [Write]

​publish_wod [Write]

​archive_wod [Write]

​update_wod_settings [Write]

​Example