Strava MCP Server

Instructions

Implementation Reference

• src/tools/getAthleteProfile.ts:9-52 (handler)

  The execute function inside the getAthleteProfile tool definition handles the tool logic, including Strava API client calls and error handling.

  execute: async () => { // No input parameters needed
    const token = process.env.STRAVA_ACCESS_TOKEN;
  
    if (!token || token === 'YOUR_STRAVA_ACCESS_TOKEN_HERE') {
      console.error("Missing or placeholder STRAVA_ACCESS_TOKEN in .env");
      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 athlete profile...");
      const athlete = await getAuthenticatedAthlete(token);
      console.error(`Successfully fetched profile for ${athlete.firstname} ${athlete.lastname} (ID: ${athlete.id}).`);
  
      const profileParts = [
        `👤 **Profile for ${athlete.firstname} ${athlete.lastname}** (ID: ${athlete.id})`,
        `   - Username: ${athlete.username || 'N/A'}`,
        `   - Location: ${[athlete.city, athlete.state, athlete.country].filter(Boolean).join(", ") || 'N/A'}`,
        `   - Sex: ${athlete.sex || 'N/A'}`,
        `   - Weight: ${athlete.weight ? `${athlete.weight} kg` : 'N/A'}`,
        `   - Measurement Units: ${athlete.measurement_preference}`,
        `   - Strava Summit Member: ${athlete.summit ? 'Yes' : 'No'}`,
        `   - Profile Image (Medium): ${athlete.profile_medium}`,
        `   - Joined Strava: ${athlete.created_at ? new Date(athlete.created_at).toLocaleDateString() : 'N/A'}`,
        `   - Last Updated: ${athlete.updated_at ? new Date(athlete.updated_at).toLocaleDateString() : 'N/A'}`,
      ];
  
      // Ensure return object matches expected structure
      const response = {
         content: [{ type: "text" as const, text: profileParts.join("\n") }]
        };
      return response;
  
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
      console.error("Error in get-athlete-profile tool:", errorMessage);
      return {
        content: [{ type: "text" as const, text: `❌ API Error: ${errorMessage}` }],
        isError: true,
      };
    }
  }

• src/tools/getAthleteProfile.ts:4-4 (registration)

  The tool object itself, including its name ("get-athlete-profile") and description.

  export const getAthleteProfile = {