Tredict MCP Server

Official Model Context Protocol (MCP) server for Tredict, the planning and analytics platform for endurance sports athletes and coaches. Connect your preferred AI assistant to your complete training history across running, cycling, swimming and more. Analyse activities, determine capacity values, create fully structured training plans inside Tredict, synced directly to your watch.

Tredict also ships interactive MCP App UI widgets that visually render activity details and training plans directly in the LLM chat of hosts such as Claude.ai or ChatGPT.

Overview

Name	Tredict MCP Server
MCP Server URL	https://www.tredict.com/api/mcp/v2
Transport	Streamable HTTP and SSE
Protocol	MCP 2025-06-18
Authentication	OAuth 2.1 with PKCE / Personal API Token

Full technical documentation: Tredict MCP Server Documentation.

Core features

• Training plan creation. Analyse training history and current fitness to generate reusable, multi-week plans with structured workouts in the user's "My Plans" category.
• Structured workout authoring. Create executable structured workouts for running, cycling, swimming and strength, and reschedule or rename planned sessions.
• Activity analysis. Detailed metrics and full time series (heart rate, pace, power, cadence, altitude, position, laps) for every executed activity.
• Capacity assessment. Determine FTP, FTPace (running), HRmax and lactate threshold from recent training data.
• Health and recovery. Access HRV, sleep, body values (weight, body fat, resting heart rate) and training effort over time.
• Training zones. Read zone revisions and aggregated zone distribution per sportType and zoneType (heartrate, pace, power, cadence).
• Equipment tracking. List all equipment (bikes, shoes, swimming, misc) with usage ranges, counts, distance and duration.
• Device sync. Plans applied to the training calendar are automatically uploaded to connected sports watches (Garmin, Suunto, Coros, icTrainer, Wahoo, Apple Watch and others).

Example Conversations

Activity Analysis

You: "How did my long run on Sunday go?"
Claude: [Shows pace, heart rate, cadence, elevation and zone distribution. 
         Flags the last 5 km where HR drifted into threshold]

Training Plan Creation

You: "Build me a 10-week half marathon plan based on my recent training"
Claude: [Analyses last 8 weeks of running history, creates a structured 
         multi-week plan in My Plans, pushes workouts to your Garmin]

FTP & Capacity

You: "What is my current running FTP?"
Claude: [Derives FTPace from recent efforts, compares to last revision, 
         suggests updated training zones]

Equipment & Shoes

You: "How many kilometres do my current running shoes have?"
Claude: [Lists active shoes with distance logged, 
         flags gear approaching typical replacement range]

Year-over-Year Comparison

You: "How does my 2025 training compare to 2024?"
Claude: [Compares total volume, zone distribution, long run progression
         and peak weeks across both years]

Recovery Check

You: "Am I ready for tomorrow's threshold session?"
Claude: [Reads HRV trend, resting heart rate and recent training load.
         Gives a clear go or back-off recommendation]

Plan Adherence

You: "Am I actually hitting my training zones as planned?"
Claude: [Shows prescribed vs actual time in each zone per sport,
         highlights where execution is drifting from the plan]

HRV & Fitness Trend

You: "What does my HRV trend tell me about my current fitness?"
Claude: [Analyses rMSSD baseline, flags suppression periods,
         links dips to high-load weeks in training history]

Race Goal Reality Check

You: "Is my sub-4 marathon goal realistic given my current training?"
Claude: [Derives pace capacity from recent long runs and threshold efforts,
         compares to goal pace, outlines what needs to improve]

Platform support

Officially supported: Anthropic Claude (Web, Desktop, Code), OpenAI ChatGPT, OpenAI Codex, Mistral Le Chat, Mistral Vibe.

Compatible: any MCP client that supports OAuth 2.1 or bearer-token authentication, including local LLM setups.

Setup guides per platform:

• Claude Web / Claude Desktop
• Claude Code
• ChatGPT
• Codex
• Mistral Le Chat
• Mistral Vibe

Configuration

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector:

• Name: Tredict
• Remote MCP Server URL: https://www.tredict.com/api/mcp/v2

OAuth is handled automatically on first use.

Generic MCP client (Streamable HTTP)

{
  "mcpServers": {
    "tredict": {
      "url": "https://www.tredict.com/api/mcp/v2",
      "transport": { "type": "http" }
    }
  }
}

Personal API Token

For clients without OAuth support, create an access token in Tredict at "Settings → Personal API / MCP" and pass it as a bearer token:

Authorization: Bearer <your-personal-api-token>

Authentication

The server supports two methods:

1. OAuth 2.1 with PKCE and Client Credentials. Recommended for third-party MCP hosts. Scopes are fine-grained: activityRead, activityWrite, bodyvaluesRead.
2. Personal API Token. Recommended for self-built agents and local LLM workflows.

See the OAuth2 documentation for full details.

Available tools

All tool names, descriptions and schemas can be listed by the MCP client. Scope annotations in parentheses.

Activities

Tool	Description	Scope
activity-list	List executed activities for a date range	activityRead
activity	Activity details, metrics and time series	activityRead
activity-update	Update title and notes of an activity (non-destructive)	activityWrite
equipment-list	List all user equipment (bikes, shoes, swimming, misc)	activityRead

Planning

Tool	Description	Scope
plan-creation	Create a reusable training plan in "My Plans"	activityWrite
add-plan-training	Add a single structured workout to an existing plan	activityWrite
planned-workout-list	List planned / scheduled workouts	activityRead
planned-workout	Details and structure of a single planned workout	activityRead
planned-workout-change-date	Reschedule a planned workout to a new date	activityWrite
training-effort-list	Training effort over time across all sportTypes	activityRead

Body, health and capacity

Tool	Description	Scope
bodyvalues	Weight, body fat, resting HR, body height and more	bodyvaluesRead
capacity	Capacity values (HRmax, HRlth, FTP, FTPace) per sportType	bodyvaluesRead
hrv-list	Heart rate variability data with baseline	bodyvaluesRead
sleep-list	Sleep data with baseline	bodyvaluesRead
zones	Zone revisions per sportType and zoneType	bodyvaluesRead
zones-distribution	Aggregated zones distribution per sportType and month	bodyvaluesRead

Interactive MCP App UI widgets

Tool	Description	Scope
show-activity-ui	Render activity details, metrics, laps and map in the chat	activityRead
show-plan-ui	Render a reusable training plan with calendar view in the chat	activityRead

Prompts

Predefined, parameterised tasks the host can offer as templates:

• better-names : find recent activities with poor titles and suggest meaningful ones.
• coolest-training (year) : find the most interesting session of a given year.
• compare-years (firstYear, otherYear) : in-depth year-over-year comparison.
• create-plan (monthsBack?, durationInWeeks?, workoutsPerWeeks?, sportTypes?, targetZonesTypes?) : build a full training plan from recent history.
• determine-ftp (sportType?) : derive current FTP from training history.
• indepth-analysis : 2-year in-depth training status assessment.
• recreate-structured-workout (activityId) : rebuild an executable structured workout from an executed activity.

Resources

URI	Description
mcp://tredict/assets/logo.svg	Tredict rectangular logo (light / dark themes)
mcp://tredict/assets/logo-slogan.svg	Tredict logo with "Analytics for Endurance Athletes" slogan
ui://widget/activity-ui-100.html	Activity details UI widget (MCP App)
ui://widget/plan-ui-100.html	Training plan UI widget (MCP App)

Data integrity

• All write operations are reversible. activity-update stores previous titles and notes in the mcpUpdatedFields array, so any change can be rolled back at any time.
• The server only accesses your own profile. If you have access to other Tredict athletes as a friend or coach, their data remains invisible to the MCP server.

Health data responsibility

Some responses, in particular from plan-creation, ask the LLM to surface health and liability notices. By registering with Tredict, the user accepts responsibility for health-related applications of the data as defined in the Terms of Use. LLMs make mistakes and are not a substitute for a qualified coach or your own judgement.

Privacy and control

An external MCP client has no access to Tredict data until the user explicitly configures it. Read and write permissions can be restricted per scope at token creation. Tredict is fully GDPR compliant; see the Privacy Policy. Review the privacy policy of the connected AI provider for what happens to data sent through it, or use a local LLM to keep everything on-device.

Links

• Server documentation: MCP Server Docs
• Launch post with examples: Use AI assistants and LLMs with the Tredict MCP Server
• FAQ: Model Context Protocol and AI integration
• Glossary: Artificial Intelligence and MCP for endurance sports