JEFit MCP Server

Instructions

Implementation Reference

• server.py:187-258 (handler)

  The primary handler function for the 'get_batch_workouts' tool, decorated with @mcp.tool for registration. It validates input dates, fetches workout data for each date using a helper function, enriches with exercise details, and returns formatted markdown output.

  @mcp.tool
  def get_batch_workouts(dates: list[str]) -> ToolResult:
      """
      Get detailed workout information for multiple dates in a single call.
      
      Args:
          dates: List of dates in YYYY-MM-DD format
      
      Returns:
          Markdown-formatted workout details for all requested dates
      """
      if not dates:
          raise ValueError("dates list cannot be empty")
      
      # Validate all date formats first
      for date_str in dates:
          try:
              datetime.strptime(date_str, "%Y-%m-%d")
          except ValueError as e:
              raise ValueError(f"Invalid date format '{date_str}'. Use YYYY-MM-DD format: {e}")
      
      # Build combined markdown output
      all_workouts = []
      
      for date_str in sorted(dates):
          # Get workout data from API
          workout_data = get_workout_for_date(date_str)
          
          output_lines = []
          output_lines.append(f"# Workout for {date_str}\n")
          
          if 'data' not in workout_data or not workout_data['data']:
              output_lines.append("No workout found for this date.\n")
          else:
              for session in workout_data['data']:
                  session_date = datetime.fromtimestamp(session['date']).strftime('%Y-%m-%d %H:%M:%S')
                  duration_minutes = session['total_time'] // 60
                  duration_seconds = session['total_time'] % 60
                  total_weight = session['total_weight']
                  
                  output_lines.append(f"**Started:** {session_date}")
                  output_lines.append(f"**Duration:** {duration_minutes}m {duration_seconds}s")
                  output_lines.append(f"**Weight Lifted:** {total_weight} lbs\n")
                  
                  output_lines.append("## Exercises\n")
                  
                  for i, log in enumerate(session['logs'], 1):
                      exercise_id = log['exercise_id']
                      exercise = EXERCISE_DB.get(exercise_id, {})
                      
                      name = exercise.get('name', f'Unknown Exercise ({exercise_id})')
                      muscle_groups = ', '.join(exercise.get('body_parts', ['Unknown']))
                      equipment = ', '.join(exercise.get('equipment', ['Unknown']))
                      
                      output_lines.append(f"### {i}. {name}")
                      output_lines.append(f"- **Muscle Groups:** {muscle_groups}")
                      output_lines.append(f"- **Equipment:** {equipment}")
                      output_lines.append("")
                      
                      # Add sets information
                      for j, s in enumerate(log['log_sets'], 1):
                          weight = s.get('weight', 0)
                          reps = s.get('reps', 0)
                          output_lines.append(f"  - Set {j}: {weight} lbs × {reps} reps")
                      
                      output_lines.append("")  # Blank line between exercises
          
          all_workouts.append("\n".join(output_lines))
      
      # Join all workouts with separator
      markdown_text = "\n---\n\n".join(all_workouts)
      return ToolResult(content=[TextContent(type="text", text=markdown_text)])

• workout_info.py:97-111 (helper)

  Helper function used by get_batch_workouts to fetch raw workout data from the Jefit API for a specific date.

  def get_workout_for_date(date_str):
      """Get workout logs for a specific date"""
      date_unix = int(time.mktime(time.strptime(date_str, "%Y-%m-%d")))
      # Get Access Token and User ID
      access_token = get_access_token()
      user_id = get_user_id(access_token)
      url = f"https://www.jefit.com/api/v2/users/{user_id}/sessions?startDate={date_unix}"
      headers = {
          'content-type': 'application/json',
          'Cookie': f'jefitAccessToken={access_token}'
      }
      
      response = requests.get(url, headers=headers)
      return response.json()