JustGains

Show Workout

Display a workout in the preview editor by its ID

Generate Workout

Generate a workout based on a natural language description. Examples: "30 minute leg workout", "Upper body workout with dumbbells", "Full body HIIT circuit", "Beginner chest and triceps workout"

Get Progress

Get the signed-in user's training progress (daily gains, workout volume, steps, active days) over a timeframe. Provide startDate/endDate (YYYY-MM-DD) or a trailing number of days. Defaults to the last 30 days. Requires the user to have connected their JustGains account.

Search Exercises

Search the JustGains exercise library by name (optionally filtered by muscle group or equipment). Returns exercise codes and supported measurements to use when building or updating a workout.

Create Workout

Create a workout in the signed-in user's JustGains account, saved under their own creator profile. Provide a title and an ordered list of exercises (by code from search_exercises, or by name to auto-resolve); each exercise can include sets with reps/weight/RPE. Use this for precise, user-specified workouts (use generate_workout for AI-generated ones).

Update Workout

Update an existing workout in the user's JustGains account. Provide the workoutId plus any of: new title, new description, or a replacement list of exercises. Call show_workout first if you need the current exercises before modifying them.

Get Workout History

List the signed-in user's most recent workouts (title, date, duration, total volume, sets, reps, exercise count). Use to discuss recent training, consistency, and volume trends.

Get Exercise Details

Get detailed information about a specific exercise by its code. Returns the exercise name, instructions, equipment, muscles worked, and measurements.

Get My Workout Logs

Get the CURRENT user's workout-log history (workouts they actually performed and recorded). Use this whenever the user asks about THEIR OWN workouts - 'my last workout', 'what did I do this week', 'how much did I bench Monday', 'show my recent sessions', 'workouts in March', 'last summer's training'. For any historical timeframe, pass `since` and/or `until` (ISO-8601). The tool will paginate deeper automatically until the requested window is covered (or `maxLogs` is reached). For RANKED question

Get My Exercise History

Get the CURRENT user's recorded history for a SINGLE exercise (by exerciseCode), plus their personal best. Use when the user asks 'show my bench press progression', 'how heavy have I squatted', 'what's my best deadlift', 'when did I last do pull-ups'. You usually want to call search_exercises FIRST to resolve a name to a code. For ANY HISTORICAL TIMEFRAME ('my bench in 2024', 'squats last summer'), pass `since` and/or `until` (ISO-8601). The tool sweeps deeper pages automatically and returns onl

Search Workout Programs

Search the workout-program catalog. Returns paginated programs with title, description, total weeks/days, rating, creator, and a public link. Use when the user asks about available programs ('show me programs for hypertrophy', 'find a beginner program', 'what programs do you have'). Optional filters: search keyword, creatorId.

Get Workout Program

Get a workout program (template) by id, including its weeks and days. Use after search_workout_programs or get_my_workout_programs to dig into a specific program. Set includeData=false for a lightweight summary that omits per-day workout content.

Set My Program Engagement

Update the CURRENT user's enrollment on a workout program. Use to start, abandon, or complete a program: 'start this program', 'I'm done with PPL', 'abandon the cut program'. Requires the program id (use search_workout_programs to find it). Action must be one of: start | abandon | complete. Note: 'start' uses the Purchasing status, matching the existing API behavior.

Create Workout Program

Create a brand-new multi-week/multi-day workout PROGRAM for the user and save it to their account. You write the FULL program out as plain text in `programText`: a title, then each week and day with that day's exercises and their sets × reps (add weight or RPE when relevant). Rest days can be written as 'Rest'. The text is parsed into a structured program (real exercises are matched automatically) and saved. Use this whenever the user asks you to build / create / make / design a training PROGRAM

Create Route

Generate a real, road-and-path-snapped ROUTE (a plannable run / ride / walk / hike path) starting and ending at the user's location, and save it to their Routes tab. Use when the user asks you to build / make / plan a route, a running loop, a bike ride, etc. Use startLat/startLng from the app-data block's current location when present, or coordinates the user explicitly gives; NEVER guess them. If neither is available, OMIT startLat/startLng and the route starts from the user's last known traini

Get My Weight History

Get the CURRENT user's bodyweight log (entries plus summary: current, lowest, highest). Use whenever the user asks about their bodyweight: 'what do I weigh now', 'how much have I lost', 'show my weight trend', 'when did I last weigh in', 'what was my lightest'. For ANY HISTORICAL TIMEFRAME ('what did I weigh in March', 'last summer', 'between Jan 1 and Feb 14'), pass `since` and/or `until` (ISO-8601). Summary stats (current/lowest/highest) are returned for BOTH the full history and, when a windo

Log My Weight

Record a new bodyweight entry for the CURRENT user. Pass `weightKg` (kilograms) OR `weightLbs` (pounds), the tool converts lbs → kg before storage. If the user spoke in pounds, prefer `weightLbs` so the round-trip is exact. `recordedAt` is optional ISO-8601 (defaults to now). Valid stored range: 25kg–500kg (≈55–1100 lbs); the API rejects values outside this.

Get My Profile

Fetch the CURRENT user's full profile snapshot: name, email, bio, measurement system, timezone, plus private meta (age/birth date, height, gender, experience level, fitness goals, injury tracking, baseline weight). Use whenever the user asks 'what's my profile', 'how old am I', 'what's my height', 'what experience level am I set as', 'what goals do I have'. Pair with `update_my_profile` if they want to change any of these.

Summarize My Week

Bundle a one-call snapshot of the CURRENT user's recent training: count of workout logs in the last `days` (default 7), per-muscle-group recovery data, weight delta vs `days` ago, and the most recent log id. Use for "how was my week", "quick recap", "how am I doing". For HISTORICAL questions ('how was my week ending June 1, 2024'), pass `endDate` (ISO-8601), the window becomes (endDate - days, endDate) instead of anchoring to today. Saves the agent from chaining get_my_workout_logs + get_my_reco

Analyze My Consistency

Analyze the CURRENT user's workout consistency over a window: longest streak, current streak (today/yesterday inclusive), distinct training days, total logs, and average workouts per week. Use for 'how's my consistency', 'what's my streak', 'how often have I trained lately'. Default window 60 days, max 365. For HISTORICAL consistency questions ('how consistent was I in 2024'), pass `endDate` (ISO-8601), the window becomes (endDate: days, endDate). Current-streak only counts when the window ends

Get My Top Exercises

Cross-exercise leaderboard for the CURRENT user. Use whenever the user asks about their TOP / MOST / HEAVIEST exercises across the board: 'what's my most used exercise', 'top 3 lifts', 'heaviest exercises', 'what do I lift the most'. Scans the user's workout logs (default 365 days, capped at `maxLogsScanned`) and returns three rankings in one call: byFrequency (session + set count), byMaxWeight (peak single-set weight), and byVolume (total tonnage). Each entry includes the exerciseCode + name so