intervals-icu-mcp-server 0.1.8 → 0.2.0

package/dist/client.d.ts

@@ -343,6 +343,34 @@ export declare function getActivities(config: ClientConfig, params: {
 }): Promise<Activity[]>;
 export declare function getActivityDetails(config: ClientConfig, activityId: string): Promise<Activity>;
 export declare function getActivityIntervals(config: ClientConfig, activityId: string): Promise<z.infer<typeof IntervalSchema>>;
+export declare const MessageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    athlete_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attachment_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: number | undefined;
+    name?: string | null | undefined;
+    type?: string | null | undefined;
+    athlete_id?: string | null | undefined;
+    created?: string | null | undefined;
+    content?: string | null | undefined;
+    attachment_url?: string | null | undefined;
+}, {
+    id?: number | undefined;
+    name?: string | null | undefined;
+    type?: string | null | undefined;
+    athlete_id?: string | null | undefined;
+    created?: string | null | undefined;
+    content?: string | null | undefined;
+    attachment_url?: string | null | undefined;
+}>;
+export type Message = z.infer<typeof MessageSchema>;
+export declare function getActivityMessages(config: ClientConfig, activityId: string): Promise<Message[]>;
+export declare function addActivityMessage(config: ClientConfig, activityId: string, content: string): Promise<void>;
 export declare function getWellness(config: ClientConfig, params: {
     startDate: string;
     endDate: string;

package/dist/client.js

@@ -138,13 +138,29 @@ export async function getActivityIntervals(config, activityId) {
     const data = await request(`/activity/${activityId}/intervals`, config);
     return IntervalSchema.parse(data);
 }
+export const MessageSchema = z.object({
+    id: z.number().optional(),
+    athlete_id: z.string().nullable().optional(),
+    name: z.string().nullable().optional(),
+    created: z.string().nullable().optional(),
+    type: z.string().nullable().optional(),
+    content: z.string().nullable().optional(),
+    attachment_url: z.string().nullable().optional(),
+});
+export async function getActivityMessages(config, activityId) {
+    const data = await request(`/activity/${activityId}/messages`, config);
+    return z.array(MessageSchema).parse(data);
+}
+export async function addActivityMessage(config, activityId, content) {
+    await mutate("POST", `/activity/${activityId}/messages`, config, { content });
+}
 export async function getWellness(config, params) {
     const data = await request(`/athlete/${config.athleteId}/wellness`, config, { oldest: params.startDate, newest: params.endDate });
     if (Array.isArray(data)) {
         const result = {};
         for (const entry of data) {
             const parsed = WellnessSchema.parse(entry);
-            const key = entry["date"] ?? parsed.id ?? String(Object.keys(result).length);
+            const key = parsed.id ?? String(Object.keys(result).length);
             result[key] = parsed;
         }
         return result;

package/dist/format.d.ts

@@ -1,6 +1,7 @@
-import type { Activity, Wellness, Event, SportSettings } from "./client.js";
+import type { Activity, Wellness, Event, SportSettings, Message } from "./client.js";
 export declare function formatActivity(a: Activity): string;
 export declare function formatWellness(date: string, w: Wellness): string;
 export declare function formatEvent(e: Event): string;
+export declare function formatMessage(m: Message): string;
 export declare function formatSportZones(s: SportSettings): string;
 export declare function formatIntervalRow(interval: Record<string, unknown>, idx: number): string;

package/dist/format.js

@@ -83,6 +83,10 @@ export function formatEvent(e) {
         .filter(Boolean)
         .join("\n");
 }
+export function formatMessage(m) {
+    const when = m.created ? new Date(m.created).toLocaleString() : "Unknown time";
+    return `**${m.name ?? "Unknown"}** (${when}): ${m.content ?? ""}`;
+}
 function zoneRanges(breakpoints, names) {
     const count = names?.length ?? (breakpoints?.length ?? 0) + 1;
     const ranges = [];
@@ -110,19 +114,23 @@ export function formatSportZones(s) {
         lines.push("");
     }
     if (s.hr_zones?.length) {
+        // Unlike power_zones (%FTP), hr_zones stores absolute bpm thresholds directly.
         lines.push(`HR Zones${s.lthr != null ? ` (LTHR: ${s.lthr}bpm)` : ""}:`);
         for (const z of zoneRanges(s.hr_zones, s.hr_zone_names)) {
-            const abs = s.lthr != null ? ` (${Math.round((s.lthr * z.from) / 100)}-${z.to != null ? Math.round((s.lthr * z.to) / 100) + "bpm" : "bpm+"})` : "";
-            const pct = z.to != null ? `${z.from}-${z.to}%` : `${z.from}%+`;
-            lines.push(`  ${z.name}: ${pct}${abs}`);
+            const pctFrom = s.lthr != null ? Math.round((z.from / s.lthr) * 100) : null;
+            const pctTo = s.lthr != null && z.to != null ? Math.round((z.to / s.lthr) * 100) : null;
+            const pct = pctFrom != null ? ` (${pctFrom}${pctTo != null ? "-" + pctTo : ""}% LTHR)` : "";
+            const bpm = z.to != null ? `${z.from}-${z.to} bpm` : `${z.from}+ bpm`;
+            lines.push(`  ${z.name}: ${bpm}${pct}`);
         }
         lines.push("");
     }
     if (s.pace_zones?.length) {
-        lines.push("Pace Zones (% of threshold pace):");
+        // Same as hr_zones — absolute thresholds, not percentages of threshold_pace.
+        lines.push(`Pace Zones${s.threshold_pace != null ? ` (Threshold: ${s.threshold_pace} m/s)` : ""}:`);
         for (const z of zoneRanges(s.pace_zones, s.pace_zone_names)) {
-            const pct = z.to != null ? `${z.from}-${z.to}%` : `${z.from}%+`;
-            lines.push(`  ${z.name}: ${pct}`);
+            const range = z.to != null ? `${z.from}-${z.to} m/s` : `${z.from}+ m/s`;
+            lines.push(`  ${z.name}: ${range}`);
         }
     }
     return lines.join("\n").trimEnd();

package/dist/index.js

@@ -4,8 +4,8 @@ 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, } from "./client.js";
-import { formatActivity, formatWellness, formatEvent, formatIntervalRow, formatSportZones, } from "./format.js";
+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, } 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 ?? "";
     const athleteId = args["athlete_id"] ??
@@ -17,18 +17,24 @@ function getConfig(args) {
         throw new Error("No athlete ID provided. Set ATHLETE_ID in .env or pass athlete_id.");
     return { apiKey, athleteId };
 }
+function toDateStr(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
 function today() {
-    return new Date().toISOString().slice(0, 10);
+    return toDateStr(new Date());
 }
 function daysAgo(n) {
     const d = new Date();
     d.setDate(d.getDate() - n);
-    return d.toISOString().slice(0, 10);
+    return toDateStr(d);
 }
 function daysFromNow(n) {
     const d = new Date();
     d.setDate(d.getDate() + n);
-    return d.toISOString().slice(0, 10);
+    return toDateStr(d);
 }
 const TOOLS = [
     {
@@ -125,7 +131,7 @@ const TOOLS = [
                 category: { type: "string", description: "Event category: WORKOUT, NOTE, RACE_A, RACE_B, RACE_C (race priority A/B/C — this is what makes it a race, there is no separate race flag), PLAN, HOLIDAY, SICK, INJURED, TARGET, and others" },
                 type: { type: "string", description: "Activity type: Ride, Run, Swim, WeightTraining, etc." },
                 distance: { type: "number", description: "Distance in meters (e.g. 100000 for 100km)" },
-                sub_type: { type: "string", description: "Race category/sub-type (e.g. A, B, C)" },
+                sub_type: { type: "string", description: "One of NONE, COMMUTE, WARMUP, COOLDOWN, RACE. Not race priority — that's set via category (RACE_A/RACE_B/RACE_C)." },
                 color: { type: "string", description: "Event color, e.g. '#1f77b4' (hex) or a named color like 'blue', 'green', 'sky'" },
                 workout_doc: { type: "object", description: "Pre-computed Intervals.icu workout_doc (as returned by get_event_by_id/list_workouts on an existing structured workout) to copy verbatim onto this event. Hand-written partial docs won't render correctly — prefer setting `description` with the Workout Builder syntax and omitting this field so Intervals.icu computes it." },
                 athlete_id: { type: "string", description: "Athlete ID (defaults to ATHLETE_ID env var)" },
@@ -148,7 +154,7 @@ const TOOLS = [
                 category: { type: "string", description: "New category" },
                 type: { type: "string", description: "New activity type" },
                 distance: { type: "number", description: "Distance in meters (e.g. 100000 for 100km)" },
-                sub_type: { type: "string", description: "Race category/sub-type (e.g. A, B, C)" },
+                sub_type: { type: "string", description: "One of NONE, COMMUTE, WARMUP, COOLDOWN, RACE. Not race priority — that's set via category (RACE_A/RACE_B/RACE_C)." },
                 color: { type: "string", description: "Event color, e.g. '#1f77b4' (hex) or a named color like 'blue', 'green', 'sky'" },
                 workout_doc: { type: "object", description: "Pre-computed Intervals.icu workout_doc to copy verbatim. Hand-written partial docs won't render correctly — prefer updating `description` with Workout Builder syntax instead." },
                 athlete_id: { type: "string", description: "Athlete ID (defaults to ATHLETE_ID env var)" },
@@ -276,6 +282,33 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "get_activity_messages",
+        description: "Get the comments/notes left on a specific activity (the chat thread shown under an activity in Intervals.icu, e.g. coach feedback).",
+        inputSchema: {
+            type: "object",
+            required: ["activity_id"],
+            properties: {
+                activity_id: { type: "string", description: "The activity ID" },
+                athlete_id: { type: "string", description: "Athlete ID (defaults to ATHLETE_ID env var)" },
+                api_key: { type: "string", description: "API key (defaults to API_KEY env var)" },
+            },
+        },
+    },
+    {
+        name: "add_activity_message",
+        description: "Post a comment/note on a specific activity (adds to the activity's chat thread in Intervals.icu).",
+        inputSchema: {
+            type: "object",
+            required: ["activity_id", "content"],
+            properties: {
+                activity_id: { type: "string", description: "The activity ID" },
+                content: { type: "string", description: "Comment text to post" },
+                athlete_id: { type: "string", description: "Athlete ID (defaults to ATHLETE_ID env var)" },
+                api_key: { type: "string", description: "API key (defaults to API_KEY env var)" },
+            },
+        },
+    },
     {
         name: "list_workouts",
         description: "List all workouts in the athlete's workout library.",
@@ -618,6 +651,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const curves = await getActivityPowerCurves(config, activityId);
                 return { content: [{ type: "text", text: `Power curves for activity ${activityId}:\n\n${JSON.stringify(curves, null, 2)}` }] };
             }
+            case "get_activity_messages": {
+                const activityId = z.string().parse(args["activity_id"]);
+                const config = getConfig(args);
+                const messages = await getActivityMessages(config, activityId);
+                if (!messages.length)
+                    return { content: [{ type: "text", text: "No comments on this activity." }] };
+                const text = messages.map(formatMessage).join("\n");
+                return { content: [{ type: "text", text }] };
+            }
+            case "add_activity_message": {
+                const activityId = z.string().parse(args["activity_id"]);
+                const content = z.string().parse(args["content"]);
+                const config = getConfig(args);
+                await addActivityMessage(config, activityId, content);
+                return { content: [{ type: "text", text: `Comment added to activity ${activityId}.` }] };
+            }
             case "list_workouts": {
                 const config = getConfig(args);
                 const workouts = await listWorkouts(config);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "intervals-icu-mcp-server",
-  "version": "0.1.8",
-  "description": "MCP server for Intervals.icu — 20 tools for activities, wellness, calendar events, workouts and more",
+  "version": "0.2.0",
+  "description": "MCP server for Intervals.icu — 24 tools for activities, wellness, calendar events, workouts and more",
   "type": "module",
   "bin": {
     "intervals-icu-mcp": "dist/index.js"