Find products
suppco_find_productsFind products based on user query - handles search, browsing, and recommendations. Use this whenever the user wants to discover or find products.
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": "suppco_find_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| form | No | Comma-separated list of product forms. Valid forms are: capsule, tablet, softgel, gummy, powder, liquid, other (e.g., 'capsule,tablet') | |
| brand | No | The brand a user prefers | |
| limit | No | Maximum number of products to return (default: 5, max: 50) | |
| query | No | Free text search for a specific product by name (e.g., "Thorne Creatine", "AG1 Greens"). Only use this when searching for a specific brand + product name with no filters. Do NOT use query together with other params — use product_category_name instead when filters like priority, brand, certifications, form, max_price, or servings are needed. | |
| offset | No | Number of products to skip for pagination (default: 0) | |
| tested | No | When true, only return products that have been TESTED by SuppCo (identity, potency, and/or heavy metals testing performed by SuppCo's lab) | |
| priority | No | How to rank results. Valid: best_value, most_trusted, most_popular, most_expensive. Omit (or leave blank) to apply the user's profile buying preference automatically; pass a value to override. | |
| servings | No | Comma-separated list of serving counts (e.g., '30,60,90') | |
| max_price | No | Maximum price in dollars (e.g., 50.00) | |
| certifications | No | Required certifications, comma-separated. Valid: gluten_free, non_gmo, vegan_action, usda_organic, nsf_sport, usp_verified, informed_sport, informed_choice, tested_by_suppco. Omit (or leave blank) to apply the user's profile dietary preferences (vegan, gluten-free) automatically; pass an explicit list to override. | |
| exclude_ingredients | No | Comma-separated list of ingredients the product must NOT contain (e.g., 'stevia,sucralose'). Matches against both active ingredients (supplements) and inactive ingredients (excipients). | |
| include_ingredients | No | Comma-separated list of ADDITIONAL ingredients the product must also contain beyond its category (e.g., for 'collagen with hyaluronic acid', set product_category_name='Collagen' and include_ingredients='hyaluronic acid'). Do NOT put the primary supplement here — use product_category_name for that. | |
| product_category_name | No | REQUIRED for all non-query searches. The supplement category (e.g., 'Vitamin D', 'Magnesium', 'Ashwagandha', 'Collagen'). ALWAYS provide this when using any filter params (priority, brand, certifications, form, max_price, servings, include_ingredients, exclude_ingredients). When the user asks for a supplement by name like 'ashwagandha' or 'magnesium', that IS the category. |