Connect AI Endurance to Claude for Training Insights
MCP server connecting Claude to AI Endurance - view and modify training plans, analyze cycling, running, and swimming activities, and get race predictions.
1.0.0Add to Favorites
Why it matters
Integrate your AI Endurance training data with Claude for conversational access to performance analytics, workout management, and personalized coaching advice.
Outcomes
What it gets done
Access and analyze training data (cycling, running, swimming) via conversational prompts.
Manage training plans, including viewing, creating, and modifying workouts.
Track workout completion, reschedule activities, and update training zones.
Gain insights into performance, recovery, and race readiness.
Source
Get it from source
Spark does not host a copy of it.
Open sourceReports
Agent outcome reports
No reports yet
Capabilities
Tools your agent gets
View profile including training zones, user type, units of measurement, and settings
Update training zones for cycling (power) or running (pace/power)
View weekly training hours and daily availability schedule for each activity type
Get scheduled workouts for a period (default: next 14 days)
Move a workout to another date and sync with connected platforms
Remove a workout from the plan
Mark a workout as completed or incomplete
Add or update coaching advice for a specific workout
Overview
AI Endurance MCP Server
An MCP server that connects Claude to the AI Endurance training platform, exposing 20 tools for viewing and creating structured workouts, analyzing cycling, running, and swimming activity data, tracking HRV-based recovery, and getting ML-based race time predictions. Use it for conversational training plan management and activity analysis. It cannot start plan generation, change third-party platform connections, or touch billing and account settings, so those still require the AI Endurance dashboard.
What it does
An MCP server that connects an AI Endurance training account to Claude and other AI assistants for conversational access to training plans, activity history, and performance analytics. Through natural conversation it can view, modify, and create structured workouts for cycling, running, and swimming, analyze detailed activity data including power curves and pace trends, track recovery using HRV and resting heart rate, manage training zones, and surface machine-learning race time predictions - covering the same ground as the AI Endurance web dashboard but reachable from inside a chat.
When to use - and when NOT to
Use it for the conversational, day-to-day parts of training: checking this week's workouts, moving a session, building a custom interval workout, reviewing yesterday's ride or run in detail, or asking how realistic a race goal is given current fitness. Read-scope access covers training data, workouts, activities, zones, predictions, and recovery metrics; write-scope access additionally allows creating, modifying, and deleting workouts, and updating zones. It explicitly cannot start training plan generation, create or modify data exclusions, change connections to third-party platforms like Garmin or Strava, delete the account, touch billing or payment information, or delete historical activities - it can only skip future ones. For any of those, the AI Endurance dashboard is still required.
Capabilities
Twenty tools across four groups. Profile and settings: getUser (profile, zones, preferences), setZones (update pace or power zones), getAvailability (weekly training-time schedule). Workout management: getPlannedWorkouts, changeWorkoutDate, skipWorkout, changeWorkoutAdvice, plus createRideRunWorkout, createSwimWorkout, and createStrengthOtherWorkout for building structured sessions from scratch, all syncing to connected platforms like Garmin, TrainingPeaks, and Zwift. Activity history: getCyclingActivity, getRunningActivity, and getSwimmingActivity list recent sessions, while their ActivityDetail counterparts return time-series metrics such as power, heart rate, cadence, pace, and stroke rate at a chosen resolution, from a lightweight summary up to the full dataset. Analytics: getRaceGoalEvent (race goals and predicted times), getPrediction (12-week fitness forecast with confidence intervals), getRecoveryModel (HRV, DFA alpha 1, rMSSD, orthopedic recovery), getPlanProgress (zone-by-zone plan adherence), and getNutritionModel (daily calorie and macronutrient targets).
How to install
In Claude.ai, go to Settings, then Connectors, then Add custom connector, and configure:
Name: AI Endurance
Remote MCP Server URL: https://aiendurance.com/mcp
Then authorize with an AI Endurance account. Any MCP 2025-06-18-compliant client, such as Claude Desktop, Cursor, Continue, or Cline, can connect via Streamable HTTP:
{
"url": "https://aiendurance.com/mcp",
"transport": { "type": "http" },
"auth": {
"type": "oauth",
"authorizationUrl": "https://aiendurance.com/authorize/",
"tokenUrl": "https://aiendurance.com/api/o/token/",
"scopes": ["read", "write"]
}
}
An AI Endurance account with an active subscription or free trial is required.
Who it's for
Runners, cyclists, and triathletes on AI Endurance who want to check their plan, log and analyze activities, and monitor recovery and race readiness without leaving their AI assistant.
Source README
AI Endurance MCP Server
Connect your AI Endurance training platform to ChatGPT, Claude, and other AI assistants for conversational access to your training data, workouts, and performance analytics and to manage your training plan.
Overview
The AI Endurance MCP server enables AI assistants to access your training plan, activity history, performance predictions, recovery metrics, and training zones through natural conversation. You can view, modify, and create structured workouts for cycling, running, and swimming, analyze detailed activity data including power curves and pace trends, track your recovery using HRV and resting heart rate, and get machine learning-based race time predictions.
Features
- Training Plan Management - View, modify, and create workouts with structured intervals
- Activity Analysis - Access detailed metrics from cycling, running, and swimming activities
- Performance Predictions - ML-based race time predictions and fitness forecasting
- Recovery Tracking - Monitor HRV, resting heart rate, and readiness to train
- Zone Management - Update and view training zones (pace, power)
- Workout Scheduling - Move workouts, adjust availability, track plan progress
- Race Goals - Manage primary and secondary race objectives
- Activity Flags - Correct indoor/virtual/erg detection and exclude bad-sensor activities from analysis
- Durability - See how power or pace held up as work accumulated within a session, and how that compares to your own trend
- Computed Activity Analytics - Server-side normalized power, intensity factor, time-in-zone, pacing/fade and split tables for any activity, without reading raw streams
- Other Sports - List strength, ski, yoga, hike and other non-run/ride/swim activities
Supported Platforms
ChatGPT
AI Endurance is available in the ChatGPT plugin directory: https://chatgpt.com/plugins/plugin_asdk_app_69456fbb59d081918bcb148a12380f92
Setup:
- Open the plugin directory in ChatGPT and search for "AI Endurance" (or use the link above)
- Select "Connect"
- Authorize with your AI Endurance account
- Start asking questions about your training
ChatGPT additionally renders interactive widgets for most tools, so workouts, activities, recovery, and predictions come back as rich cards rather than plain text.
Example:
You: "Show me my workouts for this week"
ChatGPT: [Lists your upcoming workouts with interactive widgets]
Claude.ai
Setup:
- Navigate to Claude.ai settings
- Go to "Connectors"
- Select "Add custom connector"
- Use the following configuration:
Name: AI Endurance
Remote MCP Server URL: https://aiendurance.com/mcp
- Click "Add"
- Authorize with your AI Endurance account
- Start asking questions about your training
Example:
You: "How was my ride yesterday?"
Claude: [Displays power distribution, External Stress Score, duration, and zone breakdown]
Other MCP-Compatible Clients
Any MCP 2025-06-18 compliant client can connect using:
Streamable HTTP Configuration (Recommended):
{
"url": "https://aiendurance.com/mcp",
"transport": {
"type": "http"
},
"auth": {
"type": "oauth",
"authorizationUrl": "https://aiendurance.com/authorize/",
"tokenUrl": "https://aiendurance.com/api/o/token/",
"scopes": ["read", "write"]
}
}
SSE Transport Configuration (Legacy):
{
"url": "https://aiendurance.com/mcp",
"transport": {
"type": "sse"
},
"auth": {
"type": "oauth",
"authorizationUrl": "https://aiendurance.com/authorize/",
"tokenUrl": "https://aiendurance.com/api/o/token/",
"scopes": ["read", "write"]
}
}
Compatible Clients:
- Claude Desktop (macOS, Windows)
- Cursor (code editor with AI)
- Continue (VS Code extension)
- Cline
- Any custom MCP client implementation
Prerequisites
- AI Endurance account (sign up at https://aiendurance.com)
- Active AI Endurance subscription or free trial
- ChatGPT, Claude, or any other MCP-compatible client
Example Conversations
Training Plan Analysis
You: "Show me my workouts for this week"
AI: [Lists 6 workouts with dates, types, durations, and training zones]
You: "What's my long run this weekend?"
AI: [Shows Saturday's 90-minute endurance run with pace zones]
You: "Move tomorrow's threshold workout to Friday"
AI: [Reschedules workout and confirms sync to Garmin/TrainingPeaks]
You: "Am I training enough at threshold?"
AI: [Analyzes plan progress showing actual vs prescribed threshold time]
Activity Deep Dives
You: "How was my ride yesterday?"
AI: [Displays power distribution, normalized power, stress scores, duration, and zone breakdown]
You: "What was my average pace on runs this month?"
AI: [Analyzes all January runs and calculates average pace, weekly volume]
You: "Show me the power curve from my last cycling activity"
AI: [Provides detailed time-series power data with peak power efforts]
You: "Compare my last 3 long runs"
AI: [Pulls detailed metrics and compares pace, heart rate, duration trends]
You: "Yesterday's ride was on Zwift, not outdoors"
AI: [Marks the activity indoor and virtual, and updates the stored weather]
You: "My HR strap was dead on this run - don't use its heart rate"
AI: [Flags the heart rate data as unreliable and rebuilds the HRV aggregates]
Recovery & Fitness
You: "Am I recovered enough for today's hard workout?"
AI: [Shows recovery score, HRV trend, resting HR, and training recommendation]
You: "What's my predicted half marathon time based on current fitness?"
AI: [Displays ML-based prediction with confidence intervals and improvement trajectory]
You: "How well am I following my training plan?"
AI: [Shows plan adherence by zone with actual vs prescribed training volume]
You: "What does my HRV trend say about my fitness?"
AI: [Analyzes recovery model data and provides insights on adaptation]
Custom Workout Creation
You: "Create a threshold run for tomorrow: 15min warmup, 3x8min at threshold with 2min recovery, 10min cooldown"
AI: [Creates structured workout with proper zones, syncs to Garmin/TrainingPeaks/Zwift]
You: "Build me a 60min tempo ride at 85% FTP for Sunday"
AI: [Creates power-based cycling workout with appropriate structure]
You: "Design a swim workout: 200m warmup, 5x100m at threshold pace with 20sec rest, 200m cooldown"
AI: [Creates detailed swim workout with sets, strokes, and pace zones]
Race Planning
You: "What are my upcoming race goals?"
AI: [Lists primary and secondary races with dates and target times]
You: "Based on my training, how realistic is my marathon goal?"
AI: [Analyzes predictions, current training load, and provides assessment]
You: "Show me my fitness trend over the last 8 weeks"
AI: [Displays prediction model history showing fitness progression]
Available Tools (27)
Profile & Settings
getUser
View your profile including training zones, user type (Runner/Cyclist/Triathlete), units (Metric/Imperial), and preferences.
Returns:
- Training zones (cycling power, running pace/power)
- Heart rate thresholds
- Physical metrics (weight, height, birth year)
- User preferences
setZones
Update training zones for cycling (power) or running (pace/power). Automatically manages both pace and power zones for runners using running power meters.
Parameters:
actType: "Run" or "Ride"zones: Object with zone upper boundsEndurance: Upper limit (e.g., "5:31 /km" or "200 W")Tempo: Upper limitThreshold: Upper limitVO2Max: Upper limit
Note: Must include unit in each value. For running, use pace format "mm:ss /km" or "mm:ss /mi", or power format "XXX W". For cycling, use power format "XXX W".
getAvailability
View weekly training hours and daily availability schedule for each activity type.
Returns:
- Weekly hours breakdown (total and by sport for triathletes)
- Daily schedule with available training times
Workout Management
getPlannedWorkouts
Retrieve planned workouts for a date range (default: next 14 days).
Parameters:
startDate(optional): Start date in YYYY-MM-DD format (defaults to today)endDate(optional): End date in YYYY-MM-DD format (defaults to today + 14 days)summaryMode(optional): Boolean - if true, returns lightweight overview with minimal fields, no 35-day capfullDetails(optional): Boolean - if true, includes the machine-readable step structure (steps_general,swim_sections, zone distribution, compliance data) and untruncated swim intervals
Returns:
- Array of workouts with date, title, type, duration, and human-readable warmup/intervals/cooldown descriptions
has_steps_generalper workout, indicating whether a machine-readable structure exists (retrieve it withfullDetails)- Workout density metrics (workouts per week)
- Applied date range
changeWorkoutDate
Move a workout to a different date. Updates workout schedule and syncs with all connected platforms (Garmin, TrainingPeaks, Zwift, etc.).
Parameters:
workoutId: Database ID of workoutnewDate: New date in YYYY-MM-DD formattitle(optional): Workout title for display purposes
Returns:
- Success confirmation
- Old and new dates
skipWorkout
Remove a workout from the training plan. Marks workout as skipped and syncs deletion to connected platforms.
Parameters:
workoutId: Database ID of workouttitle(optional): Workout title for display
Returns:
- Success confirmation
- Workout details
changeWorkoutAdvice
Add or update coaching advice for a specific workout without modifying the workout structure.
Parameters:
workoutId: Database ID of workoutadvice: Additional instructions or tipstitle(optional): Workout title for display
Returns:
- Success confirmation
- Updated advice text
changeWorkoutIntensity
Change the intensity (load) of an existing planned ride or run workout in place. The workout's intensity zone is preserved - the step durations are recomputed at the new load.
Parameters:
workoutId: Database ID of workout (theworkout_idfield of agetPlannedWorkoutsresult)ess: New training stress score (required ifintensityTimenot provided)intensityTime: New time at intensity in seconds (required ifessnot provided)repeats(optional): New number of repeats at the intensitytitle(optional): Workout title for display
Returns:
- Success confirmation with the updated title, date and training stress
Note: only works on workouts with a scalable step structure (algorithm-generated plan workouts and workouts from createRideRunWorkoutByIntensity both qualify - has_steps_general is false on getPlannedWorkouts). On a structured workout it fails cleanly with WORKOUT_HAS_NO_STEPS; skip the workout and recreate it with createRideRunWorkout or createRideRunWorkoutByIntensity instead.
createRideRunWorkout
Create custom structured workout for cycling or running with intervals, repeats, and zones.
Parameters:
dateStr: Date in YYYY-MM-DD formattitle: Workout nameactType: "Ride" or "Run"stepsGeneral: Array of step objects (zone-based targets)isTaper(optional): Boolean, marks as taper workout (default false)advice(optional): Coaching notes
Returns:
- Success confirmation
- Created workout ID
createRideRunWorkoutAdvanced
Create a ride or run workout with precise numeric power or pace targets - ramp tests, FTP tests, over/under intervals, exact-watt or exact-pace sessions. For simple zone-based workouts use createRideRunWorkout instead.
Parameters:
- Same as
createRideRunWorkout, except eachstepsGeneralstep additionally supportstargetType(POWER for watts, SPEED for m/s pace, HEART_RATE for bpm, etc.), a numerictargetValue, and explicittargetValueLow/targetValueHighbounds. Without explicit bounds the backend derives a +/-5% range aroundtargetValue.
Returns:
- Success confirmation
- Created workout ID
createRideRunWorkoutByIntensity
Create a simple ride or run workout from one intensity zone plus a target load - no step structure needed. For structured workouts with custom warmup/interval/cooldown steps use createRideRunWorkout instead.
Parameters:
dateStr: Date in YYYY-MM-DD formatactType: "Ride" or "Run" (must match the user's sport: Runner users only Run, Cyclist users only Ride, Triathlete users both)intensityType: "Endurance", "Tempo", "Threshold", "VO2Max" or "Anaerobic"ess: Target training stress score (required ifintensityTimenot provided; more than about 100 is a hard workout)intensityTime: Target time at intensity in seconds (required ifessnot provided)repeats(optional): Number of repeats at the intensity, for Tempo and aboveisTaper(optional): Boolean, marks as taper workout (default false)
Returns:
- Success confirmation
- Created workout ID and title
Note: if a workout with the same date, sport and load already exists, that existing workout is returned instead of a duplicate.
createSwimWorkout
Create custom swim workout with structured sections (warmup, preparation, main, cooldown), sets, intervals, strokes, and equipment.
Parameters:
dateStr: Date in YYYY-MM-DD formattitle: Workout nameswimSections: Array of swim section objectsisTaper(optional): Boolean, marks as taper workout (default false)advice(optional): Coaching notes
Returns:
- Success confirmation
- Created workout ID
createStrengthOtherWorkout
Create custom strength or other non-swim/bike/run workout, e.g. cross-country skiing, yoga, hiking.
Parameters:
dateStr: Date in YYYY-MM-DD formattitle: Workout namestrengthOtherText: The workout description/instructions in free-form textisTaper(optional): Boolean, marks as taper workout (default false)
Returns:
- Success confirmation
- Created workout ID
Activity History
getCyclingActivity
List recent cycling activities. Returns the 20 most recent rides if no date range specified, up to 40 with a date range.
Parameters:
startDate(optional): YYYY-MM-DD formatendDate(optional): YYYY-MM-DD formatwith_dfa_alpha1(optional): Boolean - if true, includes the DFA alpha 1 and aerobic/anaerobic threshold fields per activity
Returns:
- Array of cycling activities with summary metrics
id: the activity id - pass it asactivityIdtogetCyclingActivityDetailorsetActivityFlags- Activity name, date, duration, distance, power, heart rate, External Stress Score (ESS), weather
getRunningActivity
List recent running activities. Returns the 20 most recent runs if no date range specified, up to 40 with a date range.
Parameters:
startDate(optional): YYYY-MM-DD formatendDate(optional): YYYY-MM-DD formatwith_dfa_alpha1(optional): Boolean - if true, includes the DFA alpha 1 and aerobic/anaerobic threshold fields per activity
Returns:
- Array of running activities with summary metrics
id: the activity id - pass it asactivityIdtogetRunningActivityDetailorsetActivityFlags- Activity name, date, duration,
gradient_adjusted_pace(GAP - the only pace reported for runs), heart rate, running power, weather
getSwimmingActivity
List recent swimming activities. Returns up to 40 most recent swims if no date range specified.
Parameters:
startDate(optional): YYYY-MM-DD formatendDate(optional): YYYY-MM-DD format
Returns:
- Array of swimming activities with summary metrics
id: the activity id - pass it asactivityIdtogetSwimmingActivityDetail- Activity name, date, duration, distance, pace, stroke rate
getCyclingActivityDetail
Detailed data for one cycling activity. The default response is deliberately light; the durability, power-curve and raw sample data are each opt-in.
Parameters:
activityId: the activity id (theidfield of agetCyclingActivityresult)with_dfa_alpha1(optional): Boolean - adds the DFA alpha 1 threshold values anddurability_driftwith_power_curve(optional): Boolean - adds the peak power curve, % of recent best, effort structure andwithin_session_durabilitywith_time_series_metrics(optional): Boolean - adds the raw per-sample arrays. Default falseresolution(optional): sampling for the raw arrays, so it has no effect unlesswith_time_series_metricsis true"low": ~200 points, ~5KB, ~1,250 tokens (default)"medium": ~500 points, ~12KB, ~3,000 tokens"high": ~1000 points, ~25KB, ~6,250 tokens"full": All data points (18k-125k tokens - use sparingly!)
Returns by default:
idand the complete activity metadata (date, duration, distance, average power/HR, stress scores, weather, the activity flags)laps: the device laps the head unit recorded, with per-lap power, HR, cadence and respiration
With with_dfa_alpha1:
- The aerobic/anaerobic threshold values, the a1 scalars, and each lap's average a1
durability_drift: how this ride's internal drift (heart rate, DFA a1, respiration frequency) sat against your own fitted ~6-week trend at matched work - mean residual, position versus the confidence band, the trend's %-loss at the anchors, and the number of rides behind the trend. Each metric also carries a plainverdict(more_durable,less_durable,typicalormixed; null when that metric has too few efforts in the ride to support a claim), and the object carries anoverallverdict across the metrics that have one. Needs clean R-R, so it is absent on rides without it
With with_power_curve:
power_curveandpct_of_recent_best(percent of your recent best at each duration)effort_structure: time spent by intensity band and bout lengthwithin_session_durability: how far sustained power fell off as work accumulated within the ride, along the ride's own kJ axis. Needs no HRV, so it is available on essentially any ride with power
With with_time_series_metrics:
- The raw per-sample arrays: power, heart rate, cadence, altitude, respiration frequency (plus the a1 channels when
with_dfa_alpha1is also set), sampled toresolution
getRunningActivityDetail
Detailed data for one running activity. Same opt-in structure as the cycling detail tool.
Parameters:
activityId: the activity id (theidfield of agetRunningActivityresult)with_dfa_alpha1(optional): Boolean - adds the DFA alpha 1 threshold values anddurability_driftwith_power_curve(optional): Boolean - adds the peak GAP-pace and running-power curves, % of recent best, effort structure andwithin_session_durabilitywith_time_series_metrics(optional): Boolean - adds the raw per-sample arrays. Default falseresolution(optional): sampling for the raw arrays (same as cycling), so it has no effect unlesswith_time_series_metricsis true
Returns by default:
idand the complete activity metadata (date, duration, distance, average pace/power/HR, stress scores, weather, the activity flags)laps: the device laps the watch recorded, with per-lapavg_pace_device(the watch's raw pace, not GAP), power, HR, cadence and respiration
With with_dfa_alpha1:
- The aerobic/anaerobic threshold values, the a1 scalars, and each lap's average a1
durability_drift: this run's internal drift (heart rate, DFA a1, respiration frequency) against your own fitted ~6-week trend at matched work, with the same per-metricverdictandoverallverdict as the cycling tool. Needs clean R-R, so it is absent on runs without it
With with_power_curve:
pace_curve,running_power_curveandpct_of_recent_besteffort_structure: time spent by intensity band and bout lengthwithin_session_durability, split by channel (gapfor GAP pace,powerfor running power): how far sustained pace or power fell off as distance accumulated within the run, along its own GAP-km axis. Needs no HRV, so it is available on essentially any run
With with_time_series_metrics:
- The raw per-sample arrays:
gap(the GAP stream, with its unit ingap_unit), heart rate, running power, altitude, cadence, respiration frequency (plus the a1 channels whenwith_dfa_alpha1is also set), sampled toresolution
getSwimmingActivityDetail
Detailed metrics for specific swimming activity including time-series data (pace, stroke rate, distance per stroke).
Parameters:
activityId: the activity id (theidfield of agetSwimmingActivityresult)with_time_series_metrics(optional): Boolean - adds the raw per-sample arrays. Default falseresolution(optional): sampling for the raw arrays (same as cycling), so it has no effect unlesswith_time_series_metricsis true
Returns:
- Complete activity metadata
- Time-series metrics: pace, stroke rate, distance per stroke, pool length
- Lap-by-lap breakdown
- Stroke analysis
analyzeActivityStream
Computes quantitative analytics for one activity server-side and returns a compact summary. Prefer this over the detail tools whenever you want numbers - normalized power, intensity factor, variability, time-in-zone, pacing/fade (first vs second half), or channel extremes (avg/max/min power, heart rate, cadence, pace). Not for durability, DFA alpha 1 thresholds, or the mean-max curve - those live behind the detail tools' opt-in flags.
Parameters:
activityId: the activity id (theidfield of an activity list result)activityType: "Ride", "Run" or "Swim"segments(optional): "auto" (default) adds a small table of equal time-window splits (avg power/speed + HR per window); "none" skips it. These are computed windows, not the device laps.range(optional):{"type": "time_seconds", "from": seconds, "to": seconds}restricts the whole analysis to a time window - e.g. the first 30 minutes, or one device lap via the detail tools'start_s/end_s
Returns (blocks omitted when the activity lacks the data):
- Overview: moving/elapsed time, distance, elevation gain
power: avg/max/min, normalized power, variability index, intensity factorheart_rate,cadence, and the pace channel:gap_m_per_sfor runs (GAP),pace_m_per_sfor swimspacing: first vs second half averages andfade_pct(positive = second half lower power / slower; terrain-naive, so check the per-half ascent/descent before calling a fade physiological)time_in_zoneandsegments
getOtherActivity
List activities from any sport outside running, cycling, and swimming - strength training, cross-country skiing, yoga, hiking, walking. Returns the 20 most recent if no date range specified, up to 40 with a date range.
Parameters:
startDate(optional): YYYY-MM-DD formatendDate(optional): YYYY-MM-DD format
Returns:
- Array of activities with name, type, date, duration, average heart rate, stress scores, elevation gain, distance, calories
Note: other activities are duration-only. There is no time-series/stream data and no detail tool for them, so do not expect power, pace, HRV, or per-second metrics.
Activity Flags
setActivityFlags
Set per-activity flags on a cycling or running activity: indoor, virtual, erg mode, and read-time analysis exclusions. Use when an activity was misdetected (an indoor ride treated as outdoor) or when bad sensor data should be kept out of the analyses. Only the flags you pass change; the others stay untouched.
Parameters:
activityId: the activity id (theidfield of agetCyclingActivity/getRunningActivityresult)sport: "cycling" or "running"isIndoor(optional): Activity was performed indoors (trainer/treadmill/virtual). Also swaps the stored weather to the indoor marker, or re-fetches outdoor weather when flipped back to outdoor.isVirtual(optional): Virtual ride/run (Zwift, Rouvy, etc.). Implies indoor.isErgMode(optional): Recorded in erg mode (the trainer controls power)excludeFromCurves(optional): Exclude from aggregate power/pace-duration curves and recent-best comparisons (e.g. power meter malfunction)excludeFromModel(optional): Exclude from digital twin (GRU) model training dataexcludeFromDurability(optional): Exclude from durability curve aggregationexcludeHrData(optional): Heart rate data is unreliable (e.g. strap failure) - excludes the activity from HRV/alpha 1 aggregation and from model training while keeping the power/pace analyses
Returns:
- Success confirmation and a human-readable summary of what changed
flags: current values of all seven flags after the updateretrain_queued: whether the change queued a digital twin retrain (excludeFromModelandexcludeHrDatado;excludeHrDataadditionally rebuilds the stored HRV aggregates)
Notes: flags you set by hand are pinned, so later automatic detection will not overwrite them. The flag values are also returned on every activity in the getCyclingActivity / getRunningActivity list and detail results.
Analytics & Insights
getRaceGoalEvent
View primary and secondary race goal events with performance predictions and priorities.
Returns:
- Primary race goal (name, date, distance, priority, predicted time)
- Secondary race goals (if configured)
- Days until each race
- Target finish times
getPrediction
ML-based performance predictions including future forecasts, historical data, and model validation metrics.
Returns:
- Future predictions (next 12 weeks of fitness trajectory)
- Historical predictions (actual vs predicted comparison)
- Model validation scores
- Confidence intervals
- Training impact on predictions
getRecoveryModel
Recovery model data including:
- Cardio recovery score
- DFA alpha 1 (cardiac autonomic metric from HRV analysis)
- rMSSD (heart rate variability - parasympathetic activity)
- Resting heart rate trends
- External stress score
- Orthopedic recovery (joint/muscle recovery for cycling, running, swimming)
Parameters:
days_back(optional): How many days of daily recovery data to return, 1-90 (defaults to 14)
Returns:
- Time-series data showing recovery trends (past 14 days by default)
- Current recovery status
- Recovery drivers (what's limiting recovery today)
- Activity-specific orthopedic recovery
getPlanProgress
Training plan progress showing adherence to prescribed training zones.
Returns:
- Match percentage (overall plan adherence)
- Zone-by-zone breakdown:
- Endurance: actual hours vs prescribed hours
- Tempo: actual vs prescribed
- Threshold: actual vs prescribed
- VO2Max: actual vs prescribed
- Anaerobic: actual vs prescribed
- For triathletes: separate progress for Ride, Run, Swim
getNutritionModel
Retrieves the user nutrition model with daily calorie and macronutrient requirements (protein, fat, carbohydrates) including lower and upper bounds.
Returns:
- Daily calorie and macronutrient requirements for 6 days (1 past day + today + 5 future days)
- Protein requirements (lower and upper bounds in grams)
- Fat requirements (lower and upper bounds in grams)
- Carbohydrate requirements (lower and upper bounds in grams)
- Based on planned workouts and user physiology
Authentication & Security
OAuth 2.0 Flow
- AI assistant initiates OAuth flow
- User redirected to AI Endurance authorization page
- User signs in with AI Endurance credentials
- User grants "read" scope access
- AI Endurance returns authorization code
- AI assistant exchanges code for access token
- All API requests authenticated via Bearer token
Scopes
- read: View training data, workouts, activities, zones, predictions, and recovery metrics
- write: Create, modify, and delete workouts; update training zones; manage workout schedule
Data Access
The MCP server has access to:
- User profile and preferences
- Training zones (view and modify)
- Planned workouts (view, modify schedule, create new)
- Activity history (cycling, running, swimming)
- Performance predictions
- Recovery metrics
- Race goals
The MCP server cannot:
- Start training plan generation
- Create or modify date-range data exclusions (per-activity flags are settable with
setActivityFlags) - Alter your connections to third-party platforms (Garmin, Strava, etc.)
- Delete your account
- Modify account billing settings
- Access payment information
- Delete historical activities (can only skip future workouts)
Revocation
Disconnect access anytime in your mcp client.
Technical Specifications
- Protocol Version: MCP 2025-06-18
- Transport: Streamable HTTP (preferred) or SSE (legacy)
- Authentication: OAuth 2.0
- Message Format: JSON-RPC 2.0
- Tool Results: every tool declares an
outputSchema. A successfultools/callresult returns the JSON in acontenttext block and, identically, instructuredContent, which conforms to that schema. Results withisError: truecarry the message incontentonly. - Base URL: https://aiendurance.com/mcp
- Messages Endpoint: https://aiendurance.com/mcp/messages
- Manifest: https://aiendurance.com/.well-known/ai-plugin.json
Rate Limits
No explicit rate limits currently enforced. Standard API usage guidelines apply - avoid excessive requests in short time periods.
Error Handling
Errors returned in MCP-compliant format:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [{
"type": "text",
"text": "Error message here"
}],
"isError": true
}
}
Common error codes:
- 401: Authentication required or token expired
- 403: Insufficient permissions
- 404: Workout/activity not found
- 422: Validation error (invalid parameters)
- 500: Internal server error
Platform Compatibility
Tested & Working
- ChatGPT (web, iOS, Android - from the plugin directory, with interactive widgets)
- Claude.ai (web interface)
- Claude Desktop (macOS)
Compatible (not officially tested)
- Any MCP 2025-06-18 compliant client using Streamable HTTP or SSE transport
- Cursor, Continue, Cline (developer tools)
- Clients that validate results against
outputSchema, such as the LiteLLM MCP proxy and Hermes Agent - Custom MCP client implementations
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.