Helios

Read one durable change-set receipt created by this authenticated MCP client.

get_change_set

Read daily targets for today in the user's time zone. Targets may be empty until the user sets them. Keep localDate and revision for set_nutrition_targets. Targets remain active until the next change.

get_nutrition_targets

Read one library or account-owned exercise definition.

get_exercise

Read one active meal preset.

get_saved_meal

Read up to twenty-five known saved-meal presets in one call. Results keep the requested order; a missing, archived, or inaccessible preset has meal=null and does not block other reads. Use list_saved_meals to discover IDs. Previous meals are separate food-record views.

get_saved_meals

Read one active linked training note by its stable identifier.

get_training_note

Return a compact account-scoped summary using only the training read scopes granted to this connection.

get_training_summary

Read one completed or voided session with immutable performed data and corrections.

get_workout_history

Read one workout plan in its current state.

get_workout_plan

Read up to ten known plan IDs in one call. Results keep the requested order; a missing or inaccessible plan has plan=null and does not block other reads. Use list_workout_plans to discover IDs. Request fewer IDs if the full graphs exceed the result-size limit.

get_workout_plans

List distinct meals from active food records, newest first. Use nextCursor to continue; offset remains supported for older clients.

list_previous_meals

List active library and account-owned custom exercise definitions. Use nextCursor with the same source and query to continue.

list_exercises

List recent durable change receipts created by this authenticated MCP connection. Use nextCursor to continue with the same connection.

list_recent_change_sets

List active saved meal presets for this account. Use nextCursor to fetch the next page; offset remains supported for older clients. Previous food records are separate.

list_saved_meals

List active linked training notes for the authenticated account, newest first. Use nextCursor from the prior page to continue.

list_training_notes

List completed or explicitly voided workout sessions, newest first. Use nextCursor from the prior page to continue.

list_workout_history

List workout plans, newest first. Use nextCursor to read the next page with the same includeArchived filter. Stop when nextCursor is null.

list_workout_plans

Move one existing planned exercise to a zero-based index in the same plan. No exercises or sets are added or removed. Read get_workout_plan first for its current revision and nested exercise or set IDs. This change returns a receipt that can be undone while the plan remains current.

move_workout_plan_exercise

Move one existing planned set to a zero-based index within its current exercise. No sets are added, removed, or moved to another exercise. Read get_workout_plan first for its current revision and nested exercise or set IDs. This change returns a receipt that can be undone while the plan remains current.

move_workout_plan_set

Archive a preset and keep earlier food records.

remove_saved_meal

Copy a food record into a reusable meal preset.

save_previous_meal

Set calories, protein, carbs and fat from today until the next change. Use integer milli-kcal and milligrams, with explicit zero allowed for macros. Read get_nutrition_targets first. expectedLocalDate is a stale-read check, not a start-date choice. No end date or mobile approval is needed.

set_nutrition_targets

Change one plan's name or notes. Omitted fields stay unchanged; null clears notes. Exercises and sets stay unchanged. Read get_workout_plan first for its current revision and nested exercise or set IDs. This change returns a receipt that can be undone while the plan remains current.

set_workout_plan_details

Immediately append a compensating change when the target reversible change is still current.

undo_change_set

Replace an account-owned custom exercise definition. Read get_exercise for exerciseId and expectedRevision first. Library definitions cannot be changed; existing workout snapshots keep their recorded names.

update_custom_exercise

Replace one preset's complete definition. Read get_saved_meal for mealId and expectedRevision first. Existing food records keep their snapshots. Require calories, protein, carbs, and fat for one standard serving. Zero must be measured, never a missing value. Select sources automatically: available package data for the exact product, its matching manufacturer page, then AFCD or USDA FoodData Central for matching generic food. Use Open Food Facts as a lead; compare with the label when available. If incomplete, check another eligible source without asking the user to validate a provider. Keep the same product, serving, units and preparation. Store the source name and URL or package reference in sourceReference. Convert kcal and grams to integer milli-kcal and milligrams once. Keep incomplete data as a draft; never invent values.

update_saved_meal

Replace one plan's full name, notes, exercises, and sets. Read get_workout_plan first and pass its current expectedRevision. Existing exercises or sets not in the new graph are removed; use the separate plan detail, exercise, or set tools for a small change.

update_workout_plan

Change one planned exercise's definition, default rest, or notes. Omitted fields and its planned sets stay unchanged. Use its nested planExerciseId, not the library definition ID. Read get_workout_plan first for its current revision and nested exercise or set IDs. This change returns a receipt that can be undone while the plan remains current.

update_workout_plan_exercise

Change one planned set's kind, target reps, load in grams, RPE, or rest. Omitted fields stay unchanged; null clears a nullable target. Completed workout history stays unchanged. Read get_workout_plan first for its current revision and nested exercise or set IDs. This change returns a receipt that can be undone while the plan remains current.

update_workout_plan_set