Tools
Exactly what the server advertised in the scan completed . Effects and capabilities are classified by Squatch from each tool's metadata. Squatch never runs tools.
- Effect: Read 22
- Effect: Write 12
- Effect: Delete 2
Showing 36 of 36 tools
| Details | ||
|---|---|---|
| delete_meal Delete a logged meal by id (soft delete, 30-day recovery window). Requires X-App-User-Id. | Effect: Delete | |
| delete_workout Delete a logged workout and its sets by id (soft delete, 30-day recovery window). | Effect: Delete | |
| ai_meal_plan Draft a meal plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them. | Effect: Write | |
| ai_workout_plan Draft a workout plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them. | Effect: Write | |
| instantiate_routine Schedule the signed-in user's routine into planned workouts from start_date. Coach assignment of another user is REST-only. | Effect: Write | |
| log_body_metric Log a body measurement. metric_type: weight (kg), height (cm), body_fat (%), muscle_mass (kg), waist/chest/bicep/forearm/hip/thigh/calf/nec… | Effect: Write | |
| log_cardio Log a cardio activity (run/bike/swim/etc.) for the current app user. Supports duration, distance, HR, power, calories. | Effect: Write | |
| log_meal Log a meal (calories + macros + optional ingredients) for the current app user. | Effect: Write | |
| log_water Log water intake (ml) for the current app user. | Effect: Write | |
| log_workout Log a workout with exercise sets (strength or cardio unified). Requires an app user context. | Effect: Write | |
| my_training_context Returns a slice of the signed-in user's training picture. Default domains are workouts and today's nutrition. Pass `domains` to add checkin… | Effect: Write | |
| update_meal Correct a previously logged meal — name, macros, nutrients, portion, date or meal_type. Pass only the fields you want to change. Requires X… | Effect: Write | |
| update_sets Correct sets already logged, by set id (log_workout returns them). Relabel the exercise, fix weight/reps/rpe, mark completed, add notes, or… | Effect: Write | |
| upsert_profile Upsert the current app user's fitness profile. Set `timezone` first: every daily total, streak and adherence window is bucketed by it and d… | Effect: Write | |
| ai_parse_meal Parse free-text meal description ('2 eggs and toast with butter') into structured items with grams + macros. | Effect: Read | |
| ai_photo_macros Analyze a meal image and estimate foods + macros. Pass exactly one of image_url or image_base64. Vision model, capped separately from the t… | Effect: Read | |
| export_data Export the signed-in user's data as JSON. Pass `domains` (e.g. meals,workouts) or confirm:true for a full copy. Identity comes from the tok… | Effect: Read | |
| generate_muscle_image Render an SVG diagram of the human body with muscles highlighted in arbitrary colors. Returns SVG. | Effect: Read | |
| get_body_metrics List the current app user's body metrics / measurements (weight, height, bicep, body fat, etc.), most recent first. Filter by metric_type (… | Effect: Read | |
| get_cardio_activities List the current app user's cardio activities (most recent first). | Effect: Read | |
| get_events What changed since a cursor, including DELETES, which a list read cannot show. Returns {seq, entity, id, action}. Pass the last seq back as… | Effect: Read | |
| get_exercise Fetch one exercise by name, id, or random. | Effect: Read | |
| get_meals List the current app user's meals for a date range. | Effect: Read | |
| get_muscle_recovery Per-muscle 7-day recovery % (Fitbod parity) — the 'what should I train today?' input. Recommends fresh muscles. Pass include_bodyweight=tru… | Effect: Read | |
| get_nutrition_daily Per-day calories, macros, fiber/sugar/sodium/alcohol, water, targets and adherence % over a date range (default: last 7 days). The 'how am … | Effect: Read | |
| get_profile Get the current app user's fitness profile (height, weight, macro + water goals, diet, active sports). Requires an app user context. | Effect: Read | |
| get_progress Any progression metric for the current user — pick one in `metric`. training_load is acute:chronic (>1.5 ramping too fast, <0.8 detraining)… | Effect: Read | |
| get_routine Fetch a single curated routine by slug with all days + slots fully expanded (exercises, sets, reps ranges, rest, superset groupings). The '… | Effect: Read | |
| get_water List the current app user's water intake entries for a date range. Requires X-App-User-Id. | Effect: Read | |
| get_workouts List the current app user's workouts (most recent first). | Effect: Read | |
| list_muscles List all 23 supported muscle slugs with anatomical names. | Effect: Read | |
| list_routines Browse the curated workout routine library (PPL, upper/lower, full-body, 5x5, etc.). Filter by difficulty, goal, split_type, days_per_week.… | Effect: Read | |
| lookup_barcode Lookup a food product by EAN/UPC barcode. | Effect: Read | |
| resolve_exercise Resolve an exercise name into primary/secondary muscle layers for rendering. | Effect: Read | |
| search_exercises Search 873 exercises by name with muscle/equipment/level filters. Rows are lean (name, ext_id, equipment, level, muscles) — enough to pick … | Effect: Read | |
| search_foods Search food products by name (Open Food Facts + USDA). Returns macros per 100g. | Effect: Read |