Fooddata Central Tools#

Configuration File: fooddata_central_tools.json Tool Type: Local Tools Count: 2

This page contains all tools defined in the fooddata_central_tools.json configuration file.

Available Tools#

FoodDataCentral_get_food (Type: FoodDataCentralTool)#

Get detailed food information by a positive integer FDC ID from USDA FoodData Central. The wrappe…

FoodDataCentral_get_food tool specification

Tool Information:

  • Name: FoodDataCentral_get_food

  • Type: FoodDataCentralTool

  • Description: Get detailed food information by a positive integer FDC ID from USDA FoodData Central. The wrapper verifies that the response fdcId exactly matches the request and that foodNutrients is present before reporting success. Returns complete nutrient profile, ingredients, serving size, and food attributes. Example: FDC ID 1105073 returns ‘Bananas, overripe, raw’ with 70+ nutrients.

Parameters:

  • fdc_id (integer) (required) FoodData Central food ID (e.g., 1105073 for raw bananas, 2012128 for a branded banana product). Get IDs from FoodDataCentral_search_foods.

Example Usage:

query = {
    "name": "FoodDataCentral_get_food",
    "arguments": {
        "fdc_id": 10
    }
}
result = tu.run(query)

FoodDataCentral_search_foods (Type: FoodDataCentralTool)#

Search USDA FoodData Central for foods by keyword. Each food includes the complete nutrient array…

FoodDataCentral_search_foods tool specification

Tool Information:

  • Name: FoodDataCentral_search_foods

  • Type: FoodDataCentralTool

  • Description: Search USDA FoodData Central for foods by keyword. Each food includes the complete nutrient array supplied by the search API plus the legacy first-10 topNutrients summary and nutrientCount. Use page_number and metadata.nextPage while metadata.hasMore is true to retrieve all result pages.

Parameters:

  • query (string) (required) Search keywords (e.g., ‘cheddar cheese’, ‘banana’, ‘chicken breast’). Supports multi-word search.

  • page_size (integer) (optional) Number of results per page (default 25, max 200).

  • page_number (integer) (optional) Page number for pagination (starts at 1).

  • data_type (string) (optional) Filter by data type. Options: ‘Foundation’ (reference foods), ‘Branded’ (commercial products), ‘SR Legacy’ (USDA standard reference), ‘Survey (FNDDS)’ (national dietary survey).

Example Usage:

query = {
    "name": "FoodDataCentral_search_foods",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)