Nutrition

Log a meal

createlog_meal

Creates a meal record from food the user ate or is about to eat. Supplied calories and protein are saved together, with optional carbs and fat. When both are omitted, iAM360 estimates nutrition, including web research for branded items; estimation requires an iAM360 plan and can take 5-25 seconds. Returns the saved meal and updated daily totals.

Access: Creates new records in the person's account.
Annotations: readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: truetitle: Log a meal
Time limit: 90 seconds, then the call stops with an error.

createlog_meal

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "log_meal",    "arguments": {      "description": "two scrambled eggs and a slice of sourdough toast with butter"    }  }}

Result

{  "ok": true,  "mealId": "2b0f2ce3-41ba-4ce9-bf1c-dd6e64efc19d",  "mealDate": "2026-10-14",  "name": "Scrambled eggs and buttered sourdough toast",  "calories": 284,  "protein": 16,  "carbs": 21,  "fat": 14,  "confidence": "medium",  "sources": [],  "warnings": [],  "dayAfterChange": {    "date": "2026-10-14",    "totals": {      "calories": 704,      "protein": 40,      "carbs": 79,      "fat": 25    },    "remaining": {      "calories": 1596,      "protein": 120,      "carbs": 164,      "fat": 52    }  }}

Parameters

descriptionstringRequired
What was eaten, e.g. 'Chipotle chicken burrito bowl with brown rice, black beans and guacamole' or 'two scrambled eggs and a slice of sourdough toast'.
2 to 2,000 characters
mealDatestring
YYYY-MM-DD in the user's timezone. Defaults to today.
Format YYYY-MM-DD
namestring
A short display name, used only with stated nutrition.
1 to 120 characters
caloriesinteger
Stated kcal. Pass together with protein.
0 to 10,000
proteininteger
Stated grams of protein. Pass together with calories.
0 to 1,000
carbsinteger
Stated grams of carbohydrate, if known.
0 to 2,000
fatinteger
Stated grams of fat, if known.
0 to 2,000
allowDuplicateboolean
Only true when the user really means a second, identical entry moments after the first.

Result

One text item holding a JSON object, as in the example.

Without calories and protein, iAM360 estimates the nutrition in 5 to 25 seconds and returns confidence, sources and warnings with it. Estimating uses iAM360's AI, which needs an iAM360 plan; without one, only meals with calories and protein save.
With calories and protein (and carbs and fat when known), the numbers are saved exactly and at once.
dayAfterChange holds the day's fresh totals and what is left of each target.
An identical call within two minutes returns the first result with duplicate: true and a duplicateNotice instead of saving again. Pass allowDuplicate: true only when the user really means a second, identical entry.

Errors

This tool's own errors, each returned with isError: true:

Pass both calories and protein to save stated nutrition, or neither to have iAM360 estimate it.
Pass both calories and protein to save stated nutrition.
AI features need an iAM360 plan. This tool uses iAM360's AI, which needs a plan: https://app.iam360.ai/plans. Everything else, including logging meals with calories and protein you provide, still works.
We couldn't check your iAM360 plan just now. Try again in a minute.

Every tool returns isError with a message when its arguments don't match the schema, a limit is reached, the person turned the agent off, or iAM360 has a problem. See Errors and limits.

Log a meal

createlog_meal

Access

Creates new records in the person's account.

Annotations

readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: truetitle: Log a meal

Time limit

90 seconds, then the call stops with an error.

Parameters

descriptionstringRequired
What was eaten, e.g. 'Chipotle chicken burrito bowl with brown rice, black beans and guacamole' or 'two scrambled eggs and a slice of sourdough toast'.
2 to 2,000 characters
mealDatestring
YYYY-MM-DD in the user's timezone. Defaults to today.
Format YYYY-MM-DD
namestring
A short display name, used only with stated nutrition.
1 to 120 characters
caloriesinteger
Stated kcal. Pass together with protein.
0 to 10,000
proteininteger
Stated grams of protein. Pass together with calories.
0 to 1,000
carbsinteger
Stated grams of carbohydrate, if known.
0 to 2,000
fatinteger
Stated grams of fat, if known.
0 to 2,000
allowDuplicateboolean
Only true when the user really means a second, identical entry moments after the first.

Result

One text item holding a JSON object, as in the example.

Without calories and protein, iAM360 estimates the nutrition in 5 to 25 seconds and returns confidence, sources and warnings with it. Estimating uses iAM360's AI, which needs an iAM360 plan; without one, only meals with calories and protein save.
With calories and protein (and carbs and fat when known), the numbers are saved exactly and at once.
dayAfterChange holds the day's fresh totals and what is left of each target.
An identical call within two minutes returns the first result with duplicate: true and a duplicateNotice instead of saving again. Pass allowDuplicate: true only when the user really means a second, identical entry.

Errors

This tool's own errors, each returned with isError: true:

Pass both calories and protein to save stated nutrition, or neither to have iAM360 estimate it.
Pass both calories and protein to save stated nutrition.
AI features need an iAM360 plan. This tool uses iAM360's AI, which needs a plan: https://app.iam360.ai/plans. Everything else, including logging meals with calories and protein you provide, still works.
We couldn't check your iAM360 plan just now. Try again in a minute.

Every tool returns isError with a message when its arguments don't match the schema, a limit is reached, the person turned the agent off, or iAM360 has a problem. See Errors and limits.