{
  "endpoint": "/api/macronutrient-calculator",
  "method": "GET",
  "description": "Calculates optimal protein, carbohydrate, and fat gram distributions.",
  "parameters": {
    "targetCalories": { "type": "number", "required": true },
    "weightKg": { "type": "number", "required": true }
  },
  "formulas": {
    "protein": "2.2 * weightKg",
    "fat": "0.25 * targetCalories / 9",
    "carbohydrates": "(targetCalories - proteinCalories - fatCalories) / 4",
    "fiber": "14 * (targetCalories / 1000)"
  },
  "sample_response": {
    "protein": { "grams": 176, "calories": 704, "percent": 38 },
    "fat": { "grams": 51, "calories": 459, "percent": 25 },
    "carbohydrates": { "grams": 167, "calories": 668, "percent": 37 },
    "fiber": { "grams": 26 }
  }
}