List USDA Nutrients
usda_list_nutrientsLook up the FDC nutrient reference table — 269 nutrients with their numeric IDs, names, SR reference numbers, units, and categories. Use to resolve a nutrient name (e.g. "vitamin C") to its FDC ID (1162) before passing it to the nutrients[] filter on other tools. Pass query to match a name, ID, or SR number, and category (macronutrients, vitamins, minerals, lipids, amino_acids, or other) to narrow to one group. The data is static — call once and reuse the IDs.
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": "usda_list_nutrients"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Part of a nutrient name, matched case-insensitively (e.g. "lutein", "18:1"), or a whole FDC nutrient ID ("1062") or SR number ("268"). Combines with category. A blank query is ignored. | |
| category | No | Filter to a nutrient category. Options: macronutrients, vitamins, minerals, lipids, amino_acids, other. Omit both category and query to list all 269 tracked nutrients. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Present when no nutrient matches the filters: what to try instead. | |
| nutrients | No | Nutrient reference entries matching category and query, or the whole table when both are omitted. Grouped by category, in FDC rank order within each. | |
| effectiveQuery | No | The trimmed query, echoed when no nutrient matches it. |