TrueCoach API and MCP server

• POST

  list_clients

  Your clients with client type, groups, 7, 30 and 90 day compliance rates and due date.

  read

  Returns one item per client, active clients by default. Compliance is completed against assigned exercises, as TrueCoach shows it. Due date is the date of the furthest programmed workout. Results come in pages; use the cursor for the next one.

  POST /api/v1/truecoach/list_clients

  Input

  Input: list_clients

  Parameter	Type	Description
  group	string	Only clients in this client group.
  client_type	enum	remote, dual or in_person. Default: all.
  archived	boolean	List archived clients instead of active ones. Default: false.
  limit	integer	Page size. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "clients": [
      {
        "client_id": "4821907",
        "name": "Sam Rivera",
        "client_type": "remote",
        "groups": [
          "Bootcamp"
        ],
        "compliance_7d": 50,
        "compliance_30d": 82,
        "compliance_90d": 88,
        "due_date": "2026-10-18"
      },
      {
        "client_id": "4821955",
        "name": "Alex Kim",
        "client_type": "dual",
        "groups": [
          "Bootcamp",
          "January"
        ],
        "compliance_7d": 100,
        "compliance_30d": 95,
        "compliance_90d": 91,
        "due_date": "2026-11-02"
      }
    ],
    "next_cursor": null
  }

• POST

  get_client

  One client: profile, client type, groups, compliance rates, due date and assigned programs.

  read

  Returns the profile fields TrueCoach holds for the client, the three compliance rates and the programs assigned to them. In-Person clients have no client account, so they have no login. Archived clients can be read too.

  POST /api/v1/truecoach/get_client

  Input

  Input: get_client

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.

  Example response

  {
    "client_id": "4821907",
    "name": "Sam Rivera",
    "email": "sam.rivera@example.com",
    "client_type": "remote",
    "groups": [
      "Bootcamp"
    ],
    "compliance_7d": 50,
    "compliance_30d": 82,
    "compliance_90d": 88,
    "due_date": "2026-10-18",
    "programs": [
      {
        "program_id": "30517",
        "name": "12 Week Hypertrophy"
      }
    ]
  }

• POST

  get_dashboard

  Your overall compliance rate, clients under Needs Attention and clients due soon.

  read

  Returns what the TrueCoach dashboard shows. Needs Attention lists clients whose compliance rate dropped suddenly in a period. Due soon uses the threshold set in your TrueCoach settings.

  POST /api/v1/truecoach/get_dashboard

  Input

  No parameters.

  Example response

  {
    "overall_compliance": 84,
    "needs_attention": [
      {
        "client_id": "4821907",
        "name": "Sam Rivera",
        "period": "7d",
        "compliance": 50
      }
    ],
    "due_soon": [
      {
        "client_id": "4821907",
        "name": "Sam Rivera",
        "due_date": "2026-10-18"
      }
    ]
  }

• POST

  list_workouts

  Workouts on a client's workout calendar in a date range, with status.

  read

  Returns workouts oldest first with date, title and status. A day can hold more than one workout. Use get_workout for the exercises and logged results.

  POST /api/v1/truecoach/list_workouts

  Input

  Input: list_workouts

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  from required	date	First day of the range.
  to required	date	Last day of the range.
  status	enum	all, completed, missed or upcoming. Default: all.

  Example response

  {
    "workouts": [
      {
        "workout_id": "91374520",
        "date": "2026-10-08",
        "title": "Upper body A",
        "status": "completed"
      },
      {
        "workout_id": "91374611",
        "date": "2026-10-10",
        "title": "Lower body B",
        "status": "missed"
      }
    ]
  }

• POST

  get_workout

  Full workout: title, warmup, exercises and circuits, cooldown, and the results the client logged.

  read

  Returns the parts in the order the client sees them. Results are what the client entered; for In-Person clients, the coach entered them. A missed workout has no results.

  POST /api/v1/truecoach/get_workout

  Input

  Input: get_workout

  Parameter	Type	Description
  workout_id required	string	Workout ID from list_workouts.

  Example response

  {
    "workout_id": "91374520",
    "client_id": "4821907",
    "date": "2026-10-08",
    "title": "Upper body A",
    "status": "completed",
    "warmup": "5 min row, band pull-aparts",
    "items": [
      {
        "type": "exercise",
        "name": "Bench Press",
        "description": "4 sets of 6, rest 2 min",
        "results": "4x6 at 80 kg"
      },
      {
        "type": "exercise",
        "name": "Pull-up",
        "description": "3 sets to near failure",
        "results": "8, 7, 6"
      }
    ],
    "cooldown": "5 min easy walk"
  }

• POST

  list_programs

  Programs in your account with tags and the clients they are assigned to.

  read

  Returns your programs, filtered by program tag if you give one. On Team Accounts, private programs are visible only to coaches with admin privileges.

  POST /api/v1/truecoach/list_programs

  Input

  Input: list_programs

  Parameter	Type	Description
  tag	string	Only programs with this program tag.

  Example response

  {
    "programs": [
      {
        "program_id": "30517",
        "name": "12 Week Hypertrophy",
        "tags": [
          "strength"
        ],
        "weeks": 12,
        "assigned_clients": 6
      },
      {
        "program_id": "30644",
        "name": "Bootcamp Base",
        "tags": [
          "group"
        ],
        "weeks": 4,
        "assigned_clients": 11
      }
    ]
  }

• POST

  list_metrics

  A client's metrics (for example back squat or body fat %) with their values over time.

  read

  Returns the metrics assigned to the client, grouped as in the Metric Manager, with each recorded value and date, newest first. Metrics linked to a workout exercise update when the client logs a result.

  POST /api/v1/truecoach/list_metrics

  Input

  Input: list_metrics

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.

  Example response

  {
    "client_id": "4821907",
    "metrics": [
      {
        "name": "Back Squat",
        "unit": "kg",
        "values": [
          {
            "date": "2026-10-08",
            "value": "110"
          },
          {
            "date": "2026-09-10",
            "value": "105"
          }
        ]
      }
    ]
  }

• POST

  list_messages

  Recent messages in your conversation with a client, newest first.

  read

  Returns text messages with sender and time. Reading does not mark anything as sent or change the conversation.

  POST /api/v1/truecoach/list_messages

  Input

  Input: list_messages

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  limit	integer	Number of messages. Default: 30.

  Example response

  {
    "client_id": "4821907",
    "messages": [
      {
        "sender": "client",
        "sent_at": "2026-10-10T18:42:00+02:00",
        "body": "Sorry, travelling this week."
      },
      {
        "sender": "coach",
        "sent_at": "2026-10-08T09:10:00+02:00",
        "body": "Great session yesterday."
      }
    ]
  }

• POST

  create_client

  Add a client. Remote and Dual clients get the TrueCoach invitation email right away.

  asks first write

  Creates the client in your list. First and last name are required; email is required for remote and dual clients. In-Person clients get no invitation and no account. A client who already has a TrueCoach account under another coach cannot be added with the same email. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/truecoach/create_client

  Input

  Input: create_client

  Parameter	Type	Description
  first_name required	string	First name.
  last_name required	string	Last name.
  email	string	Required for remote and dual clients.
  client_type	enum	remote, dual or in_person. Default: remote.

  Example response

  {
    "client_id": "4822040",
    "name": "Maya Okafor",
    "client_type": "remote",
    "invitation_sent": true
  }

• POST

  create_workout

  Write a workout on a client's workout calendar for a given day.

  write

  Adds the workout to the calendar and returns its ID. Warmup and cooldown are free text. Sets, reps, tempo and rest go in each exercise description. Exercise names come from the TrueCoach library. It does not ask for your OK: the client sees the workout on their calendar, but you can edit or delete it in TrueCoach.

  POST /api/v1/truecoach/create_workout

  Input

  Input: create_workout

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  date required	date	Day on the workout calendar.
  title	string	Workout title the client sees.
  warmup	string	Warmup text, shown as written.
  items required	object	Ordered list of exercises (name, description, optional superset link) and circuits (description).
  cooldown	string	Cooldown text, shown as written.

  Example response

  {
    "workout_id": "91374700",
    "client_id": "4821907",
    "date": "2026-10-15",
    "title": "Lower body A",
    "status": "upcoming",
    "items": 3,
    "due_date": "2026-10-18"
  }

• POST

  assign_program

  Put a program on the workout calendars of clients or client groups.

  write

  Assigns from the start date on the program day you choose. Completed and missed workouts are never touched. Later edits to the program reach clients only if Sync is on for that program in TrueCoach. It does not ask for your OK, because unassign_program undoes it.

  POST /api/v1/truecoach/assign_program

  Input

  Input: assign_program

  Parameter	Type	Description
  program_id required	string	Program ID from list_programs.
  client_ids	string[]	Clients to assign. Give this or group_names.
  group_names	string[]	Client groups to assign.
  start_date required	date	Calendar date of the first workout.
  start_day	integer	Program day to start on. Default: 1.

  Example response

  {
    "program_id": "30517",
    "assigned_clients": 6,
    "start_date": "2026-10-19",
    "start_day": 1
  }

• POST

  unassign_program

  Remove a program from a client's calendar. Completed and missed workouts stay.

  write

  Removes the upcoming workouts of the program from the client calendar. It reaches no one and a new assign_program restores it, so it does not ask for your OK.

  POST /api/v1/truecoach/unassign_program

  Input

  Input: unassign_program

  Parameter	Type	Description
  program_id required	string	Program ID from list_programs.
  client_id required	string	Client ID from list_clients.

  Example response

  {
    "program_id": "30517",
    "client_id": "4821907",
    "unassigned": true
  }

• POST

  add_client_to_group

  Add a client to one of your client groups. A client can be in several groups.

  write

  Adds the group to the client and keeps their other groups. The group must exist in Manage Groups. It reaches no one, and removing the client from the group in TrueCoach undoes it, so it does not ask for your OK.

  POST /api/v1/truecoach/add_client_to_group

  Input

  Input: add_client_to_group

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  group_name required	string	Client group name.

  Example response

  {
    "client_id": "4822040",
    "groups": [
      "January"
    ]
  }

• POST

  update_metric

  Record a new value for one of a client's metrics.

  write

  Updates the metric as a coach would in the Metric Manager on the client calendar. The metric must already be assigned to the client. It does not ask for your OK; clients can see their own metrics.

  POST /api/v1/truecoach/update_metric

  Input

  Input: update_metric

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  metric required	string	Metric name from list_metrics.
  value required	string	New value, in the metric's unit.
  date	date	Date of the measurement. Default: today.

  Example response

  {
    "client_id": "4821907",
    "metric": "Back Squat",
    "value": "112.5",
    "date": "2026-10-11"
  }

• POST

  send_message

  Message a client or every client in a group, as you.

  asks first write

  A message to a group reaches each client individually, as in TrueCoach. Clients who are not logged in to TrueCoach get the message text by email. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/truecoach/send_message

  Input

  Input: send_message

  Parameter	Type	Description
  client_id	string	One client. Give this or group_name.
  group_name	string	Each client in the group gets the message individually.
  body required	string	Message text.

  Example response

  {
    "sent": 1,
    "client_id": "4821907",
    "sent_at": "2026-10-11T09:30:00+02:00"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.