omni_keto_carb_limit
Calculate daily net carbohydrate limits, fiber deductions, and ketogenic macronutrient ratios to determine fat intake, carb calorie share, and target blood ketones for nutritional ketosis.
Instructions
Keto Net Carbs & Ketogenic Ratio Calculator. Calculate daily net carbohydrate limits, total fiber deductions, and ketogenic macronutrient ratios (fat-to-protein+carb) for nutritional ketosis. Discipline: HEALTH. Governing mathematical model / formula: Net Carbs = Total Carbohydrates - Dietary Fiber - Sugar Alcohols.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of fat_grams (Required Healthy Fats), keto_ratio (Ketogenic Ratio (Fat : [Protein+Carb])), carb_calorie_pct (Carbohydrate Calorie Share), blood_ketone_range (Target Blood BHB Ketones) using daily_calories (Target Daily Calories in kcal), net_carb_target (Net Carb Limit in g/day), protein_intake (Protein Target in g/day). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Keto Net Carbs & Ketogenic Ratio Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "keto-carb-limit"
category (string): "health"
name (string): "Keto Net Carbs & Ketogenic Ratio Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.fat_grams (Required Healthy Fats): Formatted display string (e.g. '162 g (1,460 kcal)')
metrics.keto_ratio (Ketogenic Ratio (Fat : [Protein+Carb])): Formatted display string (e.g. '1.20 : 1.0 (Nutritional Ketosis)')
metrics.carb_calorie_pct (Carbohydrate Calorie Share): Formatted display string (e.g. '5.0% of Total Calories')
metrics.blood_ketone_range (Target Blood BHB Ketones): Formatted display string (e.g. '0.5 – 3.0 mmol/L')
execution_time_ms (number): Latency in milliseconds.
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": "omni_keto_carb_limit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| daily_calories | No | Target Daily Calories (kcal). Daily caloric intake. Default: 2000. Min: 1000. Max: 5000. | |
| protein_intake | No | Protein Target (g/day). Moderate protein to prevent gluconeogenesis. Default: 110. Min: 50. Max: 250. | |
| net_carb_target | No | Net Carb Limit (g/day). 20-25g standard for guaranteed ketosis. Default: 25. Min: 15. Max: 50. |