Health & fitness
TrainingPeaks
Workouts, metrics, events and training plans for your TrainingPeaks calendar.
14 endpoints
TrainHeroic publishes no public API and no MCP server (checked 14 Nov 2026). Cotlet runs a hosted TrainHeroic MCP server with 19 tools that ChatGPT and Claude use in your own coach account. Program changes and TH Chat messages wait for your OK.
19 tools Read and write
TrainHeroic publishes no public API, developer documentation or self-serve API key on trainheroic.com or in its Help Center. No TrainHeroic MCP server and no official ChatGPT or Claude connector was verified.
| What you need | TrainHeroic API | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No API or MCP server | Copy and paste | Hosted MCP server |
| Readiness, compliance and lift analytics | No public API | One view and team at a time | All teams in one request |
| Programs, sessions and TH Chat | No public API | In the coach web app | 19 tools, writes after your OK |
| Run from n8n or a script | Nothing to call | Manual only | REST, same key |
Checked 14 Nov 2026. Sources: TrainHeroic for coaches · TrainHeroic Help Center · Help: Viewing Compliance Analytics · Help: Readiness Analytics · Help: Analytics for Lifts and Working Maxes · Help: Reviewing what athletes logged · Help: Exporting your Athlete List · Help: Print or export Analytics · Help: Creating Teams · Help: Adding athletes to a Team · Help: Removing Athletes · Help: Recovering Archived Athletes · Help: Custom Exercises with Videos · Help: Creating Supersets · Help: Rep Ranges · Help: Copying a Program · Help: Assigning Programs · Help: Removing a Program from a Calendar · Help: Parent Calendars · Help: Access Codes · Help: TH Chat · Help: Organization name and images · Help: Payment history · Help: Sharing content between organizations
Once, in a browser we host for you.
One address in its settings.
Read readiness, then approve the team note.
Your agent works in your own signed-in Cloud Browser. Calendar changes and anything an athlete will read wait for your OK. Who can see your session
Sign in to TrainHeroic in a Cloud Browser. Open app.trainheroic.com in your Cotlet Cloud Browser and log in with your own coach account.
Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.
TrainHeroic uses the shared address https://cotlet.dev/mcp/v1 along with every other app you turn on, so one connector covers them all. Added TrainHeroic after connecting? Refresh the connector to see its 19 tools.
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY" // ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
} # ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY" MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: trainheroic_read One tool per coach workflow in the TrainHeroic Help Center. Analytics tools only read and run at once; every tool that changes a calendar, the roster or a chat asks first.
Compliance, readiness, lifts and training summaries, the views under Analytics. Read only.
Reads Analytics > Team/Group, the Compliance view: session compliance and training block compliance as percentages over the range. TrainHeroic defaults to All Athletes over the past 30 days; filter by team or dates. It changes nothing and runs without asking.
MCP calltrainheroic_read → get_compliance_analytics
REST endpointGET https://cotlet.dev/api/v1/trainheroic/compliance-analytics
| Name | Type | Description |
|---|---|---|
| team string | string | Team name. Leave empty for All Athletes. |
| from string | string | ISO start date. Defaults to 30 days ago. |
| to string | string | ISO end date. Defaults to today. |
{
"scope": "All Athletes",
"from": "2026-10-15",
"to": "2026-11-14",
"teams": [
{
"team": "Varsity Strength",
"session_compliance": 86
},
{
"team": "JV Strength",
"session_compliance": 71
},
{
"team": "Off-Season Throwers",
"session_compliance": 64
}
]
} Readiness surveys cover stress, sleep, mood and soreness. The team view lists athletes who logged readiness today, sorted by score from lowest, so the athletes who need a word come first. The athlete view returns that athlete's scores for the past 30 days. Read only.
MCP calltrainheroic_read → get_readiness_analytics
REST endpointGET https://cotlet.dev/api/v1/trainheroic/readiness-analytics
| Name | Type | Description |
|---|---|---|
| view string required | string | `team` for everyone who logged readiness today, `athlete` for one athlete over 30 days. |
| team string | string | Team name. Leave empty for All Athletes. |
| athlete string | string | Athlete name, for `athlete`. |
{
"view": "view"
} {
"view": "team",
"team": "Varsity Strength",
"date": "2026-11-14",
"athletes": [
{
"athlete": "Jordan Example",
"readiness": 52
},
{
"athlete": "Casey Sample",
"readiness": 68
},
{
"athlete": "Riley Demo",
"readiness": 81
}
]
} History shows each logged entry with the prescribed values, or only the entries that changed the working max. Performance compares estimated 1RM across a team; progress compares the start and end of a cycle. Read only.
MCP calltrainheroic_read → get_lift_analytics
REST endpointGET https://cotlet.dev/api/v1/trainheroic/lift-analytics
| Name | Type | Description |
|---|---|---|
| report string required | string | `history` (every logged entry, or `working_max` entries only), `performance` (best estimated 1RM in the range) or `progress` (estimated 1RM at start and end). |
| exercise string required | string | The lift, by its Exercise Library name. |
| athlete string | string | Athlete name. Required for `history`. |
| team string | string | Team name. Leave empty for All Athletes. |
| entries string | string | For `history`: `complete` or `working_max`. |
| from string | string | ISO start date. Defaults to 30 days ago. |
| to string | string | ISO end date. Defaults to today. |
{
"report": "report",
"exercise": "exercise"
} {
"report": "progress",
"exercise": "Back Squat",
"team": "Varsity Strength",
"from": "2026-09-01",
"to": "2026-11-14",
"athletes": [
{
"athlete": "Jordan Example",
"start_e1rm": 285,
"end_e1rm": 305
},
{
"athlete": "Casey Sample",
"start_e1rm": 240,
"end_e1rm": 250
}
]
} From Training Summary analytics: how much the athlete lifted, how long sessions took and the intensity they reported. Use it before adjusting a program. Read only.
MCP calltrainheroic_read → review_athlete_logs
REST endpointGET https://cotlet.dev/api/v1/trainheroic/athlete-logs/review
| Name | Type | Description |
|---|---|---|
| team string | string | Team name. Leave empty for All Athletes. |
| athlete string | string | Athlete name, to drill into the past 30 days. |
{
"athlete": "Jordan Example",
"days": 30,
"sessions_logged": 11,
"total_volume_lbs": 48200,
"average_duration_min": 58,
"average_intensity": 7
} The same columns as Athletes > Export Athletes > Download CSV: the athlete's name, email and start date for that team or group. Returned as rows, not a file. Read only.
MCP calltrainheroic_read → export_athlete_list
REST endpointGET https://cotlet.dev/api/v1/trainheroic/athlete-lists/export
| Name | Type | Description |
|---|---|---|
| team string required | string | Team or group to export. |
{
"team": "team"
} {
"team": "Varsity Strength",
"athletes": [
{
"name": "Jordan Example",
"email": "jordan@example.com",
"start_date": "2026-08-18"
},
{
"name": "Casey Sample",
"email": "casey@example.com",
"start_date": "2026-08-18"
}
]
} Reads Billing Info > Payment History, the charges for your own coach account. Read only; no tool changes billing details or your plan.
MCP calltrainheroic_read → view_payment_history
REST endpointGET https://cotlet.dev/api/v1/trainheroic/payment-histories/view
No parameters.
{
"payments": [
{
"date": "2026-11-01",
"description": "Coach plan",
"status": "Paid"
},
{
"date": "2026-10-01",
"description": "Coach plan",
"status": "Paid"
}
]
} Build sessions with supersets and rep ranges, keep your own exercises with videos, copy a block and put it on a calendar.
Follows the Session Builder: linked exercise blocks become a superset so the athlete tracks each set, and a rep range shows athletes a target such as 8 to 12 reps. A session on a team or athlete calendar is what athletes open in the app. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → build_session
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/session/build
| Name | Type | Description |
|---|---|---|
| where string required | string | `team`, `athlete` (a 1:1 calendar) or `library` (a saved session). |
| target string | string | Team or athlete name, for a calendar. |
| date string | string | ISO date, for a calendar. |
| title string required | string | Session title. |
| blocks array required | array | Exercise blocks: exercise, sets with reps, weight, time or distance or a rep range (min and max), percent of working max, notes for RPE, tempo or rest, and `superset` to link it to the next block. |
{
"where": "where",
"title": "title",
"blocks": "blocks"
} {
"where": "team",
"target": "Varsity Strength",
"date": "2026-11-17",
"title": "Lower A",
"blocks": 3,
"saved": true
} Only your own exercises can be edited or deleted; TrainHeroic exercises are a shared library. A deleted exercise is gone for good, so the agent names it before deleting. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → manage_exercises
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/exercises/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `create`, `update`, `delete`. `list` only reads. |
| search string | string | For `list`: part of an exercise name. |
| scope string | string | For `list`: `all` (with TrainHeroic exercises) or `mine`. |
| name string | string | Exercise name, for `create`, `update` and `delete`. |
| video_url string | string | A public or unlisted YouTube link, or a public Vimeo link, for one video. |
{
"action": "action"
} {
"exercise": "Tempo Back Squat 3-1-1",
"video_url": "https://www.youtube.com/watch?v=example",
"saved": true
} The copy is independent: changes to it do not touch the original. Shortening a copy's duration hides the extra weeks without deleting them. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → copy_program
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/program/copy
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `copy`. `list` only reads. |
| program string | string | Program to copy. |
| new_name string | string | Name of the copy. |
{
"action": "action"
} {
"program": "Winter Strength Block",
"copy": "Spring Strength Block",
"copied": true
} Works like Add From Library: a copy of the program lands on the calendar from the start date, and those athletes see the sessions in the app. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → assign_program
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/program/assign
| Name | Type | Description |
|---|---|---|
| program string required | string | Program from your Library. |
| calendar string required | string | `team` or `athlete`. |
| target string required | string | Team or athlete name. |
| start_date string required | string | ISO date of the first session. |
{
"program": "Spring Strength Block",
"calendar": "team",
"target": "Varsity Strength",
"start_date": "2026-11-17"
} {
"program": "Spring Strength Block",
"calendar": "team",
"target": "Varsity Strength",
"start_date": "2026-11-17",
"sessions_added": 24
} The same as highlighting days on the calendar and pressing Delete, for example to take off a program added by mistake. The agent lists the sessions it will remove first; a deleted session comes back only by assigning the program again. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → delete_calendar_sessions
REST endpointDELETE https://cotlet.dev/api/v1/trainheroic/calendar-sessions
| Name | Type | Description |
|---|---|---|
| calendar string required | string | `team` or `athlete`. |
| target string required | string | Team or athlete name. |
| from string required | string | ISO date. |
| to string required | string | ISO date. |
{
"calendar": "calendar",
"target": "target",
"from": "from",
"to": "to"
} {
"calendar": "team",
"target": "JV Strength",
"from": "2026-11-17",
"to": "2026-11-30",
"sessions_deleted": 8
} A parent calendar delivers the same programming to several teams on the same schedule, such as class periods following one plan. Programming on it shows on every team it is turned on for. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → manage_parent_calendars
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/parent-calendars/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `create`, `assign`, `unassign`. `list` only reads. |
| name string | string | Parent calendar title. |
| team string | string | Team, for `assign` and `unassign`. |
{
"action": "action"
} {
"parent_calendar": "PE Strength, all periods",
"team": "Period Three",
"assigned": true
} Teams, who is on them, access codes, and archiving athletes at the end of a season.
A team is a group of athletes on the same program and schedule, with one calendar, one chat channel and group analytics. Athletes can belong to several teams. A new team starts with an empty calendar. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → manage_teams
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/teams/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `create`. `list` only reads. |
| name string | string | Team name, for `create`. |
{
"action": "action"
} {
"team": "Spring Speed Group",
"created": true,
"calendar": "empty"
} Works in the athlete's Account drawer, under Teams/Programs. Access bought through the Marketplace cannot be removed, and the tool says so instead of trying. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → add_athlete_access
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/athlete-access
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `add`, `remove`. `list` only reads. |
| athlete string required | string | Athlete name from your roster. |
| team string | string | Team to join or leave. |
| program string | string | Program to grant or remove. The athlete adds it to their own calendar when they choose. |
{
"action": "action",
"athlete": "athlete"
} {
"athlete": "Casey Sample",
"team": "Spring Speed Group",
"added": true
} Custom codes are meant for signing up a large group in person; athletes who join count toward your Coach Plan. Deleting a code keeps the athletes who already joined. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → manage_access_codes
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/access-codes/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `create`, `delete`. `list` only reads. |
| team string required | string | Team whose settings hold the code. |
| code string | string | The code, for `create` and `delete`. |
{
"action": "action",
"team": "team"
} {
"team": "Spring Speed Group",
"code": "SPEED26",
"created": true
} Archiving removes the athlete's access to team programming, team feeds and their 1:1 calendar, and they stop counting toward your Coach Plan. It does not delete their TrainHeroic account. Removing from all teams keeps them on your list. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → archive_athletes
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/athletes/archive
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `archive`, `remove_from_teams`. `list` only reads. |
| athletes array required | array | Athlete names. |
{
"action": "action",
"athletes": "athletes"
} {
"action": "archive",
"athletes": [
"Riley Demo"
],
"archived": 1
} Undoes an archive. A reactivated athlete does not need a new invitation and counts toward your Coach Plan again. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → reactivate_athletes
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/athletes/reactivate
| Name | Type | Description |
|---|---|---|
| athletes array required | array | Names from the Archived list. |
{
"athletes": "athletes"
} {
"athletes": [
"Riley Demo"
],
"reactivated": 1
} Direct, team and program messages, and the organization name athletes see in invitations.
Direct messages go to athletes you train 1:1; a team channel reaches everyone on the team; a program channel reaches athletes who bought that program on the Marketplace. The agent shows you the recipients and text before sending. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → send_message
REST endpointPOST https://cotlet.dev/api/v1/trainheroic/messages
| Name | Type | Description |
|---|---|---|
| to string required | string | `athlete`, `team` or `program`. |
| name string required | string | Athlete, team or program name. |
| text string required | string | The message. |
{
"to": "to",
"name": "Jane Doe",
"text": "text"
} {
"to": "team",
"name": "Off-Season Throwers",
"sent": true
} Head coach only, under My Organizations. The new name shows in athlete invitations and on your Marketplace page, so the agent checks the wording with you first. By default you confirm each call; you can switch that off for this tool.
MCP calltrainheroic_write → update_organization
REST endpointPATCH https://cotlet.dev/api/v1/trainheroic/organization
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `get`, `update`. `list` only reads. |
| name string | string | Organization name. |
| description string | string | Organization description. |
{
"action": "action"
} {
"organization": "Example Strength Co",
"description": "Strength and conditioning for high school athletes.",
"saved": true
} Your signed-in TrainHeroic browser profile, AES-256-GCM encrypted, in Finland. Never your password.
The 19 TrainHeroic tools. The session cookie stays in the Cloud Browser.
The teams, athletes, Library and analytics your coach login can open, and nothing more.
Your coach plan and billing details, assistant coach invites, Marketplace pricing and promo codes.
You log in again yourself, in the same Cloud Browser.
Disable TrainHeroic for agents, reset the browser, or change your TrainHeroic password.
Cotlet never sees or stores your password: you log in to TrainHeroic yourself and the agent uses only the session. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
Cotlet watches the apps it serves and updates the TrainHeroic server when the coach web app changes, so your agent keeps working without a change on your side.
When TrainHeroic adds a feature, such as rep ranges in the Session Builder, the agent can use it. It still sees only what your coach login sees: an assistant coach login reaches the shared Library, not your billing.
If TrainHeroic signs you out, one click in the Cotlet console reopens the Cloud Browser so you can log in again.
| Action | How to put it right |
|---|---|
| Program on the wrong calendar | delete_calendar_sessions for its date range |
| Athlete archived by mistake | reactivate_athletes; no new invite needed |
| Parent calendar on the wrong team | manage_parent_calendars with unassign |
| TH Chat message | Already with your athletes: follow up in TH Chat |
| Deleted custom exercise | Gone for good: create it again with manage_exercises |
All 13 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 6 read tools, the analytics and the athlete export, run at once.
{
"name": "assign_program",
"arguments": {
"program": "Spring Strength Block",
"calendar": "team",
"target": "Varsity Strength",
"start_date": "2026-11-17"
}
} curl -X POST https://cotlet.dev/api/v1/trainheroic/program/assign \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"program":"Spring Strength Block","calendar":"team","target":"Varsity Strength","start_date":"2026-11-17"}' {
"program": "Spring Strength Block",
"calendar": "team",
"target": "Varsity Strength",
"start_date": "2026-11-17",
"sessions_added": 24
} The example puts a copy of Spring Strength Block on the Varsity Strength calendar from Monday 17 November. A cron job or n8n flow can make the same call over REST at /api/v1/trainheroic with the same key and price, in JSON. Failed calls are free.
About $21 a monthfor a coach with three teams and 20 training days, 3,660 credits. Your TrainHeroic coach plan stays as it is.
| Job | Calls | Credits |
|---|---|---|
| Readiness check before practice | 1 × 20 | 200 |
| Sessions built on three team calendars | 3 × 20 | 600 |
| TH Chat notes to athletes and teams | 3 × 20 | 600 |
| Weekly compliance review and team note | 2 × 4 | 80 |
| Lift progress and athlete summaries | 13 × 4 | 520 |
| Next block copied and assigned | 2 × 3 | 60 |
| Roster changes and access codes | 1 × 10 | 100 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 216 calls | 3,660 |
The smallest pack, 5,000 credits for $29, covers this month with room left. More teams or daily athlete messages use more calls.
Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.
| Credits | Price, one time | Calls at 10 credits | Per 1,000 credits |
|---|---|---|---|
| 5,000 | $29 | 500 | $5.80 |
| 15,000 | $79 | 1,500 | $5.27 |
| 32,000 | $149 | 3,200 | $4.66 |
| 60,000 | $249 | 6,000 | $4.15 |
Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.
| Option | What it does | Where it stops |
|---|---|---|
| TrainHeroic coach web app | Every view and setting, one screen at a time. | Only while you are at the desk; no agent or script can call it. |
| TrainHeroic mobile app | Logging, TH Chat and readiness on the go. | The same manual work, on a phone. |
| Athlete list CSV export | Name, email and start date per team. | Roster only; analytics are printed or copied from the screen. |
| Assistant coaches | Share the Library and athletes within one organization. | More people doing the work by hand, at $9.99 a month each. |
If TrainHeroic publishes an API that covers your job, use it: it would be the vendor's own route. Cotlet fits when you want ChatGPT, Claude or a script working in TrainHeroic today, from your own coach login, with nothing to host.
Take Group sp. z o.o. runs Cotlet: a software company registered in Poland, EU (VAT PL6342984273), in business since 2019 and led by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the TrainHeroic tools go to contact@cotlet.dev.
Sign up free at https://cotlet.dev/signup?app=trainheroic, turn on TrainHeroic under Integrations in the console and log in at https://app.trainheroic.com/ in your Cloud Browser. Then connect your AI agent and ask it about a team. The trial needs no card.
TrainHeroic publishes no public API and no developer documentation on trainheroic.com or support.trainheroic.com (checked 14 Nov 2026). No TrainHeroic MCP server and no official ChatGPT or Claude connector was verified. Cotlet does not need one: it works in your own signed-in TrainHeroic coach account.
It works as the coach who signs in. TrainHeroic shares the Library, programs and exercises between the head coach and assistant coaches of one organization, so an assistant coach login sees that shared content. Assistant coaches cost $9.99 a month each, per the TrainHeroic Help Center.
No. Per the TrainHeroic Help Center, archiving removes the athlete from your list and your programming, and frees their Coach Plan seat. Their own account stays, and reactivate_athletes brings them back without a new invite.
No. The tools work on the coach side: programming, analytics, roster and TH Chat. Athletes keep logging their own sessions, readiness and working maxes in the TrainHeroic app.
Only in how it is called. Both carry the same 19 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.
No. Cotlet is independent and not affiliated with TrainHeroic.
Free 7-day trial with 2,000 credits, no card needed.
May we use Google Analytics to see which pages help people? It sets cookies only if you accept. No ads, and we never sell data. Cookie policy