dev.anatome/anatome

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Log workouts and meals by telling your AI. 873 exercises, muscle diagrams, food lookup.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "anatome": {
      "url": "https://anatome.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (36)

• search_exercises read-only

  Search 873 exercises by name with muscle/equipment/level filters. Rows are lean (name, ext_id, equipment, level, muscles) — enough to pick one; get_exercise returns instructions and media. Paginates: pass next_cursor back as `cursor`.

  Parameters:

  • q (required) — string
  • level — string
  • limit — number
  • cursor — string — next_cursor from the previous response. Omit for the first page.
  • fields — string — Extra fields, comma-separated, or `all`.
  • muscle — string
  • equipment — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• get_exercise read-only

  Fetch one exercise by name, id, or random.

  Parameters:

  • id — string
  • name — string
  • random — boolean

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• resolve_exercise read-only

  Resolve an exercise name into primary/secondary muscle layers for rendering.

  Parameters:

  • exercise (required) — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• list_muscles read-only

  List all 23 supported muscle slugs with anatomical names.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• generate_muscle_image

  Render an SVG diagram of the human body with muscles highlighted in arbitrary colors. Returns SVG.

  Parameters:

  • layers (required) — array
  • view — string
  • gender — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• list_routines read-only

  Browse the curated workout routine library (PPL, upper/lower, full-body, 5x5, etc.). Filter by difficulty, goal, split_type, days_per_week. Returns minimal list.

  Parameters:

  • goal — string
  • limit — number
  • difficulty — string
  • split_type — string
  • days_per_week — number

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_routine read-only

  Fetch a single curated routine by slug with all days + slots fully expanded (exercises, sets, reps ranges, rest, superset groupings). The 'give me a full program' tool.

  Parameters:

  • slug (required) — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• instantiate_routine

  Schedule the signed-in user's routine into planned workouts from start_date. Coach assignment of another user is REST-only.

  Parameters:

  • routine_id (required) — string
  • start_date (required) — string — YYYY-MM-DD
  • cadence_days — number
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• search_foods read-only

  Search food products by name (Open Food Facts + USDA). Returns macros per 100g.

  Parameters:

  • q (required) — string
  • locale — string
  • page_size — number

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• lookup_barcode read-only

  Lookup a food product by EAN/UPC barcode.

  Parameters:

  • barcode (required) — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world yes

• log_workout

  Log a workout with exercise sets (strength or cardio unified). Requires an app user context.

  Parameters:

  • date (required) — string
  • sets — array
  • title — string
  • primary_sport — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_workouts read-only

  List the current app user's workouts (most recent first).

  Parameters:

  • limit — number
  • date_to — string
  • date_from — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• log_meal

  Log a meal (calories + macros + optional ingredients) for the current app user.

  Parameters:

  • date (required) — string
  • name (required) — string
  • calories (required) — number
  • fats — number
  • carbs — number
  • protein — number
  • meal_type — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_meals read-only

  List the current app user's meals for a date range.

  Parameters:

  • date_to — string
  • date_from — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• log_water

  Log water intake (ml) for the current app user.

  Parameters:

  • date (required) — string
  • amount_ml (required) — number
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• 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/neck/shoulder (cm), bmi, resting_hr (bpm). Logging weight enables bodyweight-inclusive volume analytics.

  Parameters:

  • date (required) — string
  • metric_type (required) — string
  • value (required) — number
  • unit (required) — string
  • notes — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_body_metrics read-only

  List the current app user's body metrics / measurements (weight, height, bicep, body fat, etc.), most recent first. Filter by metric_type (e.g. 'weight', 'bicep') and/or a date range. Requires an app user context.

  Parameters:

  • to — string
  • from — string
  • limit — number
  • metric_type — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• 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 defaults to UTC. `weight` doubles as the fallback bodyweight for bodyweight-inclusive volume when no dated weight metric exists.

  Parameters:

  • goal — string
  • height — number — cm
  • weight — number — kg
  • language — string
  • timezone — string — IANA zone name, e.g. 'Europe/Warsaw'.
  • diet_type — string
  • unit_system — string
  • active_sports — array
  • meals_per_day — number
  • daily_fats_goal — number
  • daily_carbs_goal — number
  • daily_fiber_goal — number — g/day to reach
  • daily_sugar_limit — number — g/day to stay under
  • daily_calorie_goal — number
  • daily_protein_goal — number
  • daily_sodium_limit — number — mg/day to stay under
  • daily_water_goal_ml — number

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_profile read-only

  Get the current app user's fitness profile (height, weight, macro + water goals, diet, active sports). Requires an app user context.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• log_cardio

  Log a cardio activity (run/bike/swim/etc.) for the current app user. Supports duration, distance, HR, power, calories.

  Parameters:

  • date (required) — string
  • sport (required) — string
  • notes — string
  • title — string
  • avg_hr — number
  • calories — number
  • distance_m — number
  • idempotency_key — string
  • duration_seconds — number

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_cardio_activities read-only

  List the current app user's cardio activities (most recent first).

  Parameters:

  • limit — number
  • date_to — string
  • date_from — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• ai_parse_meal

  Parse free-text meal description ('2 eggs and toast with butter') into structured items with grams + macros.

  Parameters:

  • text (required) — string
  • locale — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• 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 text AI budget (free tier 1/mo).

  Parameters:

  • image_url — string — Public URL of the image. Mutually exclusive with image_base64.
  • image_base64 — string — Base64-encoded image bytes, no data: prefix. Mutually exclusive with image_url.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• ai_meal_plan

  Draft a meal plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them.

  Parameters:

  • days (required) — number
  • confirm (required) — boolean
  • goal — string
  • health — object
  • diet_type — string
  • daily_calories — number

  Hints: read-only no · destructive no · idempotent no · open-world yes

• ai_workout_plan

  Draft a workout plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them.

  Parameters:

  • days_per_week (required) — number
  • confirm (required) — boolean
  • goal — string
  • health — object
  • experience — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• get_muscle_recovery read-only

  Per-muscle 7-day recovery % (Fitbod parity) — the 'what should I train today?' input. Recommends fresh muscles. Pass include_bodyweight=true to add the user's bodyweight to bodyweight exercises so recovery reflects real load.

  Parameters:

  • include_bodyweight — boolean — If true, add the user's bodyweight to bodyweight exercises (requires a logged weight or profile.weight).

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_nutrition_daily read-only

  Per-day calories, macros, fiber/sugar/sodium/alcohol, water, targets and adherence % over a date range (default: last 7 days). The 'how am I tracking today?' tool. Requires X-App-User-Id.

  Parameters:

  • date_to — string — YYYY-MM-DD (defaults to the user's today, in their timezone)
  • date_from — string — YYYY-MM-DD

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_water read-only

  List the current app user's water intake entries for a date range. Requires X-App-User-Id.

  Parameters:

  • date — string
  • date_to — string
  • date_from — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• 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-App-User-Id.

  Parameters:

  • meal_id (required) — string
  • date — string
  • fats — number
  • name — string
  • carbs — number
  • fiber — number
  • sugar — number
  • sodium — number — mg
  • alcohol — number — g of ethanol
  • protein — number
  • calories — number
  • meal_type — string
  • saturated_fat — number
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• delete_meal destructive

  Delete a logged meal by id (soft delete, 30-day recovery window). Requires X-App-User-Id.

  Parameters:

  • meal_id (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• update_sets destructive

  Correct sets already logged, by set id (log_workout returns them). Relabel the exercise, fix weight/reps/rpe, mark completed, add notes, or delete. Selection and change are separate, so a subset can be relabelled. Adding a set is log_workout, not this.

  Parameters:

  • set_ids (required) — array
  • rpe — number
  • reps — number
  • notes — string
  • delete — boolean
  • weight — number
  • exercise — string — Catalog name, ext_id, or the user's own words for a custom movement.
  • completed — boolean

  Hints: read-only no · destructive yes · idempotent no · open-world no

• delete_workout destructive

  Delete a logged workout and its sets by id (soft delete, 30-day recovery window).

  Parameters:

  • workout_id (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• export_data read-only

  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 token, never a caller-supplied user id.

  Parameters:

  • confirm — boolean — Required true for a full dump when domains is omitted.
  • domains — string — Comma-separated subset, e.g. 'meals,workouts'.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_events read-only

  What changed since a cursor, including DELETES, which a list read cannot show. Returns {seq, entity, id, action}. Pass the last seq back as `since` on the next call to receive only entries after it; omit `since` for a first sync. seq is a global counter: gaps in your feed are other accounts' events, not lost data. Judge completeness from has_more, not seq.

  Parameters:

  • limit — number
  • since — string — Cursor from the previous call's last seq. Omit for a first sync.
  • entities — string — Optional comma-separated filter, e.g. 'workout,meal'.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• my_training_context read-only

  Returns a slice of the signed-in user's training picture. Default domains are workouts and today's nutrition. Pass `domains` to add checkin, notes or profile, or `domains=all`. Identity comes from the token, not a caller-supplied user id.

  Parameters:

  • domains — string — Comma-separated subset. Accepted: workouts, nutrition, checkin, notes, profile, or 'all'. Default: workouts,nutrition.
  • workout_limit — number

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_progress read-only

  Any progression metric for the current user — pick one in `metric`. training_load is acute:chronic (>1.5 ramping too fast, <0.8 detraining); muscle_recovery is per-muscle freshness; correlate takes metric_a vs metric_b. Only completed sets count.

  Parameters:

  • metric (required) — string
  • to — string — YYYY-MM-DD
  • days — number — training_load window
  • from — string — YYYY-MM-DD
  • sport — string — training_load and cardio_prs
  • bucket — string
  • method — string — training_load: auto | power | hr | rpe
  • window — number — weight_trend smoothing window
  • goal_id — string — goal_trajectory
  • exercise — string — Required for prs; optional filter for volume, one_rep_max and compare_periods.
  • group_by — string — volume only
  • metric_a — string — correlate
  • metric_b — string — correlate
  • include_bodyweight — boolean — Add the user's bodyweight to bodyweight exercises (pull-ups, dips). prs, volume and muscle_recovery.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.