MCP servers
Connect Claude Code, Cursor, or any MCP client to the hosted TrainHeroic server over HTTP with OAuth sign-in, or run a local stdio server instead.
The hosted server is the simplest MCP deployment: one URL, OAuth login, and a tool set selected from the role on your TrainHeroic account. To keep the server process and your credentials on your own machine, run a local stdio server instead.
https://mcp.trainheroic-unofficial.com/mcp
Add the server
$ claude mcp add trainheroic --transport http https://mcp.trainheroic-unofficial.com/mcp{
"mcpServers": {
"trainheroic": {
"url": "https://mcp.trainheroic-unofficial.com/mcp"
}
}
}The client opens the TrainHeroic sign-in the first time the server needs authorization. The server keeps your TrainHeroic credentials inside the encrypted OAuth grant and never forwards the client’s bearer token to TrainHeroic. The privacy policy has the details.
Role-aware tools
A coach account gets the coaching surface plus the account’s own athlete-training tools.
An athlete account gets profile, workouts, history, PR, working-max, leaderboard, and set-logging tools.
Two optional endpoints narrow the connection to one role:
| Endpoint | Scope |
|---|---|
https://mcp.trainheroic-unofficial.com/mcp/coach |
Coaching tools only |
https://mcp.trainheroic-unofficial.com/mcp/athlete |
Athlete-training tools only |
The coach-only endpoint exposes no tools when the signed-in account is athlete-only.
Hosted-only features
The hosted server adds D1-backed history warehouses and a feedback tool. Ask the assistant to report a problem and it can attach recent tool context for the maintainers.