intervals-icu-mcp-server 0.3.0 → 0.5.0

package/README.md

@@ -78,10 +78,16 @@ Add to `~/.claude/settings.json`:
 ### Athlete
 | Tool | Description |
 |------|-------------|
+| `list_athletes` | List athletes you follow or coach (including yourself) — find athlete IDs for a coach account |
 | `get_athlete_profile` | FTP, LTHR, weight, VO2max, resting HR |
 | `get_athlete_zones` | Power, HR and pace training zones |
 | `get_athlete_summary` | Current CTL, ATL, TSB and ramp rate snapshot |
 
+**Coach accounts:** every tool accepts an optional `athlete_id` argument that overrides the
+`ATHLETE_ID` env var for that call. Log in with a coach's `API_KEY`, call `list_athletes` to get
+IDs for the athletes they coach, then pass `athlete_id: "iXXXXX"` on any tool call to work with
+that specific athlete — no need to swap accounts or `.env` files.
+
 ### Calendar Events
 | Tool | Description |
 |------|-------------|

package/dist/client.d.ts

@@ -86,6 +86,19 @@ export declare const ActivitySchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     compliance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_chat_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    coasting_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_cp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_pm_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_max_wbal_depletion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_joules_above_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_ingested: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    avg_lr_balance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -169,6 +182,19 @@ export declare const ActivitySchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     compliance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_chat_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    coasting_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_cp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_pm_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_max_wbal_depletion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_joules_above_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_ingested: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    avg_lr_balance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -252,6 +278,19 @@ export declare const ActivitySchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     compliance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_chat_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    coasting_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_cp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    ss_p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_pm_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_w_prime: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    p_max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_max_wbal_depletion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_joules_above_ftp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    carbs_ingested: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    avg_lr_balance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.ZodTypeAny, "passthrough">>;
 export type Activity = z.infer<typeof ActivitySchema>;
 export declare const WellnessSchema: z.ZodObject<{
@@ -459,6 +498,8 @@ export declare const AthleteSchema: z.ZodObject<{
     country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     icu_resting_hr: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_coach: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    icu_permission: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -470,6 +511,8 @@ export declare const AthleteSchema: z.ZodObject<{
     country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     icu_resting_hr: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_coach: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    icu_permission: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -481,6 +524,8 @@ export declare const AthleteSchema: z.ZodObject<{
     country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     icu_resting_hr: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     icu_weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    icu_coach: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    icu_permission: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
 export type Athlete = z.infer<typeof AthleteSchema>;
 export declare const SportSettingsSchema: z.ZodObject<{
@@ -639,6 +684,7 @@ export declare function createEvent(config: ClientConfig, input: EventInput): Pr
 export declare function updateEvent(config: ClientConfig, eventId: string, input: EventInput): Promise<Event>;
 export declare function deleteEvent(config: ClientConfig, eventId: string): Promise<void>;
 export declare function getAthleteProfile(config: ClientConfig): Promise<Athlete>;
+export declare function listAthletes(config: ClientConfig): Promise<Athlete[]>;
 export declare function getAthleteZones(config: ClientConfig): Promise<SportSettings[]>;
 export declare function getAthleteSummary(config: ClientConfig): Promise<AthleteFitness | undefined>;
 export declare function getWellnessDay(config: ClientConfig, date: string): Promise<Wellness>;

package/dist/client.js

@@ -84,6 +84,19 @@ export const ActivitySchema = z.object({
     source: z.string().nullable().optional(),
     compliance: z.number().nullable().optional(),
     icu_chat_id: z.number().nullable().optional(),
+    coasting_time: z.number().nullable().optional(),
+    ss_cp: z.number().nullable().optional(),
+    ss_w_prime: z.number().nullable().optional(),
+    ss_p_max: z.number().nullable().optional(),
+    icu_pm_ftp: z.number().nullable().optional(),
+    icu_w_prime: z.number().nullable().optional(),
+    p_max: z.number().nullable().optional(),
+    icu_max_wbal_depletion: z.number().nullable().optional(),
+    icu_joules_above_ftp: z.number().nullable().optional(),
+    icu_weight: z.number().nullable().optional(),
+    carbs_used: z.number().nullable().optional(),
+    carbs_ingested: z.number().nullable().optional(),
+    avg_lr_balance: z.number().nullable().optional(),
 }).passthrough();
 export const WellnessSchema = z.object({
     id: z.string().optional(),
@@ -148,6 +161,10 @@ export const AthleteSchema = z.object({
     country: z.string().nullable().optional(),
     icu_resting_hr: z.number().nullable().optional(),
     icu_weight: z.number().nullable().optional(),
+    icu_coach: z.boolean().nullable().optional(),
+    // Present only on entries returned by /athletes: the caller's access level on this athlete
+    // (NONE/READ/WRITE for someone they follow/coach, absent for their own profile).
+    icu_permission: z.string().nullable().optional(),
 }).passthrough();
 export const SportSettingsSchema = z.object({
     types: z.array(z.string()).nullable().optional(),
@@ -280,6 +297,12 @@ export async function getAthleteProfile(config) {
     const data = await request(`/athlete/${config.athleteId}`, config);
     return AthleteSchema.parse(data);
 }
+// Requires an API_KEY (not a bearer token). Athlete ID in `config` is ignored — this call
+// is not athlete-scoped, it lists everyone the key's account follows or coaches.
+export async function listAthletes(config) {
+    const data = await request(`/athletes`, config);
+    return z.array(AthleteSchema).parse(data);
+}
 export async function getAthleteZones(config) {
     const data = await request(`/athlete/${config.athleteId}/sport-settings`, config);
     return z.array(SportSettingsSchema).parse(data);

package/dist/format.js

@@ -23,7 +23,9 @@ export function formatActivity(a) {
         "Power:",
         `  Avg: ${n(a.icu_average_watts, " W")} | Weighted Avg: ${n(a.icu_weighted_avg_watts, " W")} | FTP: ${n(a.icu_ftp, " W")}`,
         `  Training Load: ${n(a.icu_training_load)} | Intensity: ${n(a.icu_intensity)} | VI: ${n(a.icu_variability_index)}`,
-        `  Critical Power: ${n(a.icu_pm_cp, " W")} | Rolling FTP: ${n(a.icu_rolling_ftp, " W")} | Energy: ${a.icu_joules != null ? `${Math.round(a.icu_joules / 1000)} kJ` : "N/A"}`,
+        `  Critical Power: ${n(a.icu_pm_cp, " W")} | Rolling FTP: ${n(a.icu_rolling_ftp, " W")} | Activity eFTP: ${n(a.icu_pm_ftp, " W")}`,
+        `  Energy: ${a.icu_joules != null ? `${Math.round(a.icu_joules / 1000)} kJ` : "N/A"} | Above FTP: ${a.icu_joules_above_ftp != null ? `${Math.round(a.icu_joules_above_ftp / 1000)} kJ` : "N/A"}`,
+        `  W': ${n(a.icu_w_prime, " J")} | Pmax: ${n(a.p_max, " W")} | W'bal Drop: ${a.icu_max_wbal_depletion != null ? `${(a.icu_max_wbal_depletion / 1000).toFixed(1)} kJ` : "N/A"}`,
         "",
         "Heart Rate:",
         `  Avg: ${n(a.average_heartrate, " bpm")} | Max: ${n(a.max_heartrate, " bpm")}`,
@@ -41,7 +43,7 @@ export function formatActivity(a) {
             lines.push(`  HR: ${a.icu_hr_zone_times.map((secs, i) => `Z${i + 1} ${fmtDuration(secs)}`).join(" | ")}`);
         }
     }
-    lines.push("", "Other:", `  Cadence: ${n(a.average_cadence, " rpm")} | Calories: ${n(a.calories)} | Speed: ${n(a.average_speed, " m/s")} (max ${n(a.max_speed, " m/s")})`, `  Temp: ${n(a.average_temp, "°C")} | Trainer: ${a.trainer ? "Yes" : "No"}`, `  RPE: ${n(a.icu_rpe ?? a.perceived_exertion)}/10 | Feel: ${n(a.feel)}/5`, "", "Fitness:", `  CTL: ${n(a.icu_ctl)} | ATL: ${n(a.icu_atl)} | TRIMP: ${n(a.trimp)} | Polarization Index: ${n(a.polarization_index)}`, `  Power Load: ${n(a.power_load)} | HR Load: ${n(a.hr_load)} | Strain: ${n(a.strain_score)}`, "", "Equipment:", `  Gear: ${n(a.gear?.name)} | Device: ${n(a.device_name)} | Power Meter: ${n(a.power_meter)}`, `  Source: ${n(a.source)} | Compliance: ${a.compliance != null ? `${a.compliance}%` : "N/A"}`);
+    lines.push("", "Other:", `  Cadence: ${n(a.average_cadence, " rpm")} | Calories: ${n(a.calories)} | Speed: ${n(a.average_speed, " m/s")} (max ${n(a.max_speed, " m/s")})`, `  Temp: ${n(a.average_temp, "°C")} | Trainer: ${a.trainer ? "Yes" : "No"} | Coasting: ${fmtDuration(a.coasting_time)}`, `  RPE: ${n(a.icu_rpe ?? a.perceived_exertion)}/10 | Feel: ${n(a.feel)}/5 | S-RPE: ${n(a.session_rpe)}`, `  L/R Balance: ${a.avg_lr_balance != null ? `${(100 - a.avg_lr_balance).toFixed(0)}/${a.avg_lr_balance.toFixed(0)}` : "N/A"}`, "", "Fitness:", `  CTL: ${n(a.icu_ctl)} | ATL: ${n(a.icu_atl)} | TRIMP: ${n(a.trimp)} | Polarization Index: ${n(a.polarization_index)}`, `  Power Load: ${n(a.power_load)} | HR Load: ${n(a.hr_load)} | Strain: ${n(a.strain_score)}`, `  SS CP: ${n(a.ss_cp, " W")} | SS W': ${n(a.ss_w_prime)} | SS Pmax: ${n(a.ss_p_max)}`, `  Weight: ${n(a.icu_weight, " kg")} | CHO Used: ${n(a.carbs_used, " g")} | CHO In: ${n(a.carbs_ingested, " g")}`, "", "Equipment:", `  Gear: ${n(a.gear?.name)} | Device: ${n(a.device_name)} | Power Meter: ${n(a.power_meter)}`, `  Source: ${n(a.source)} | Compliance: ${a.compliance != null ? `${a.compliance}%` : "N/A"}`);
     if (a.description)
         lines.push("", `Description: ${a.description}`);
     return lines.join("\n");

package/dist/index.js

@@ -4,7 +4,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-import { getActivities, getActivityDetails, getActivityIntervals, getWellness, getEvents, getEventById, getNotesByDate, createEvent, updateEvent, deleteEvent, getAthleteProfile, getAthleteZones, getAthleteSummary, getWellnessDay, updateWellness, getActivityStreams, getActivityPowerCurves, listWorkouts, createWorkout, bulkCreateEvents, bulkDeleteEvents, getAthleteFitness, getActivityMessages, addActivityMessage, deleteActivityMessage, updateActivityMessage, } from "./client.js";
+import { getActivities, getActivityDetails, getActivityIntervals, getWellness, getEvents, getEventById, getNotesByDate, createEvent, updateEvent, deleteEvent, getAthleteProfile, getAthleteZones, getAthleteSummary, listAthletes, getWellnessDay, updateWellness, getActivityStreams, getActivityPowerCurves, listWorkouts, createWorkout, bulkCreateEvents, bulkDeleteEvents, getAthleteFitness, getActivityMessages, addActivityMessage, deleteActivityMessage, updateActivityMessage, } from "./client.js";
 import { formatActivity, formatWellness, formatEvent, formatIntervalRow, formatSportZones, formatMessage, } from "./format.js";
 function getConfig(args) {
     const apiKey = args["api_key"] ?? process.env.API_KEY ?? "";
@@ -17,6 +17,14 @@ function getConfig(args) {
         throw new Error("No athlete ID provided. Set ATHLETE_ID in .env or pass athlete_id.");
     return { apiKey, athleteId };
 }
+// list_athletes isn't athlete-scoped (it lists everyone the key's account can access), so it
+// only needs the API key — requiring athlete_id here would break coaches with no default athlete.
+function getApiKey(args) {
+    const apiKey = args["api_key"] ?? process.env.API_KEY ?? "";
+    if (!apiKey)
+        throw new Error("No API key provided. Set API_KEY in .env or pass api_key.");
+    return apiKey;
+}
 function toDateStr(d) {
     const y = d.getFullYear();
     const m = String(d.getMonth() + 1).padStart(2, "0");
@@ -175,6 +183,16 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "list_athletes",
+        description: "List athletes you follow or coach, including yourself. Use this with a coach account to find athlete IDs, then pass athlete_id on other tools (get_activities, get_wellness_data, get_events, etc.) to work with a specific athlete under that same account.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                api_key: { type: "string", description: "API key (defaults to API_KEY env var)" },
+            },
+        },
+    },
     {
         name: "get_athlete_profile",
         description: "Get athlete profile: name, sex, DOB, weight, resting HR, city/country. For FTP/LTHR/zones use get_athlete_zones.",
@@ -602,6 +620,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 await deleteEvent(config, eventId);
                 return { content: [{ type: "text", text: `Event ${eventId} deleted.` }] };
             }
+            case "list_athletes": {
+                const apiKey = getApiKey(args);
+                const athletes = await listAthletes({ apiKey, athleteId: "" });
+                if (!athletes.length)
+                    return { content: [{ type: "text", text: "No athletes found." }] };
+                const lines = athletes.map((a) => {
+                    const perm = a.icu_permission ? ` [${a.icu_permission}]` : " (self)";
+                    const coach = a.icu_coach ? " · coach" : "";
+                    const email = a.email ? ` · ${a.email}` : "";
+                    return `- **${a.name ?? "Unnamed"}** — id: ${a.id}${perm}${coach}${email}`;
+                });
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
             case "get_athlete_profile": {
                 const config = getConfig(args);
                 const athlete = await getAthleteProfile(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intervals-icu-mcp-server",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "MCP server for Intervals.icu — 26 tools for activities, wellness, calendar events, workouts and more",
   "type": "module",
   "bin": {