@trainheroic-unofficial/athlete-mcp

Populate the programming history warehouse: pull prescribed programs

Query the prescribed-programming history warehouse (populate it with programming_sync first).

Populate the messaging history warehouse: pull chat streams + comments into D1,

Query the conversation history warehouse (populate it with messaging_sync first). Give

Populate the workouts warehouse: pull workouts in a YYYY-MM-DD window into D1 (each

Query the workouts warehouse (populate it with athlete_workouts_sync first). Give

Populate the training warehouse: the exercise catalog, working maxes, and per-exercise

Query the training warehouse (populate it with athlete_training_sync first).

Create either an ongoing calendar or a fixed-length standalone program

Delete a standalone calendar or fixed program (DELETE /v5/programs/{programId}).

Build an UNPUBLISHED session from a spec (program -> session -> blocks -> exercises).

Read-back a session by programId, date (YYYY-M-D), and programWorkout id.

Publish a built session — ATHLETE-FACING and immediate. Requires confirmation

Delete a session from the live calendar (also the way to replace a date: remove then

Unpublish a previously published session (POST .../programWorkout/unPublish/{pwId}). It

Copy/repeat a session to a target date on a program (POST .../copyProgramWorkout).

Save an existing session as a reusable template in the session library

Create an empty reusable session template in the library (POST /v5/sessions/template).

Delete a library session template (DELETE /v5/sessions/template/{id}). Requires

The authenticated TrainHeroic coach profile (id, org_id, name, roles, trial days).

Every athlete on this coach's org roster, across all teams (not scoped to one team; the

Coach teams. The headcount fields are easy to misread: member_count and athlete_count

Full team object by team id.

Join/access codes for a team.

Program detail live from the API, by program id. Works for team calendars and athlete

Program detail live from the API, by program id. Works for team calendars and athlete

Program detail live from the API, by program id. Works for team calendars and athlete

Program detail live from the API, by program id. Works for team calendars and athlete

Team-wide training volume (and reps/sessions) scoped to an inclusive YYYY-MM-DD window —

Companion calendar for a roster athlete (GET /v5/calendars/athletes/{id}/coachAthleteTeam).

Create a team (POST /1.0/coach/team/createWithTitleAndCode). Also creates the team's

Update a team's title and/or reassign its calendar (PUT /v5/teams/{teamId}).

Delete a team (DELETE /v5/teams/{teamId}). Removes the team and its calendar from the

Create an access code athletes use to self-join a team

Delete a team access code by its id (DELETE /v5/teamCodes/{codeId}). Athletes can no

Update a team's auto-publish settings (POST /1.0/coach/team/updatePublishSettings).

List chat streams (id, kind, title) live from the API; no setup needed. Use the id to read/draft/send.

Comments in a stream, live from the API. Pass `afterCommentId` to fetch only newer

Preview the exact payload and target WITHOUT sending. Always safe.

Send a chat message — ATHLETE-FACING and immediate (no draft state on the server).

Soft-delete a chat message on the live account. Requires confirmation.

The logged-in account's identity (id, name, roles) from /user/simple.

Lifetime training totals in one call — all-time session count (summary.sessions_count),

Notification and display preference flags for the athlete account.

The athlete's working max per exercise (drives % prescriptions). An entry can carry a

Leaderboard for a benchmark/test workout by its workout id.

The all-time PR board for an exercise (reps/weight per rep-max, strength-standard

The all-time PR board for an exercise (reps/weight per rep-max, strength-standard

The all-time PR board for an exercise (reps/weight per rep-max, strength-standard

The all-time PR board for an exercise (reps/weight per rep-max, strength-standard

A point-in-time snapshot for an exercise: last performance and PR as of a date

Create a new personal workout session for a given YYYY-MM-DD date on the athlete's

Create a new personal workout session for a given YYYY-MM-DD date on the athlete's

Add one or more exercises to a personal workout session. Get workoutId from

Delete a personal (self-created) workout session from your calendar — use it to clean up a

Athlete-facing write: set the free-text note (and/or session RPE 1–10) on a workout.

Athlete-facing write: set the free-text note on one exercise in a workout (the

Athlete-facing write for logging what you actually did, with NO coach-scheduled workout

Athlete-facing write: record entered results (reps/weight per set) for a saved workout

Athlete-facing write: set the planned reps and/or weight for one of your scheduled

Athlete-facing write: substitute one prescribed exercise in your scheduled workout for a

Named circuit history for the logged-in athlete (GET /v5/users/circuits/{recent|history}).

Programs the athlete is subscribed to (GET /1.0/athlete/programming/programs).

Recently used exercises (GET /v5/users/exercises/recent). Distinct from

Update a custom exercise (POST /2.0/coach/exercise/update/{id}) and write it through

Delete a custom exercise on TrainHeroic (DELETE /v5/exercises/{id}) and drop it from

Map a name to an exercise id via the local mirror. Prefer this over exercise_search when

Ranked fuzzy search over exercise titles. Returns candidates with units. Each result's

Full exercise object (with units) by id.

Refresh the cached exercise index from TrainHeroic.

Create a custom exercise (POST /2.0/coach/exercise/create) and write it through to the

Remove an exercise from the local mirror only. Does not call TrainHeroic — use

Row counts and sync state for the cached exercise index.

Add athletes by emailing them a TrainHeroic team invitation — this is how you

Remove one or more athletes from the active roster (PUT /v5/athletes/archive). Their

Restore previously archived athletes to the active roster (PUT /v5/athletes/restore).

A roster athlete's scheduled/logged workouts in an inclusive YYYY-MM-DD window. This is the

Coach-facing write: record entered results (reps/weight per set) for one of a roster

Coach-facing write: log results for a roster athlete by exercise on a given day, without

Coach-facing write: replace one exercise in a roster athlete's scheduled workout with a

Coach-facing write: set the prescribed reps and/or weight for one of a roster athlete's