get-athlete-zones

Instructions

Implementation Reference

• src/tools/getAthleteZones.ts:63-113 (handler)

  The 'execute' function implementation for the 'get-athlete-zones' tool. It fetches athlete zones from Strava using the provided token, formats the result, and returns it.

      execute: async (_input: GetAthleteZonesInput) => {
          const token = process.env.STRAVA_ACCESS_TOKEN;
  
          if (!token) {
              console.error("Missing STRAVA_ACCESS_TOKEN environment variable.");
              return {
                  content: [{ type: "text" as const, text: "Configuration error: Missing Strava access token." }],
                  isError: true
              };
          }
  
          try {
              console.error("Fetching athlete zones...");
              const zonesData = await fetchAthleteZones(token);
              
              // Format the summary
              const formattedText = formatAthleteZones(zonesData);
              
              // Prepare the raw data
              const rawDataText = `\n\nRaw Athlete Zone Data:\n${JSON.stringify(zonesData, null, 2)}`;
              
              console.error("Successfully fetched athlete zones.");
              // Return both summary and raw data
              return { 
                  content: [
                      { type: "text" as const, text: formattedText },
                      { type: "text" as const, text: rawDataText }
                  ]
              };
  
          } catch (error) {
              const errorMessage = error instanceof Error ? error.message : String(error);
              console.error(`Error fetching athlete zones: ${errorMessage}`);
              
              let userFriendlyMessage;
              // Check for common errors like missing scope (403 Forbidden)
              if (errorMessage.includes("403")) {
                   userFriendlyMessage = "🔒 Access denied. This tool requires 'profile:read_all' permission. Please re-authorize with the correct scope.";
              } else if (errorMessage.startsWith("SUBSCRIPTION_REQUIRED:")) { // In case Strava changes this later
                  userFriendlyMessage = `🔒 Accessing zones might require a Strava subscription. Details: ${errorMessage}`;
              } else {
                  userFriendlyMessage = `An unexpected error occurred while fetching athlete zones. Details: ${errorMessage}`;
              }
  
              return {
                  content: [{ type: "text" as const, text: `❌ ${userFriendlyMessage}` }],
                  isError: true
              };
          }
      }
  }; 

• src/tools/getAthleteZones.ts:9-11 (schema)

  Input schema definition for the 'get-athlete-zones' tool. It currently requires no input parameters.

  const inputSchema = z.object({}); 
  
  type GetAthleteZonesInput = z.infer<typeof inputSchema>;

• src/server.ts:166-170 (registration)

  Registration of the 'get-athlete-zones' tool with the MCP server.

  server.tool(
      getAthleteZonesTool.name, 
      getAthleteZonesTool.description,
      getAthleteZonesTool.inputSchema?.shape ?? {},
      getAthleteZonesTool.execute