get-recent-activities

Instructions

Implementation Reference

• src/tools/getRecentActivities.ts:17-71 (handler)

  The 'execute' function within the 'getRecentActivities' object contains the logic to fetch recent activities, handle authentication, and format the output.

  execute: async ({ perPage }: GetRecentActivitiesInput) => {
    const token = process.env.STRAVA_ACCESS_TOKEN;
  
    // --- DEBUGGING: Print the token being used --- 
    console.error(`[DEBUG] Using STRAVA_ACCESS_TOKEN: ${token?.substring(0, 5)}...${token?.slice(-5)}`);
    // ---------------------------------------------
  
    if (!token || token === 'YOUR_STRAVA_ACCESS_TOKEN_HERE') {
      console.error("Missing or placeholder STRAVA_ACCESS_TOKEN in .env");
      // Use literal type for content item
      return {
        content: [{ type: "text" as const, text: "❌ Configuration Error: STRAVA_ACCESS_TOKEN is missing or not set in the .env file." }],
        isError: true,
      };
    }
  
    try {
      console.error(`Fetching ${perPage} recent activities...`);
      const athlete = await getAuthenticatedAthlete(token);
      const activities = await fetchActivities(token, perPage);
      console.error(`Successfully fetched ${activities?.length ?? 0} activities.`);
  
      if (!activities || activities.length === 0) {
         return {
           content: [{ type: "text" as const, text: " MNo recent activities found." }]
          };
      }
  
      const distanceFactor = athlete.measurement_preference === 'feet' ? 0.000621371 : 0.001;
      const distanceUnit = athlete.measurement_preference === 'feet' ? 'mi' : 'km';
  
      // Map to content items with literal type
      const contentItems = activities.map(activity => {
        const dateStr = activity.start_date ? new Date(activity.start_date).toLocaleDateString() : 'N/A';
        const distanceStr = activity.distance ? `${(activity.distance * distanceFactor).toFixed(2)} ${distanceUnit}` : 'N/A';
        // Ensure each item conforms to { type: "text", text: string }
        const item: { type: "text", text: string } = {
           type: "text" as const,
           text: `🏃 ${activity.name} (ID: ${activity.id ?? 'N/A'}) — ${distanceStr} on ${dateStr}`
          };
        return item;
      });
  
      // Return the basic McpResponse structure
      return { content: contentItems };
  
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
      console.error("Error in get-recent-activities tool:", errorMessage);
      return {
        content: [{ type: "text" as const, text: `❌ API Error: ${errorMessage}` }],
        isError: true,
      };
    }
  }

• src/tools/getRecentActivities.ts:5-7 (schema)

  Zod schema definition for validating the 'perPage' input parameter.

  const GetRecentActivitiesInputSchema = z.object({
    perPage: z.number().int().positive().optional().default(30).describe("Number of activities to retrieve (default: 30)"),
  });

• src/tools/getRecentActivities.ts:12-15 (registration)

  Tool definition including name, description, input schema, and execution handler.

  export const getRecentActivities = {
      name: "get-recent-activities",
      description: "Fetches the most recent activities for the authenticated athlete.",
      inputSchema: GetRecentActivitiesInputSchema,