search_foods
Search the FatSecret catalog to find a food's loggable servings, calories, and macros, using an English rendering for non-English input.
Instructions
Find catalog Foods with loggable Servings, kcal and Macros.
Search one food at a time. Search a composed dish, such as a plate in a photo, as a whole first (e.g. "beef bibimbap"), and its components separately only when the dish has no good match. Pass the User's original description and, for non-English input, an English rendering: the catalog is searched with the English rendering, or the original when omitted. Nutrition and metric amounts describe the whole Serving; number_of_units is its FatSecret unit count. A not_found result is normal. When a branded product isn't among the matches, ask the User for a photo of its Nutrition Label and draft it as a Stand-in with draft_entries. This tool does not write to the Food Diary.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"description": "<description>"
},
"name": "search_foods"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | The description of one food as the User said it. | |
| english_rendering | No | English rendering for the catalog. Pass this for non-English input. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| matches | Yes | ||
| attribution | No | Powered by fatsecret Platform API |