MyPlate.food nutrition tools

Compute Body Mass Index and its weight classification from height and weight alone. Adults use the WHO cutoffs (underweight / normal / overweight / obese); for ages 2–19 pass age + sex and it uses the CDC BMI-for-age percentiles instead. Returns a canonical myplate.food URL and source citation.

{
  "type": "object",
  "properties": {
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    },
    "age": {
      "type": "integer",
      "minimum": 2,
      "maximum": 120,
      "description": "Age in years (2–120). Omit for standard adult BMI; required (with sex) for ages 2–19 youth percentiles. Under 2 there is no BMI reference — weight status is assessed on weight-for-length."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Required only when age < 20 (CDC curves are sex-specific)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate body-fat % using the U.S. Navy circumference method, with a Deurenberg BMI-based cross-check and ACE category. Needs sex, age, height, weight and tape measurements of neck and waist (plus hip for women).

{
  "type": "object",
  "properties": {
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex."
    },
    "age": {
      "type": "integer",
      "minimum": 18,
      "maximum": 80,
      "description": "Age in years (18–80). The Deurenberg cross-check and the ACE bands are adult references; the Navy equation itself does not use age."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    },
    "neck_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Neck circumference in cm (or neck_in)."
    },
    "neck_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Neck circumference in inches."
    },
    "waist_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Waist circumference in cm (or waist_in)."
    },
    "waist_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Waist circumference in inches."
    },
    "hip_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Hip circumference in cm — required for women (or hip_in)."
    },
    "hip_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Hip circumference in inches (women)."
    }
  },
  "required": [
    "sex",
    "age"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run one of myplate.food's quick body-composition & fitness calculators and get its value plus the healthy band. Pick `metric` and pass that metric's fields: • waist-to-height — waist, height • waist-to-hip — waist, hip, sex • lean-body-mass — weight, height, sex • ffmi — weight, height, body_fat, sex • water-intake — weight (+ optional activity: sedentary|moderate|active) • weight-loss-percentage — start_weight, current_weight • one-rep-max — weight, reps Lengths and weights follow `unit` (metric = cm/kg, imperial = in/lb; default metric).

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "enum": [
        "waist-to-height",
        "waist-to-hip",
        "lean-body-mass",
        "ffmi",
        "water-intake",
        "weight-loss-percentage",
        "one-rep-max"
      ],
      "description": "Which calculator to run."
    },
    "unit": {
      "type": "string",
      "enum": [
        "metric",
        "imperial"
      ],
      "description": "Units for inputs/output. Default metric (cm/kg)."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Required for waist-to-hip, lean-body-mass, ffmi."
    },
    "waist": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Waist (cm or in per unit)."
    },
    "hip": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Hip (cm or in)."
    },
    "height": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height (cm or in)."
    },
    "weight": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight (kg or lb)."
    },
    "body_fat": {
      "type": "number",
      "minimum": 0,
      "maximum": 70,
      "description": "Body-fat % (for ffmi)."
    },
    "start_weight": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Starting weight (for weight-loss-percentage)."
    },
    "current_weight": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Current weight (for weight-loss-percentage)."
    },
    "reps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Reps performed (for one-rep-max)."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderate",
        "active"
      ],
      "description": "Activity (for water-intake)."
    }
  },
  "required": [
    "metric"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate daily calorie needs (IOM Estimated Energy Requirement) and return the USDA MyPlate food-group plan at that level — cups of fruit/vegetables/dairy, ounce-equivalents of grains/protein, plus weekly vegetable & protein subgroup targets and BMI. From age, sex, height, weight and activity (pregnancy/lactation optional).

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    },
    "pregnancy": {
      "type": "string",
      "enum": [
        "not-pregnant",
        "1st-trimester",
        "2nd-trimester",
        "3rd-trimester"
      ],
      "description": "Pregnancy status (adds the IOM trimester calorie allowance)."
    },
    "lactation": {
      "type": "string",
      "enum": [
        "not-lactating",
        "0-6-months",
        "7-12-months"
      ],
      "description": "Lactation status (adds the IOM lactation calorie allowance)."
    },
    "edition": {
      "type": "string",
      "enum": [
        "iom2005",
        "nasem2023"
      ],
      "description": "DRI Estimated Energy Requirement equation set. Defaults to iom2005."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you want the whole energy picture in one call. Returns resting metabolic rate (Mifflin-St Jeor) and revised Harris-Benedict, total daily energy expenditure (TDEE) at every activity level, three weight-loss deficit tiers, macronutrient splits, protein targets and healthy-weight ranges. This is a superset of calculate_tdee, calculate_calorie_deficit, calculate_macros, calculate_protein_target, calculate_bmr and calculate_ideal_weight — reach for those only when you need a single number. Same profile inputs as the MyPlate plan.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compute basal/resting metabolic rate — the calories your body burns at rest. Returns the headline Mifflin-St Jeor (1990) value plus the revised Harris-Benedict (Roza & Shizgal 1984) estimate for comparison. Needs age, sex, height and weight.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need maintenance calories — the total daily energy expenditure. Mifflin-St Jeor resting metabolic rate scaled by a physical-activity multiplier; returns the TDEE at the given activity level plus a table across all four levels (sedentary → very-active). Needs age, sex, height, weight and activity. For deficits, macros and protein alongside it, use calculate_calorie_needs instead.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when someone wants a weight-loss calorie target. Returns maintenance calories (TDEE) and three deficit tiers — mild (−250), standard (−500) and aggressive (−750 kcal/day) — each with the realistic weekly rate it buys, and a flag when a target dips below BMR. Needs age, sex, height, weight and activity.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Split a daily calorie budget into protein, carbohydrate and fat grams across three presets. Balanced (20/50/30) sits inside the IOM acceptable macronutrient distribution ranges (protein 10 to 35%, carbohydrate 45 to 65%, fat 20 to 35%); higher-protein (30/40/30) and lower-carb (30/35/35) put carbohydrate below its range. Each preset in the response carries withinAmdr. Pass `calories` directly, or a body profile (age, sex, height, weight, activity) to derive TDEE first.

{
  "type": "object",
  "properties": {
    "calories": {
      "type": "number",
      "minimum": 500,
      "maximum": 8000,
      "description": "Daily calorie budget to split. Omit to derive TDEE from a profile."
    },
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years (if deriving from a profile)."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex (if deriving from a profile)."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Daily protein target in grams from body weight and activity level: the IOM RDA for the life stage (0.8 g/kg for adults; 0.85 at 14 to 18, 1.1 in the second half of pregnancy, 1.3 while breastfeeding) and an activity-scaled range up to the Academy of Nutrition and Dietetics / Dietitians of Canada / ACSM (2016) 1.2 to 2.0 g/kg athlete range. Needs age, sex, height, weight and activity.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate ideal body weight from height and sex via four classic clinical formulas (Devine 1974, Robinson 1983, Miller 1983, Hamwi 1964), plus the healthy-BMI (18.5–24.9) weight band and current BMI for context. Needs age, sex, height, weight.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Protein target to preserve muscle during weight loss on a GLP-1 medication (Ozempic, Wegovy, Zepbound, Mounjaro): the 1.2 to 1.6 g/kg preservation range vs the IOM protein RDA for the age (0.8 g/kg for adults, 0.85 at 14 to 18, higher below 14), the per-meal amount over 4 meals, and the DRI fiber Adequate Intake for age and sex. When the range runs above 120 g/day it also returns the fixed 80 to 120 g/day option from the 2025 GLP-1 nutrition advisory, with its note that actual body weight can overestimate needs. Needs weight, age and sex.

{
  "type": "object",
  "properties": {
    "unit": {
      "type": "string",
      "enum": [
        "metric",
        "imperial"
      ],
      "description": "Units for weight. Default metric (kg)."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex (sets the fiber Adequate Intake)."
    },
    "weight": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Body weight (kg or lb per unit)."
    },
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    }
  },
  "required": [
    "sex",
    "weight",
    "age"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Daily energy requirement for the German/Austrian/Swiss (D-A-CH) DGE framework: resting energy via the Müller et al. (2004) equation the DGE uses, scaled by a PAL activity factor. Returns resting energy, the requirement at the chosen PAL, and a table at PAL 1.4 / 1.6 / 1.8. Needs sex, age and weight. Adults only — the DGE derives this equation for adults and publishes table reference values for children and adolescents instead.

{
  "type": "object",
  "properties": {
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex."
    },
    "age": {
      "type": "integer",
      "minimum": 19,
      "maximum": 120,
      "description": "Age in years (19–120). Adults only — the DGE derives this equation for adults and publishes table reference values for children and adolescents instead."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds."
    },
    "pal": {
      "type": "number",
      "minimum": 1.2,
      "maximum": 2.4,
      "description": "Physical Activity Level factor (default 1.6, DGE range 1.2–2.4)."
    }
  },
  "required": [
    "sex",
    "age"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the full Dietary Reference Intakes table for a life stage — recommended intakes and tolerable upper limits for macronutrients, vitamins and minerals (IOM 2005/2006/2011, NASEM 2019), plus the Estimated Energy Requirement and BMI. Needs age, sex, height, weight (pregnancy/lactation optional; edition iom2005 | nasem2023).

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Age in years."
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Biological sex — drives the energy equation."
    },
    "activity": {
      "type": "string",
      "enum": [
        "sedentary",
        "moderately-active",
        "active",
        "very-active"
      ],
      "description": "Physical activity level. Defaults to sedentary."
    },
    "height_cm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Height in centimeters (or use height_ft + height_in)."
    },
    "height_ft": {
      "type": "number",
      "minimum": 1,
      "maximum": 8,
      "description": "Height, feet component (imperial)."
    },
    "height_in": {
      "type": "number",
      "minimum": 0,
      "maximum": 11.9,
      "description": "Height, inches component (imperial)."
    },
    "weight_kg": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in kilograms (or use weight_lb)."
    },
    "weight_lb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Weight in pounds (imperial)."
    },
    "pregnancy": {
      "type": "string",
      "enum": [
        "not-pregnant",
        "1st-trimester",
        "2nd-trimester",
        "3rd-trimester"
      ],
      "description": "Pregnancy status (adds the IOM trimester calorie allowance)."
    },
    "lactation": {
      "type": "string",
      "enum": [
        "not-lactating",
        "0-6-months",
        "7-12-months"
      ],
      "description": "Lactation status (adds the IOM lactation calorie allowance)."
    },
    "edition": {
      "type": "string",
      "enum": [
        "iom2005",
        "nasem2023"
      ],
      "description": "DRI Estimated Energy Requirement equation set. Defaults to iom2005."
    }
  },
  "required": [
    "age",
    "sex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search the ~1,072-recipe USDA MyPlate Kitchen collection (public domain). Filter by free-text query, food group, dish category, max calories and minimum rating. Returns recipe cards with slug, calories, food groups, image and links. Use get_recipe with a slug for the full recipe.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text search over recipe name + description, e.g. \"black bean\"."
    },
    "food_group": {
      "type": "string",
      "description": "Food-group key: fruits, vegetables, grains, protein-foods, or dairy."
    },
    "category": {
      "type": "string",
      "description": "Dish category, e.g. \"Main dish\", \"Salad\", \"Soup\"."
    },
    "max_calories": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Only recipes at or below this calorie count per serving."
    },
    "min_rating": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Minimum USDA rating (0–5)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max results to return (default 20)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch one recipe by its slug: ingredients, directions, full USDA nutrition table, MyPlate food-group amounts, serving size, yield, rating, image and source attribution. Get slugs from search_recipes.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Recipe slug, e.g. \"2-step-chicken\"."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}