Skip to content
On this page

Tool catalog

Every TrainHeroic MCP tool, grouped by role and task.

The model chooses these tools from your request. Your MCP client shows each tool’s full input schema before it runs.

Coach tools

Available to coach accounts on the main hosted endpoint and from the local coach server.

Account & roster

Tool What it does
whoami Your coach profile and roles
head_coach Head coach profile for your organization
list_athletes Everyone on your org roster
list_teams Teams you coach
get_team One team with athletes and program
list_programs Standalone coach programs
get_program Program detail by id
notifications Unread notifications
analytics_categories Analytics metric categories
roster_activity Recent training activity across the roster
athlete_training Filterable athlete training history
athlete_lift_history Lift history for one athlete
team_volume Volume totals for a team

Workouts & sessions

Tool What it does
workout_build Program a session from blocks
workout_read Read a programmed workout
workout_publish Publish a draft to athletes
session_remove Remove a session from a program
session_unpublish Unpublish a live session
session_copy Copy a session to another date
session_save_as_template Save a session as a template

Exercise library

Tool What it does
exercise_resolve Map a name to one exercise id
exercise_search Fuzzy search the library
exercise_get Full exercise by id
exercise_sync Refresh the cached library
exercise_create Create a custom exercise
exercise_forget Remove a custom exercise from the cache
store_stats Library cache stats

Athlete management

Tool What it does
athlete_invite Invite an athlete to your org
athlete_archive Archive an athlete
athlete_restore Restore an archived athlete
athlete_saved_workouts Saved workouts for an athlete
log_athlete_set Log a set for an athlete
coach_log_session Log a full session for an athlete
swap_athlete_exercise Swap an exercise in a session
prescribe_athlete_set Override prescribed sets

Teams & codes

Tool What it does
team_create Create a team
team_update Rename a team or reassign its calendar
team_delete Delete a team
team_code_create Create a join code
team_code_delete Delete a join code
list_team_codes Join codes for a team

Messaging & analytics

Tool What it does
messaging_conversations Message streams and teams
messaging_read Read a conversation
message_draft Draft a message
message_send Send a message
message_delete Delete a message
analytics_query Query readiness, volume, and more
athlete_main_lift_prs Main-lift PRs for one athlete
roster_main_lift_prs Main-lift PRs across the roster

Athlete tools

Available to every account on the main hosted endpoint and from both local servers.

Profile & history

Tool What it does
athlete_whoami Your athlete profile
athlete_profile Training profile summary
athlete_prefs Notification and display prefs
athlete_working_maxes Working maxes by lift
athlete_leaderboard Leaderboard standings
athlete_workouts Upcoming and recent workouts
athlete_exercises Search your exercise history
athlete_exercise_history History for one exercise
athlete_personal_records PRs for one exercise
athlete_exercise_stats Stats for one exercise
athlete_log_targets What to log today

Logging

Tool What it does
athlete_session_create Create a training session
athlete_session_add_exercises Add exercises to a session
athlete_session_remove Remove a session
athlete_log_session Log a full session
athlete_log_set Log one set
athlete_swap_exercise Swap an exercise in a scheduled workout

Hosted-only tools

These use the hosted server’s D1 warehouse or feedback service.

Tool What it does
report_feedback Report a bug or send feedback to the maintainers
programming_sync Sync prescribed programming history into D1
programming_stored Query synced programming history
messaging_sync Sync message history into D1
messaging_stored Query synced message history
athlete_workouts_sync Sync workout history into D1
athlete_workouts_stored Query synced workout history
athlete_training_sync Sync exercise history and PRs into D1
athlete_training_stored Query synced exercise history and PRs

Was this page helpful?