Strava MCP Server

Instructions

Implementation Reference

• src/tools/listAthleteRoutes.ts:37-74 (handler)

  The execute function that fetches and formats the athlete routes.

  execute: async ({ page = 1, perPage = 20 }: ListAthleteRoutesInput) => {
      const token = process.env.STRAVA_ACCESS_TOKEN;
      
      if (!token) {
          console.error("Missing 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 routes (page ${page}, per_page: ${perPage})...`);
          
          const routes = await fetchAthleteRoutes(token, page, perPage);
          
          if (!routes || routes.length === 0) {
              console.error(`No routes found for athlete.`);
              return { content: [{ type: "text" as const, text: "No routes found for the athlete." }] };
          }
          
          console.error(`Successfully fetched ${routes.length} routes.`);
          const summaries = routes.map(route => formatRouteSummary(route));
          const responseText = `**Athlete Routes (Page ${page}):**\n\n${summaries.join("\n")}`;
          
          return { content: [{ type: "text" as const, text: responseText }] };
      } catch (error) {
          const errorMessage = error instanceof Error ? error.message : String(error);
          console.error(`Error listing athlete routes (page ${page}, perPage: ${perPage}): ${errorMessage}`);
          // Removed call to handleApiError and its retry logic
          // Note: 404 is less likely for a list endpoint like this
          const userFriendlyMessage = `An unexpected error occurred while listing athlete routes. Details: ${errorMessage}`;
          return {
              content: [{ type: "text" as const, text: `❌ ${userFriendlyMessage}` }],
              isError: true
          };
      }
  }

• src/tools/listAthleteRoutes.ts:12-15 (schema)

  Input validation schema for the list-athlete-routes tool.

  const ListAthleteRoutesInputSchema = z.object({
      page: z.number().int().positive().optional().default(1).describe("Page number for pagination"),
      perPage: z.number().int().positive().min(1).max(50).optional().default(20).describe("Number of routes per page (max 50)"),
  });

• src/tools/listAthleteRoutes.ts:33-36 (registration)

  Tool definition including name, description, schema, and execute handler.

  export const listAthleteRoutesTool = {
      name: "list-athlete-routes",
      description: "Lists the routes created by the authenticated athlete, with pagination.",
      inputSchema: ListAthleteRoutesInputSchema,