ergzone-mcp 1.1.0 → 1.2.1

package/README.md

@@ -16,9 +16,9 @@ You need a Concept2 Logbook account (the one you use on log.concept2.com).
 
 1. Download `ergzone-mcp.mcpb` from the [latest release](https://github.com/malveo/ergzone-mcp/releases/latest).
 2. Double-click it (or drag it into Claude Desktop → Settings → Extensions).
-3. Type your Logbook email and password in the form. Done.
+3. Type your Logbook email and password in the form, and make sure the extension is **enabled**. Done.
 
-Nothing to install — no Node, no terminal, no config files.
+Nothing to install — no Node, no terminal, no config files. Full walkthrough with screenshots: [docs/claude-desktop.md](docs/claude-desktop.md).
 
 ### Claude Code (terminal)
 
@@ -63,7 +63,19 @@ Prefer not to store your password? Use `ERGZONE_SESSION_TOKEN` instead (copied f
 | `list_my_results` / `get_result` | your sessions + telemetry |
 | `my_stats` / `analyze_result` | totals, HR zones, pace/SPI per interval |
 
-Ask in plain language, e.g. *"create an SPM ladder 16 to 30"* or *"analyze my last result"*.
+## Example prompts
+
+Just talk to Claude in plain language:
+
+- **Check it works** — *"Am I connected to ErgZone? Who am I?"*
+- **Browse** — *"List my ErgZone workouts."*
+- **Build (preview, nothing saved)** — *"Show me an SPM ladder from 16 to 30 spm, 1 min each."*
+- **Create** — *"Create a workout 'Tuesday tempo' with 3 × 2 min at 22 spm, 1 min rest."*
+- **Progressive intensity** — *"Build a workout: 2 blocks of 1-2-1-3-1-4 minutes, each interval 0.1s/500m faster than the previous, 4 min rest between blocks."*
+- **Results** — *"Show my last few ErgZone results."*
+- **Analysis** — *"Analyze my last result: pace, SPI and HR zone per interval."*
+- **Stats** — *"How many meters did I row this month?"*
+- **Tidy up** — *"Delete the workout 'Tuesday tempo'."*
 
 ## Settings
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ergzone-mcp",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Unofficial MCP server for ErgZone (Concept2 rowing). Zero runtime dependencies.",
   "type": "module",
   "bin": {

package/src/client.mjs

@@ -14,7 +14,6 @@ const LOGBOOK = {
   password: process.env.ERGZONE_LOGBOOK_PASSWORD || null,
 };
 
-export const DEFAULT_TRACK_ID = process.env.ERGZONE_TRACK_ID || '';
 export const WRITE_ENABLED = process.env.ERGZONE_ALLOW_WRITE !== 'false';
 
 // Normalized error: kind = config | network | auth | infra | graphql
@@ -109,3 +108,24 @@ export function todayISO() {
   const p = (n) => String(n).padStart(2, '0');
   return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
 }
+
+// Resolve the track to use, in order: explicit arg -> ERGZONE_TRACK_ID -> auto-discover
+// the user's personal "My Workouts" track. Discovery result is cached in memory.
+let trackIdCache = null;
+export async function resolveTrackId(explicit) {
+  if (explicit) return explicit;
+  if (process.env.ERGZONE_TRACK_ID) return process.env.ERGZONE_TRACK_ID;
+  if (trackIdCache) return trackIdCache;
+
+  const data = await gql('query{ tracks(onlyAdmin:true){ id name trackMode type isOwner } }');
+  const tracks = data.tracks || [];
+  const personal =
+    tracks.find((t) => t.trackMode === 'single-user' && t.isOwner) ||
+    tracks.find((t) => t.type === 'private') ||
+    tracks[0];
+  if (!personal) {
+    throw new ErgzoneError('No personal track found. Set ERGZONE_TRACK_ID.', { kind: 'config' });
+  }
+  trackIdCache = personal.id;
+  return trackIdCache;
+}

package/src/tools.mjs

@@ -1,7 +1,7 @@
 // MCP tool definitions (Tier 1: core training + builder + basic analysis).
 // Each tool: { name, description, inputSchema, handler, write?, destructive? }
 
-import { gql, todayISO, DEFAULT_TRACK_ID } from './client.mjs';
+import { gql, todayISO, resolveTrackId } from './client.mjs';
 import { resolveIntervals, validateIntervals } from './intervals.mjs';
 
 // ---- analysis helpers ----
@@ -47,18 +47,17 @@ export const TOOLS = [
 
   {
     name: 'list_workouts',
-    description: 'List the workouts in a track (default: My Workouts). Optional filters: search, limit.',
+    description: 'List the workouts in a track (defaults to your "My Workouts" track, auto-detected). Optional filters: search, limit.',
     inputSchema: {
       type: 'object',
       properties: {
-        trackId: { type: 'string', description: 'Track ID (default from ERGZONE_TRACK_ID)' },
+        trackId: { type: 'string', description: 'Track ID (default: auto-detected My Workouts)' },
         search: { type: 'string' },
         limit: { type: 'number', default: 50 },
       },
     },
     async handler({ trackId, search, limit = 50 }) {
-      const t = trackId || DEFAULT_TRACK_ID;
-      if (!t) throw new Error('No trackId (pass trackId or set ERGZONE_TRACK_ID).');
+      const t = await resolveTrackId(trackId);
       const d = await gql(
         `query($t:[ID],$s:String){ workouts(trackIds:$t, search:$s){ id title status publishedAt intervalsLength workoutResultsCount } }`,
         { t: [t], s: search || null },
@@ -127,8 +126,7 @@ export const TOOLS = [
       required: ['title'],
     },
     async handler(args) {
-      const trackId = args.trackId || DEFAULT_TRACK_ID;
-      if (!trackId) throw new Error('No trackId (pass trackId or set ERGZONE_TRACK_ID).');
+      const trackId = await resolveTrackId(args.trackId);
       const intervals = resolveIntervals(args);
       const errors = validateIntervals(intervals);
       if (errors.length) throw new Error('Invalid intervals: ' + errors.join('; '));
@@ -173,8 +171,7 @@ export const TOOLS = [
       required: ['id'],
     },
     async handler(args) {
-      const trackId = args.trackId || DEFAULT_TRACK_ID;
-      if (!trackId) throw new Error('No trackId.');
+      const trackId = await resolveTrackId(args.trackId);
 
       // Fetch the current state for the fields that are not provided.
       const cur = await gql(`query($id:ID!){ workout(id:$id){ title status publishedAt workoutType description } }`, { id: args.id });