Dietary Supplement Analysis (NIH data)
NIH supplement checks: upper limits, drug and herb interactions, FDA recalls, with citations.
我該用這個嗎
品質與安全性
A
發現項目（1）
- LOWTool 'products_lookup' description lacks action verb在 products_lookup 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~3,753Token（工具定義）
~5.0 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.93%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"dietary-supplement-analysis": {
"url": "https://agents.trackmysupplement.com/mcp"
}
}
}遠端端點
https://agents.trackmysupplement.com/mcpstreamable-http它能做什麼
工具清單
工具（7）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢stack_analyze(age, sex, life_stage, detail, lang, ...)
Check a list of dietary supplements for a person: per-nutrient daily totals against NIH upper limits (UL) and RDA/AI, which products overlap, what each UL protects against, and single-product changes that would bring an above-UL nutrient back under it. Products can be given as names ("Centrum Silver Women 50+"), barcodes, DSLD IDs, or custom ingredient lists; optional candidates are evaluated as additions. Pass the person's medications and conditions (smoker, kidney_disease, hemochromatosis, lab_test_soon, cancer_treatment) to check them against the interactions in the NIH fact sheets. Returns agent_summary (plain sentences to relay), resolutions, suggestions, interactions, nutrient_totals and data_gaps. Label data only; food is included only with diet "typical".
輸入結構描述
{
"type": "object",
"properties": {
"age": {
"type": "number",
"minimum": 0,
"maximum": 120,
"description": "Age in years. For infants use a fraction: 0.25 = 3 months; 0-5 and 6-11 month values apply under 1."
},
"sex": {
"type": "string",
"enum": [
"male",
"female"
]
},
"life_stage": {
"type": "string",
"enum": [
"pregnancy",
"lactation"
],
"description": "Pregnancy or lactation (breastfeeding) reference values; requires sex \"female\" and age 14-50"
},
"detail": {
"default": "full",
"description": "\"summary\" returns only what an agent needs to answer (agent_summary, flagged nutrients, suggestions, resolutions, candidate verdicts), about 1-3 KB instead of 20-40 KB",
"type": "string",
"enum": [
"summary",
"full"
]
},
"lang": {
"default": "en",
"description": "\"es\" writes agent_summary in Spanish (the English text is kept in agent_summary_en); other fields stay in English",
"type": "string",
"enum": [
"en",
"es"
]
},
"diet": {
"default": "none",
"description": "\"typical\" adds the US average intake from food and drinks for this age and sex (NHANES) to estimate total intake; see with_typical_diet",
"type": "string",
"enum": [
"none",
"typical"
]
},
"products": {
"minItems": 1,
"maxItems": 15,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"dsld_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "DSLD label ID, e.g. from /v1/products/search"
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"dsld_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200,
"description": "Product as the user named it, e.g. \"Centrum Silver Women 50+\". Resolved to the best-matching DSLD label; see resolutions[]"
},
"brand": {
"description": "Brand, if known separately",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"query"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"upc": {
"type": "string",
"minLength": 8,
"maxLength": 32,
"description": "UPC-A or EAN barcode digits as printed on the bottle, e.g. \"031604026974\" (spaces and dashes are ignored)"
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"upc"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
},
"ingredients": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"amount": {
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "mg, mcg, g, IU, mcg DFE, mcg RAE, mg NE"
},
"form": {
"description": "Declared form, e.g. \"folic acid\", \"retinyl palmitate\", \"d-alpha tocopherol\"",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"nutrient_basis": {
"description": "For minerals: whether amount is elemental or the whole compound weight",
"type": "string",
"enum": [
"elemental",
"compound"
]
}
},
"required": [
"name",
"amount",
"unit"
]
}
}
},
"required": [
"ingredients"
],
"additionalProperties": false
}
]
},
"description": "1-15 products. Each is one of: {\"dsld_id\"}, {\"query\"} (a product name, resolved server-side), {\"upc\"} (barcode), or a custom product {\"name\",\"ingredients\"}. Add \"servings_per_day\" to any of them."
},
"medications": {
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"description": "Medications the person takes, as generic or brand names (\"warfarin\", \"Synthroid\", \"metformin 500 mg\"). Checked against the medication interactions listed in the NIH ODS fact sheets; not exhaustive. Never logged."
},
"conditions": {
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"smoker",
"kidney_disease",
"hemochromatosis",
"lab_test_soon",
"cancer_treatment"
]
},
"description": "Conditions that change how NIH reads a dose: smoker (current or former, or asbestos exposure: beta-carotene), kidney_disease (potassium, magnesium, phosphorus), hemochromatosis (iron, vitamin C), lab_test_soon (biotin interferes with lab tests), cancer_treatment (antioxidant doses)"
},
"foods": {
"description": "Optional, up to 30: what the person eats in a day, e.g. [{\"query\":\"spinach cooked\",\"amount\":1,\"unit\":\"cup\"},{\"query\":\"whole milk\",\"grams\":488}]. Added to the supplement totals in nutrient_totals[].with_foods (USDA SR28, offline). Use instead of diet \"typical\".",
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"query": {
"description": "Food as the user named it, e.g. \"spinach cooked\", \"whole milk\"; matched to a USDA SR28 food (see foods.items)",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"ndb_number": {
"description": "USDA NDB number (SR Legacy), e.g. \"11458\"",
"type": "string",
"pattern": "^\\d{4,5}$"
},
"grams": {
"description": "Amount eaten per day, in grams",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"amount": {
"description": "Amount in \"unit\" per day, e.g. 1.5 with unit \"cup\"",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"unit": {
"description": "cup, tbsp, tsp, slice, large, medium, oz, lb, kg, g, fl oz... must match a USDA portion for the food (or be a weight)",
"type": "string",
"minLength": 1,
"maxLength": 30
}
},
"additionalProperties": false
}
},
"candidates": {
"description": "Optional, up to 5: products the user is considering adding. Each is evaluated as an addition to the stack in candidate_results[]; they are not included in nutrient_totals.",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"dsld_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "DSLD label ID, e.g. from /v1/products/search"
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"dsld_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200,
"description": "Product as the user named it, e.g. \"Centrum Silver Women 50+\". Resolved to the best-matching DSLD label; see resolutions[]"
},
"brand": {
"description": "Brand, if known separately",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"query"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"upc": {
"type": "string",
"minLength": 8,
"maxLength": 32,
"description": "UPC-A or EAN barcode digits as printed on the bottle, e.g. \"031604026974\" (spaces and dashes are ignored)"
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
}
},
"required": [
"upc"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"servings_per_day": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Servings taken per day. Default: the label maximum daily servings, else 1."
},
"ingredients": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"amount": {
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "mg, mcg, g, IU, mcg DFE, mcg RAE, mg NE"
},
"form": {
"description": "Declared form, e.g. \"folic acid\", \"retinyl palmitate\", \"d-alpha tocopherol\"",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"nutrient_basis": {
"description": "For minerals: whether amount is elemental or the whole compound weight",
"type": "string",
"enum": [
"elemental",
"compound"
]
}
},
"required": [
"name",
"amount",
"unit"
]
}
}
},
"required": [
"ingredients"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"products"
]
}🟢products_search(query, brand, ingredient, on_market_only, limit, ...)
Search the NIH Dietary Supplement Label Database by product name, brand or ingredient. Returns up to 10 products (one per product; older label versions listed in other_versions) with DSLD IDs.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"description": "Free-text search, e.g. \"vitamin d3 5000\"",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"brand": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"ingredient": {
"description": "Ingredient name, e.g. \"cholecalciferol\"",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"on_market_only": {
"default": true,
"type": "boolean"
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 10
},
"dedupe_versions": {
"default": true,
"description": "Collapse label versions of the same product (same brand and name) into one result, newest first; older IDs are listed in other_versions",
"type": "boolean"
}
}
}🟢products_lookup(upc)
Look up a supplement by the UPC/EAN barcode printed on the bottle. Returns the newest matching DSLD label, normalized, and any older versions.
輸入結構描述
{
"type": "object",
"properties": {
"upc": {
"type": "string",
"minLength": 8,
"maxLength": 32,
"description": "UPC-A or EAN barcode digits as printed on the bottle, e.g. \"031604026974\" (spaces and dashes are ignored)"
}
},
"required": [
"upc"
],
"additionalProperties": false
}🟢products_get(dsld_id, dsld_ids)
Full normalized supplement labels by DSLD ID (up to 10): every ingredient with label amount, converted amount, form and %DV.
輸入結構描述
{
"type": "object",
"properties": {
"dsld_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "DSLD label ID, e.g. from /v1/products/search"
},
"dsld_ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "DSLD label ID, e.g. from /v1/products/search"
}
}
}
}🟢interactions_check(medications, conditions, nutrients)
Which vitamins and minerals interact with given medications (generic or brand names, e.g. "warfarin", "Synthroid") or conditions, per the NIH Office of Dietary Supplements fact sheets, with timing advice (e.g. take levothyroxine 4 hours apart from calcium). No product list needed; to check an actual stack, pass medications to stack_analyze instead. Not exhaustive.
輸入結構描述
{
"type": "object",
"properties": {
"medications": {
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"description": "Medications the person takes, as generic or brand names (\"warfarin\", \"Synthroid\", \"metformin 500 mg\"). Checked against the medication interactions listed in the NIH ODS fact sheets; not exhaustive. Never logged."
},
"conditions": {
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"smoker",
"kidney_disease",
"hemochromatosis",
"lab_test_soon",
"cancer_treatment"
]
},
"description": "Conditions that change how NIH reads a dose: smoker (current or former, or asbestos exposure: beta-carotene), kidney_disease (potassium, magnesium, phosphorus), hemochromatosis (iron, vitamin C), lab_test_soon (biotin interferes with lab tests), cancer_treatment (antioxidant doses)"
},
"nutrients": {
"description": "Optional: only report interactions involving these nutrients or botanicals (IDs or names, e.g. \"vitamin-k\", \"magnesium\", \"St. John's wort\")",
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
}
},
"additionalProperties": false
}🟢products_fda_reports(dsld_id, upc, query, brand, name)
FDA recalls and adverse event reports (CAERS) for one supplement, from openFDA. Give a product name, barcode, DSLD ID, or brand and name. Recalls are listed only when they carry the barcode or the brand and every product-name word; adverse event reports are counted with their most common reactions. Reports do not show that a product caused an event.
輸入結構描述
{
"type": "object",
"properties": {
"dsld_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "DSLD label ID, e.g. from /v1/products/search"
},
"upc": {
"type": "string",
"minLength": 8,
"maxLength": 32,
"description": "UPC-A or EAN barcode digits as printed on the bottle, e.g. \"031604026974\" (spaces and dashes are ignored)"
},
"query": {
"description": "Product as the user named it; resolved to a DSLD label",
"type": "string",
"minLength": 2,
"maxLength": 200
},
"brand": {
"description": "Brand (with \"name\", or to narrow \"query\")",
"type": "string",
"minLength": 2,
"maxLength": 100
},
"name": {
"description": "Product name as printed, used with \"brand\" when the product is not in DSLD",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"additionalProperties": false
}🟢nutrients_reference(nutrient, age, sex, life_stage)
NIH reference values (RDA, EAR, AI, UL) for one vitamin or mineral at a given age and sex, with what the UL protects against. Offline and instant.
輸入結構描述
{
"type": "object",
"properties": {
"nutrient": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Nutrient ID (\"vitamin-d\") or any synonym (\"cholecalciferol\")"
},
"age": {
"type": "number",
"minimum": 0,
"maximum": 120,
"description": "Age in years. For infants use a fraction: 0.25 = 3 months; 0-5 and 6-11 month values apply under 1."
},
"sex": {
"type": "string",
"enum": [
"male",
"female"
]
},
"life_stage": {
"type": "string",
"enum": [
"pregnancy",
"lactation"
],
"description": "Pregnancy or lactation (breastfeeding) reference values; requires sex \"female\" and age 14-50"
}
},
"required": [
"nutrient",
"age",
"sex"
]
}社群
證據
近期觀測
已驗證未記錄版本7 個工具