Servers Playground How we check Add a server Log in

SuppCo

Working · 1.8 s

co.supp/suppcov2.0.0 Domain verified

Supplement research, product and brand TrustScores, and your SuppCo stack and Buying Club cart.

Health & Science Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.supp.co/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

suppco_add_to_cart

Add a Buying Club product to the signed-in user's cart (the same cart as the SuppCo app). Use a product ID or slug from suppco_find_buying_club_products or suppco_compare_to_buying_club; only Buying Club products can be added. Set subscription to true for a recurring subscription at the product's recommended shipping interval. Returns the updated cart. This adds to any quantity already in the cart, so calling it again adds more units; to set an exact quantity, use suppco_update_cart_item.

product_id_or_slugstring, required

SuppCo product ID (UUID) or slug of a Buying Club product.

quantityinteger

Number of units to add (default 1).

subscriptionboolean

true to subscribe (recurring delivery), false for a one-time purchase (default false).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

SuppCo MCP server | mcptry

SuppCo

Working · 1.8 s

co.supp/suppcov2.0.0 Domain verified

Supplement research, product and brand TrustScores, and your SuppCo stack and Buying Club cart.

Health & Science Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.supp.co/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

suppco_add_to_cart

product_id_or_slugstring, required

SuppCo product ID (UUID) or slug of a Buying Club product.

quantityinteger

Number of units to add (default 1).

subscriptionboolean

true to subscribe (recurring delivery), false for a one-time purchase (default false).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (30)

suppco_add_to_cart

Argument	Type	Description
quantity	integer	Number of units to add (default 1).
subscription	boolean	true to subscribe (recurring delivery), false for a one-time purchase (default false).
product_id_or_slug*	string	SuppCo product ID (UUID) or slug of a Buying Club product.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id_or_slug"
  ],
  "properties": {
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of units to add (default 1)."
    },
    "subscription": {
      "type": "boolean",
      "description": "true to subscribe (recurring delivery), false for a one-time purchase (default false)."
    },
    "product_id_or_slug": {
      "type": "string",
      "description": "SuppCo product ID (UUID) or slug of a Buying Club product."
    }
  }
}

suppco_add_to_stack

Use this when the user wants to start tracking a product in their SuppCo stack. Adds the product to the signed-in user's stack. `id` is a SuppCo product UUID or slug from a search or product result. This does not buy anything; to buy a Buying Club product, use suppco_add_to_cart.

Argument	Type	Description
id*	string	SuppCo Product ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "SuppCo Product ID"
    }
  }
}

suppco_compare_product_to_alternatives

Compare a product against alternatives in its category. Returns a detailed view of the anchor product (trust score, ingredients, excipients) alongside filtered alternatives. Use when user asks to compare, find alternatives, or asks "is there something better?"

read-only

Argument	Type	Description
form	string	Product forms. Valid: capsule, tablet, softgel, gummy, powder, liquid, other
priority	string	How to rank alternatives. 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	string	Comma-separated serving counts (e.g., '60,90')
max_price	number	Maximum price in dollars
certifications	string	Certifications filter, 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.
product_id_or_slug*	string	Product ID (UUID), slug, or product name of the product to compare. Prefer slugs or UUIDs when available — they give exact matches.

suppco_compare_to_buying_club

Use this when the user asks whether the SuppCo Buying Club carries an alternative to a specific product, usually one they already take. Returns that product plus Buying Club products in the same category with TrustScore, price, member price and cashback.

read-only

Argument	Type	Description
form	string	Comma-separated product forms. Valid: capsule, tablet, softgel, gummy, powder, liquid, other.
priority	string	How to rank alternatives. Valid: best_value, most_trusted, most_popular, most_expensive. Defaults to most_trusted.
servings	string	Comma-separated serving counts (e.g., '30,60,90').
max_price	number	Maximum price in dollars.
certifications	string	Required certifications, comma-separated. Valid: gluten_free, non_gmo, vegan_action, usda_organic, nsf_sport, usp_verified, informed_sport, informed_choice, tested_by_suppco.
product_id_or_slug*	string	The product to compare against the Buying Club — usually one the user already takes (e.g. from suppco_get_my_stack). A UUID, slug, or product name.

Input schema (JSON)

suppco_find_brands

Find and filter brands. Use this to search for brands by name or to list brands matching specific criteria (e.g., brands that have been TESTED by SuppCo).

read-only

Argument	Type	Description
name	string	Search for a brand by name (e.g., "Thorne", "Garden of Life"). Leave blank to list brands matching other filters.
tested	boolean	When true, only return brands that have participated in TESTED by SuppCo (independent lab testing for identity, potency, and heavy metals)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "description": "Search for a brand by name (e.g., \"Thorne\", \"Garden of Life\"). Leave blank to list brands matching other filters."
    },
    "tested": {
      "type": "boolean",
      "description": "When true, only return brands that have participated in TESTED by SuppCo (independent lab testing for identity, potency, and heavy metals)"
    }
  }
}

suppco_find_buying_club_products

Open-ended search/browse of the SuppCo buying club catalog: free-text lookups ("Thorne Magnesium") or filtered browsing by category, trust, price, form, certifications, and brand. Every result is a buying-club product with member pricing and earnings credit (cashback). Use this when the user is exploring a category with no specific current product in play. For finding an alternative to a product the user already takes, use suppco_compare_to_buying_club instead (it returns their current product as the anchor).

read-only

Argument	Type	Description
form	string	Comma-separated product forms. Valid: capsule, tablet, softgel, gummy, powder, liquid, other.
brand	string	Restrict to a specific brand.
limit	integer	Max products to return (default: 5, max: 24).
query	string	Free-text search for a specific product by name (e.g., "Thorne Creatine"). Use alone, without filters. For filtered searches use product_category_name instead.
offset	integer	Number of products to skip for pagination (default: 0).
tested	boolean	When true, only products TESTED by SuppCo.
priority	string

suppco_find_products

Find products based on user query - handles search, browsing, and recommendations. Use this whenever the user wants to discover or find products.

read-only

Argument	Type	Description
form	string	Comma-separated list of product forms. Valid forms are: capsule, tablet, softgel, gummy, powder, liquid, other (e.g., 'capsule,tablet')
brand	string	The brand a user prefers
limit	integer	Maximum number of products to return (default: 5, max: 50)
query	string	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	integer	Number of products to skip for pagination (default: 0)
tested	boolean	When true, only return products that have been TESTED by SuppCo (identity, potency, and/or heavy metals testing performed by SuppCo's lab)
priority	string	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.

suppco_get_brand_trust_score

Use this when the user asks how trustworthy or high-quality a specific supplement brand is. Returns the brand's TrustScore with its quality assessment. Pass the brand's name, slug or UUID as brand_query.

read-only

Argument	Type	Description
brand_name	string	Deprecated alias of brand_query
brand_query	string	Brand UUID, slug, or name (ex: '80a5d287-8ec2-4b61-9004-10103da1133d', 'life-extension', 'Life Extension')

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "brand_name": {
      "type": "string",
      "description": "Deprecated alias of brand_query"
    },
    "brand_query": {
      "type": "string",
      "description": "Brand UUID, slug, or name (ex: '80a5d287-8ec2-4b61-9004-10103da1133d', 'life-extension', 'Life Extension')"
    }
  }
}

suppco_get_checkout_url

Get a secure checkout link for the signed-in user's cart. The link signs the user into checkout so member pricing and credit apply. It works once and expires after 10 minutes, so call this only when the user is ready to pay and give them the link right away. Buying Club credit is applied by default; set use_wallet to false if the user doesn't want to use their credit.

Argument	Type	Description
use_wallet	boolean	Apply the user's Buying Club credit to this order (default true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "use_wallet": {
      "type": "boolean",
      "description": "Apply the user's Buying Club credit to this order (default true)."
    }
  }
}

suppco_get_my_cart

Get the signed-in user's Buying Club cart: items, quantities, one-time or subscription, prices, subtotal, available credit and estimated cashback, plus any items that are no longer available.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_my_nutrient_plan

Use this when the user asks which nutrients they should take or how much. Returns the signed-in user's personalized plan with recommended nutrients and dosages. For what their current stack actually provides, use suppco_get_my_nutrient_totals.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_my_nutrient_totals

Use this when the user asks how much of a nutrient their current supplements provide, or whether they are over or under recommended amounts. Returns the daily nutrient totals from the signed-in user's stack compared with recommended values.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_my_protocols

Use this when the user asks about the health protocols they are following. Returns the signed-in user's protocols with progress and supplement recommendations. To find new protocols, use suppco_search_protocols.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_my_schedule

Get the user's current supplement schedule — shows when each product is taken (morning, midday, evening, bedtime, workout), dose amounts per time slot, with_food flags, and schedule frequency.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_my_stack

Use this when you need the signed-in user's current supplements, for example before recommending, comparing, swapping or removing products. Returns every product in their stack with dosages and daily totals, including the product IDs other SuppCo tools accept.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_get_nutrient_info

Use this when the user asks about dosing for a specific nutrient or supplement: typical daily intake ranges and upper limits from SuppCo's references, timing and whether to take it with food, plus a summary of its graded research. General information only; does not diagnose, treat or give personalized dosing advice. For what studies say about a supplement for a specific health area, use suppco_search_effects.

read-only

Argument	Type	Description
nutrient_name*	string	The name of the nutrient or supplement (e.g., 'Vitamin D3', 'Magnesium', 'Fish Oil')

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "nutrient_name"
  ],
  "properties": {
    "nutrient_name": {
      "type": "string",
      "description": "The name of the nutrient or supplement (e.g., 'Vitamin D3', 'Magnesium', 'Fish Oil')"
    }
  }
}

suppco_get_product_info

Look up detailed information (composition, ingredients, price, format, servings) for one or more specific products by UUID, slug, or name. Use for "tell me about <product>" or to hydrate products you only have ids for (e.g. from the user's stack). Accepts names when you don't have an id yet. For TrustScore rationale, certifications, or testing, call suppco_get_product_trust_score instead.

read-only

Argument	Type	Description
products*	any	One or more product identifiers (max 5): an array of strings, or one string separated by ' \| '. Each can be a UUID, slug, or product name. Prefer the ids you already have from a previous product result.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "One or more product identifiers (max 5): an array of strings, or one string separated by ' | '. Each can be a UUID, slug, or product name. Prefer the ids you already have from a previous product result."
    }
  }
}

suppco_get_product_trust_score

Get TrustScore details and quality assessment for one or more products: score rationale/commentary, certifications, testing and verified lab results, brand manufacturing/testing practices, and excipient risk ratings. Accepts product ids/slugs/names (multiple). Call this before discussing why a product is (or is not) trustworthy, its certifications, or its testing — the other product tools return only the headline score number.

read-only

Argument	Type	Description
products*	any	One or more product identifiers (max 5): an array of strings, or one string separated by ' \| '. Each can be a UUID, slug, or product name. Prefer the ids you already have from a previous product result.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "One or more product identifiers (max 5): an array of strings, or one string separated by ' | '. Each can be a UUID, slug, or product name. Prefer the ids you already have from a previous product result."
    }
  }
}

suppco_get_stack_score

Use this when the user asks how good their supplement stack is or how to improve it. Returns the signed-in user's StackScore with Quality, Value, Goals and Dosage ratings and coaching recommendations. Pass category to get a single category.

read-only

Argument	Type	Description
category	string	Optional category filter: 'quality', 'value', 'goals', or 'dosage'. Omit to get all categories.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "enum": [
        "quality",
        "value",
        "goals",
        "dosage"
      ],
      "type": "string",
      "description": "Optional category filter: 'quality', 'value', 'goals', or 'dosage'. Omit to get all categories."
    }
  }
}

suppco_manage_stack

Legacy: prefer suppco_add_to_stack / suppco_remove_from_stack / suppco_swap_products. Add, remove, or swap products in user's supplement stack using natural language commands.

destructive

Argument	Type	Description
action_description*	string	Natural language stack action. Examples: "add thorne-vitamin-d-k2", "remove life-extension-magnesium", "swap thorne-creatine for momentous-creatine"

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "action_description"
  ],
  "properties": {
    "action_description": {
      "type": "string",
      "description": "Natural language stack action. Examples: \"add thorne-vitamin-d-k2\", \"remove life-extension-magnesium\", \"swap thorne-creatine for momentous-creatine\""
    }
  }
}

suppco_refresh_stack_score

Kick off a StackScore refresh. The score recalculates asynchronously and takes a few minutes. Only use when the user confirms they want to refresh.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

suppco_remove_from_cart

Remove a product from the signed-in user's cart, or set remove_unavailable to true to clear items that are no longer available. Removing a product removes every cart line for it, one-time and subscription. Returns the updated cart.

destructive

Argument	Type	Description
product_id_or_slug	string	SuppCo product ID (UUID) or slug of the product to remove, as shown by suppco_get_my_cart.
remove_unavailable	boolean	true to remove every item that is no longer available (the stale items suppco_get_my_cart lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "product_id_or_slug": {
      "type": "string",
      "description": "SuppCo product ID (UUID) or slug of the product to remove, as shown by suppco_get_my_cart."
    },
    "remove_unavailable": {
      "type": "boolean",
      "description": "true to remove every item that is no longer available (the stale items suppco_get_my_cart lists)."
    }
  }
}

suppco_remove_from_stack

Use this when the user has stopped taking a product or wants it off their SuppCo stack. Removes the product from the signed-in user's stack. `id` is a SuppCo product UUID or slug, as shown by suppco_get_my_stack.

destructive

Argument	Type	Description
id*	string	SuppCo Product ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "SuppCo Product ID"
    }
  }
}

suppco_save_memory

Use this when the user explicitly asks SuppCo to remember a preference or fact about them for future SuppCo conversations. Saves one short note to their SuppCo account.

Argument	Type	Description
memory*	string	The note to remember

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "memory"
  ],
  "properties": {
    "memory": {
      "type": "string",
      "description": "The note to remember"
    }
  }
}

suppco_search_effects

Use this when the user asks what published research says about a supplement: its overall effects, or whether it does something for a specific health area such as heart health, stress or focus. Also use it when the user asks which supplements have the most research behind them for a health area. Returns SuppCo's summaries of published studies with evidence grades. General information only; does not diagnose, treat or recommend treatment for any condition. For dosing and nutrient basics, use suppco_get_nutrient_info; for a full supplement routine for a goal, use suppco_search_protocols.

read-only

Argument	Type	Description
supplement_name	string	The supplement name (e.g., "Fish Oil", "Magnesium"). Optional - omit to search for all supplements related to the condition.
health_condition	string	The health area or outcome to look up (e.g., "Heart Health", "Bone & Joint Health", "Focus and Attention"). Optional - omit to get all research for a supplement.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "supplement_name": {
      "type": "string",
      "description": "The supplement name (e.g., \"Fish Oil\", \"Magnesium\"). Optional - omit to search for all supplements related to the condition."
    },
    "health_condition": {
      "type": "string",
      "description": "The health area or outcome to look up (e.g., \"Heart Health\", \"Bone & Joint Health\", \"Focus and Attention\"). Optional - omit to get all research for a supplement."
    }
  }
}

suppco_search_protocols

Use this when the user asks for a supplement protocol for a health goal, such as sleep, energy or weight loss. Searches SuppCo's protocols and returns the matches. For protocols the user already follows, use suppco_get_my_protocols.

read-only

Argument	Type	Description
query*	string	Query (e.g., 'Protocol for weight loss')

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Query (e.g., 'Protocol for weight loss')"
    }
  }
}

suppco_swap_products

Use this when the user wants to replace a product in their stack with a different one, for example after comparing alternatives. Removes old_product_id from the stack and adds new_product_id. Both are SuppCo product UUIDs or slugs.

destructive

Argument	Type	Description
new_product_id*	string	SuppCo Product ID to add
old_product_id*	string	SuppCo Product ID to remove

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "old_product_id",
    "new_product_id"
  ],
  "properties": {
    "new_product_id": {
      "type": "string",
      "description": "SuppCo Product ID to add"
    },
    "old_product_id": {
      "type": "string",
      "description": "SuppCo Product ID to remove"
    }
  }
}

suppco_update_cart_item

Set the quantity of a product that is already in the signed-in user's cart. quantity is the new total, not an amount to add, so repeating the call is safe; 0 removes the item. If the product is in the cart as both a one-time purchase and a subscription, set subscription to choose which one to change. Returns the updated cart.

destructive

Argument	Type	Description
quantity*	integer	New total number of units for this item. 0 removes it.
subscription	boolean	true to change the subscription item, false for the one-time item. Only needed when the product is in the cart as both.
product_id_or_slug*	string	SuppCo product ID (UUID) or slug of a product in the cart, as shown by suppco_get_my_cart.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id_or_slug",
    "quantity"
  ],
  "properties": {
    "quantity": {
      "type": "integer",
      "minimum": 0,
      "description": "New total number of units for this item. 0 removes it."
    },
    "subscription": {
      "type": "boolean",
      "description": "true to change the subscription item, false for the one-time item. Only needed when the product is in the cart as both."
    },
    "product_id_or_slug": {
      "type": "string",
      "description": "SuppCo product ID (UUID) or slug of a product in the cart, as shown by suppco_get_my_cart."
    }
  }
}

suppco_update_my_profile

Use this when the user gives profile details they want saved: age, sex, health goals, dietary preferences, experience level, buying preference, preferred form or biggest challenge. Only the fields you pass are changed, and each one replaces the stored value. Saved preferences change the defaults other SuppCo tools use, such as product search ranking.

destructive

Argument	Type	Description
age	integer	User's age in years (integer between 13 and 150)
sex	string	User's biological sex (valid options: male, female, intersex, not_specified)
expertise	string	User's experience level with supplements (valid options: Beginner, Routine, SuperUser)
health_goals	array	User's health goals as an array, CSV string, or single string (valid options: Bone & Joint, Cardiovascular, Cognition, Detox, Energy, Essential Health, Fertility, Fitness, Gut Health, Hair & Skin, Immune Support, Inflammation, Longevity, Men's Hormones, Organ Function, Sexual Health, Sleep, Stress & Mood, Weight Management, Women's Hormones)
preferred_form	string	User's preferred supplement form (valid options: Single Ingredient, Blends, Both)
biggest_challenge	string	User's biggest challenge with supplements (free text)

suppco_update_product_schedule

Use this when the user wants to change when or how they take a product that is already in their stack. Replaces that product's schedule: time-of-day amounts, daily, specific-days or every-other-day timing, as-needed, with food, and timing notes.

destructive

Argument	Type	Description
schedule*	string	JSON array of time-slot assignments, e.g. [{"activity":"morning","units":2},{"activity":"bedtime","units":1}]. "units" is the number of capsules/tablets/scoops for that time slot — NOT servings. Valid activities: morning, midday, evening, bedtime, workout, unscheduled.
as_needed	string	Whether the product is taken as needed (true/false). Omit to keep the current value — only pass it when the user asked to change it.
with_food	string	Whether the product should be taken with food (true/false). Omit to keep the current value — only pass it when the user asked to change it.
product_id*	string	Product slug or UUID
schedule_days	string	Array of day names (e.g. ["monday","wednesday","friday"]) for specific_days schedule_type
schedule_type	string	Schedule type: daily, specific_days, or every_other_day

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id_or_slug"
  ],
  "properties": {
    "form": {
      "type": "string",
      "description": "Comma-separated product forms. Valid: capsule, tablet, softgel, gummy, powder, liquid, other."
    },
    "priority": {
      "enum": [
        "best_value",
        "most_trusted",
        "most_popular",
        "most_expensive"
      ],
      "type": "string",
      "description": "How to rank alternatives. Valid: best_value, most_trusted, most_popular, most_expensive. Defaults to most_trusted."
    },
    "servings": {
      "type": "string",
      "description": "Comma-separated serving counts (e.g., '30,60,90')."
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in dollars."
    },
    "certifications": {
      "type": "string",
      "description": "Required certifications, comma-separated. Valid: gluten_free, non_gmo, vegan_action, usda_organic, nsf_sport, usp_verified, informed_sport, informed_choice, tested_by_suppco."
    },
    "product_id_or_slug": {
      "type": "string",
      "description": "The product to compare against the Buying Club — usually one the user already takes (e.g. from suppco_get_my_stack). A UUID, slug, or product name."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "form": {
      "type": "string",
      "description": "Comma-separated product forms. Valid: capsule, tablet, softgel, gummy, powder, liquid, other."
    },
    "brand": {
      "type": "string",
      "description": "Restrict to a specific brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 24,
      "minimum": 1,
      "description": "Max products to return (default: 5, max: 24)."
    },
    "query": {
      "type": "string",
      "description": "Free-text search for a specific product by name (e.g., \"Thorne Creatine\"). Use alone, without filters. For filtered searches use product_category_name instead."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of products to skip for pagination (default: 0)."
    },
    "tested": {
      "type": "boolean",
      "description": "When true, only products TESTED by SuppCo."
    },
    "priority": {
      "enum": [
        "best_value",
        "most_trusted",
        "most_popular",
        "most_expensive"
      ],
      "type": "string",
      "description": "How to rank results. Valid: best_value, most_trusted, most_popular, most_expensive. Defaults to most_trusted."
    },
    "servings": {
      "type": "string",
      "description": "Comma-separated serving counts (e.g., '30,60,90')."
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in dollars (e.g., 50.00)."
    },
    "certifications": {
      "type": "string",
      "description": "Required certifications, comma-separated. Valid: gluten_free, non_gmo, vegan_action, usda_organic, nsf_sport, usp_verified, informed_sport, informed_choice, tested_by_suppco."
    },
    "product_category_name": {
      "type": "string",
      "description": "The supplement category to browse (e.g., 'Vitamin D', 'Magnesium', 'Creatine'). Required for any filtered search. When the user names a supplement like 'magnesium', that IS the category."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "form": {
      "type": "string",
      "description": "Comma-separated list of product forms. Valid forms are: capsule, tablet, softgel, gummy, powder, liquid, other (e.g., 'capsule,tablet')"
    },
    "brand": {
      "type": "string",
      "description": "The brand a user prefers"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of products to return (default: 5, max: 50)"
    },
    "query": {
      "type": "string",
      "description": "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": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of products to skip for pagination (default: 0)"
    },
    "tested": {
      "type": "boolean",
      "description": "When true, only return products that have been TESTED by SuppCo (identity, potency, and/or heavy metals testing performed by SuppCo's lab)"
    },
    "priority": {
      "enum": [
        "best_value",
        "most_trusted",
        "most_popular",
        "most_expensive"
      ],
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "Comma-separated list of serving counts (e.g., '30,60,90')"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in dollars (e.g., 50.00)"
    },
    "certifications": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "age": {
      "type": "integer",
      "maximum": 150,
      "minimum": 13,
      "description": "User's age in years (integer between 13 and 150)"
    },
    "sex": {
      "enum": [
        "male",
        "female",
        "intersex",
        "not_specified"
      ],
      "type": "string",
      "description": "User's biological sex (valid options: male, female, intersex, not_specified)"
    },
    "expertise": {
      "enum": [
        "Beginner",
        "Routine",
        "SuperUser"
      ],
      "type": "string",
      "description": "User's experience level with supplements (valid options: Beginner, Routine, SuperUser)"
    },
    "health_goals": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User's health goals as an array, CSV string, or single string (valid options: Bone & Joint, Cardiovascular, Cognition, Detox, Energy, Essential Health, Fertility, Fitness, Gut Health, Hair & Skin, Immune Support, Inflammation, Longevity, Men's Hormones, Organ Function, Sexual Health, Sleep, Stress & Mood, Weight Management, Women's Hormones)"
    },
    "preferred_form": {
      "enum": [
        "Single Ingredient",
        "Blends",
        "Both"
      ],
      "type": "string",
      "description": "User's preferred supplement form (valid options: Single Ingredient, Blends, Both)"
    },
    "biggest_challenge": {
      "type": "string",
      "description": "User's biggest challenge with supplements (free text)"
    },
    "buying_preference": {
      "enum": [
        "Highest quality available",
        "Best value",
        "Most affordable"
      ],
      "type": "string",
      "description": "User's supplement buying preference (valid options: Highest quality available, Best value, Most affordable)"
    },
    "dietary_preferences": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User's dietary preferences as an array"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id",
    "schedule"
  ],
  "properties": {
    "schedule": {
      "type": "string",
      "description": "JSON array of time-slot assignments, e.g. [{\"activity\":\"morning\",\"units\":2},{\"activity\":\"bedtime\",\"units\":1}]. \"units\" is the number of capsules/tablets/scoops for that time slot — NOT servings. Valid activities: morning, midday, evening, bedtime, workout, unscheduled."
    },
    "as_needed": {
      "type": "string",
      "description": "Whether the product is taken as needed (true/false). Omit to keep the current value — only pass it when the user asked to change it."
    },
    "with_food": {
      "type": "string",
      "description": "Whether the product should be taken with food (true/false). Omit to keep the current value — only pass it when the user asked to change it."
    },
    "product_id": {
      "type": "string",
      "description": "Product slug or UUID"
    },
    "schedule_days": {
      "type": "string",
      "description": "Array of day names (e.g. [\"monday\",\"wednesday\",\"friday\"]) for specific_days schedule_type"
    },
    "schedule_type": {
      "type": "string",
      "description": "Schedule type: daily, specific_days, or every_other_day"
    },
    "schedule_notes": {
      "type": "string",
      "description": "Brief timing instructions that the schedule cannot capture (e.g., \"take 2 hours apart from calcium\", \"take on empty stomach 30 min before bed\"). Set to empty string to clear."
    },
    "change_daily_amount": {
      "type": "string",
      "description": "Set true ONLY when the user asked to change how many units they take per day. Without it, a schedule whose total differs from the current daily amount is rejected, so timing changes keep the same total."
    },
    "every_other_day_start": {
      "type": "string",
      "description": "When to start every_other_day schedule: \"today\" or \"tomorrow\""
    }
  }
}