trainheroic unofficial

MCP reference

Setup for MCP clients beyond Claude.ai. The home page walks through the hosted connector for claude.ai.

← Developers

Hosted endpoint

Main URL (OAuth, same as Claude.ai):

https://mcp.trainheroic-unofficial.com/mcp

Cursor or Claude Desktop config:

{
  "mcpServers": {
    "trainheroic": {
      "url": "https://mcp.trainheroic-unofficial.com/mcp"
    }
  }
}

Coach-only URL:

https://mcp.trainheroic-unofficial.com/mcp/coach

Athlete-only URL:

https://mcp.trainheroic-unofficial.com/mcp/athlete

Local coach server

Stdio on your machine. Credentials sit in the MCP client config file.

claude mcp add trainheroic \
  -e TRAINHEROIC_EMAIL=coach@example.com \
  -e TRAINHEROIC_PASSWORD=yourpassword \
  -- npx -y @trainheroic-unofficial/coach-mcp
{
  "mcpServers": {
    "trainheroic": {
      "command": "npx",
      "args": ["-y", "@trainheroic-unofficial/coach-mcp"],
      "env": {
        "TRAINHEROIC_EMAIL": "coach@example.com",
        "TRAINHEROIC_PASSWORD": "yourpassword"
      }
    }
  }
}

For Claude Code on your laptop, the skill is usually simpler than local stdio.

Local athlete server

claude mcp add trainheroic-athlete \
  -e TRAINHEROIC_EMAIL=athlete@example.com \
  -e TRAINHEROIC_PASSWORD=yourpassword \
  -- npx -y @trainheroic-unofficial/athlete-mcp

Tool list

Tool names for reference. The model picks the call from your question.

Coach tools

Coach accounts on the main URL or /mcp/coach.

Account & roster

  • whoamiYour coach profile and roles
  • head_coachHead coach profile for your organization
  • list_athletesEveryone on your org roster
  • list_teamsTeams you coach
  • get_teamOne team with athletes and program
  • list_programsStandalone coach programs
  • get_programProgram detail by id
  • notificationsUnread notifications
  • analytics_categoriesAnalytics metric categories
  • roster_activityRecent training activity across the roster
  • athlete_trainingFilterable athlete training history
  • athlete_lift_historyLift history for one athlete
  • team_volumeVolume totals for a team

Workouts & sessions

  • workout_buildProgram a session from blocks
  • workout_readRead a programmed workout
  • workout_publishPublish a draft to athletes
  • session_removeRemove a session from a program
  • session_unpublishUnpublish a live session
  • session_copyCopy a session to another date
  • session_save_as_templateSave a session as a template

Exercise library

  • exercise_resolveMap a name to one exercise id
  • exercise_searchFuzzy search the library
  • exercise_getFull exercise by id
  • exercise_syncRefresh the cached library
  • exercise_createCreate a custom exercise
  • exercise_forgetRemove a custom exercise from the cache
  • store_statsLibrary cache stats

Athlete management

  • athlete_inviteInvite an athlete to your org
  • athlete_archiveArchive an athlete
  • athlete_restoreRestore an archived athlete
  • athlete_saved_workoutsSaved workouts for an athlete
  • log_athlete_setLog a set for an athlete
  • coach_log_sessionLog a full session for an athlete
  • swap_athlete_exerciseSwap an exercise in a session
  • prescribe_athlete_setOverride prescribed sets

Teams & codes

  • team_createCreate a team
  • team_updateRename or update a team
  • team_deleteDelete a team
  • team_code_createCreate a join code
  • team_code_deleteDelete a join code
  • list_team_codesJoin codes for a team

Messaging & analytics

  • messaging_conversationsMessage streams and teams
  • messaging_readRead a conversation
  • message_draftDraft a message
  • message_sendSend a message
  • message_deleteDelete a message
  • analytics_queryQuery readiness, volume, and more
  • athlete_main_lift_prsMain-lift PRs for one athlete
  • roster_main_lift_prsMain-lift PRs across the roster

Athlete tools

Every account on the main URL or /mcp/athlete.

Profile & history

  • athlete_whoamiYour athlete profile
  • athlete_profileTraining profile summary
  • athlete_prefsNotification and display prefs
  • athlete_working_maxesWorking maxes by lift
  • athlete_leaderboardLeaderboard standings
  • athlete_workoutsUpcoming and recent workouts
  • athlete_exercisesSearch your exercise history
  • athlete_exercise_historyHistory for one exercise
  • athlete_personal_recordsPRs for one exercise
  • athlete_exercise_statsStats for one exercise
  • athlete_log_targetsWhat to log today

Logging

  • athlete_session_createCreate a training session
  • athlete_session_add_exercisesAdd exercises to a session
  • athlete_session_removeRemove a session
  • athlete_log_sessionLog a full session
  • athlete_log_setLog one set

Hosted only

D1 warehouse sync/query tools and feedback — available on the hosted connector only.

  • report_feedbackReport a bug or send feedback to the maintainers
  • programming_syncSync prescribed programming history into D1
  • programming_storedQuery synced programming history
  • messaging_syncSync message history into D1
  • messaging_storedQuery synced message history
  • athlete_workouts_syncSync workout history into D1
  • athlete_workouts_storedQuery synced workout history
  • athlete_training_syncSync exercise history and PRs into D1
  • athlete_training_storedQuery synced exercise history and PRs