Latest weight
get_latest_weightRetrieves the current body-composition and weight measurement for all users or one sub-user, using a 5-minute shared cache and lazy sync.
Instructions
Return the most recent body-composition / weight measurement in the current global cache, optionally for a single sub-user (suid).
Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required.
Returns exactly one measurement containing weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, is_deleted, and ext_data, or null if no matching measurement exists.
ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation.
Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only).
Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields.
Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight).
Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard.
Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index).
Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree.
Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null.
Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer.
By default ignores tombstoned records (is_deleted: 1).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_latest_weight"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| suid | No | Sub-user id resolved by `list_users`. Omit to return the latest record across all users. | |
| include_deleted | No | Include records with `is_deleted: 1`. Default: false. | |
| include_ext_data | No | Include the `ext_data` reference/context object. Set to false to omit it. Default: true. |