Skip to content

MCP Tools Reference

Cadence exposes 75 MCP tools organized into categories. Tools are automatically gated by feature flags and connected devices.

Coaching Tools (Cross-Platform)

Intelligent tools prefixed with coach_ that auto-select the best data source.

Tool Parameters Description
coach_get_health_snapshot Combined daily overview: recovery, sleep, strain, HRV, resting HR, body battery, readiness, recent activities. Call first.
coach_get_readiness date? Training readiness (green/yellow/red) from recovery, sleep, and strain. Use before recommending sessions.
coach_get_weekly_summary weeks=1 Weekly training summary: running volume, strength sessions, recovery/strain trends, HRV.
coach_get_hrv_trend days=30 HRV trend with direction. Flags 3+ day declines.
coach_correlate_sleep_performance days=30, max_lag=3 Sleep-recovery correlation with lag analysis (delayed effects).
coach_get_device_status Connected devices, status, workout storage, goals.
coach_get_goal_progress days=28 Progress toward fitness goals: VO2max, strength frequency, longevity biomarkers.
coach_check_injury_risk Injury risk from load, recovery, sleep, HRV, volume spikes. Returns low/moderate/high.
coach_compare_weeks weeks_ago=1 Current vs. previous week side-by-side with deltas.

Briefing Tools

Tool Parameters Description
get_daily_brief Combined daily health overview from all devices. First tool to call.
get_readiness date? Training readiness assessment from primary device.
get_device_status Check connected devices and their status.

Activity Tools

Tool Parameters Description
get_activities days=7 Recent activities from all sources, merged and deduplicated.
get_activity_detail activity_id, source? Splits, HR zones, laps for a single activity.

Sleep Tools

Tool Parameters Description
get_sleep date? Last night's sleep: stages, duration, efficiency, quality. Auto-selects WHOOP > Garmin.
get_sleep_trend days=7 Multi-day sleep for trend analysis and debt detection.

Recovery Tools

Tool Parameters Description
get_recovery date? Today's recovery (WHOOP 0-100 or Garmin Body Battery).
get_recovery_trend days=7 Multi-day recovery trend. Consecutive lows signal overtraining.
get_hrv_trend days=30 HRV trend with direction analysis.

Running Tools

Tool Parameters Description
get_running_volume weeks=4 Weekly running km with 10% spike detection.
get_vo2max include_trend=false, trend_days=90 Current VO2max with optional historical trend.
get_athlete_stats All-time/YTD/recent totals (Strava only).

Training Load Tools

Tool Parameters Description
get_training_load date? Today's strain (WHOOP 0-21 or Garmin training status).
check_injury_risk ACWR, sleep debt, HRV decline, volume spike assessment.
compare_weeks weeks_ago=1 Current vs. previous week comparison.

Body Tools

Tool Parameters Description
get_body_composition date? Weight, body fat, muscle mass, fitness age (Garmin).
get_resting_hr days=30 Daily resting heart rate history.
get_stress date? Stress levels with zone breakdowns.

Review Tools

Tool Parameters Description
get_weekly_summary weeks=1 Aggregated weekly summary across all sources.
get_goal_progress days=28 Multi-week goal tracking with trends.

Zone Tools

Tool Parameters Description
get_training_zones HR and power zone boundaries (Strava).

Chart Tools

Tool Parameters Description
render_chart chart_type, title, x_label, y_label, datasets, x_values, ... Render interactive chart (line/bar/doughnut/radar/scatter) in chat UI.

Strength & Workout Tools

Tool Parameters Description
save_strength_workout date, workout_name, exercises[], notes? Log workout. Auto-enriches with wearable data.
get_strength_history days=7 Recent workouts with wearable data merged.
get_strength_progression exercise_name?, days=90 Progressive overload tracking (fuzzy match).
get_personal_records days=365 Heaviest lifts per exercise with estimated 1RM.
get_strength_insights days=28 Frequency, recovery, split balance, volume trends.
db_list_exercises User's exercise library.
db_get_workout_history days=7 Stored workout history.
db_save_workout date, workout_name, exercises[], notes? Save workout to DB or Notion.
db_get_strength_progression exercise_name?, days=90 Track progressive overload.
db_get_personal_records days=365 Personal records with 1RM estimates.
db_migrate_to_notion Migrate workouts to Notion.
db_migrate_from_notion Migrate workouts from Notion.

Garmin-Specific Tools

All prefixed with garmin_. See Garmin integration for the full list (19 tools).

WHOOP-Specific Tools

All prefixed with whoop_. See WHOOP integration for the full list (11 tools).

Strava-Specific Tools

All prefixed with strava_. See Strava integration for the full list (4 tools).