Skip to content
On this page

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.