{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-03-26","serverInfo":{"name":"suppco_mcp_server","title":"SuppCo","version":"1.0.0"},"description":"Supplement research and stack management: search products with TrustScores, brand quality, research-backed effects, nutrients and protocols; signed-in users can manage their stack, plan, labs and StackScore.","iconUrl":"https://supp.co/icon-192x192.png","documentationUrl":"https://supp.co/developers","transport":{"type":"streamable-http","endpoint":"https://api.supp.co/mcp"},"capabilities":{"tools":{"listChanged":true},"prompts":{"listChanged":true},"resources":{"listChanged":true},"logging":{}},"authentication":{"required":false,"schemes":["oauth2"]},"instructions":"SuppCo supplement research and stack management tools. Search products, view research-backed effects, manage supplement stacks, and access personalized recommendations. All tools prefixed with suppco_.","tools":[{"name":"suppco_find_products","description":"RECOMMENDED: Intelligently find supplement products using natural language. This tool automatically determines the best search strategy for your query. Use for: product searches, category browsing, recommendations, health goal searches. Examples: \"best magnesium supplements\", \"find Thorne vitamin D\", \"creatine under $30\", \"supplements for sleep\", \"highest rated fish oil\".","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"query":{"type":"string","description":"Natural language description of what products you are looking for"},"product_category_name":{"type":"string","description":"Supplement category (e.g., 'Vitamin D', 'Magnesium', 'Ashwagandha'). Use this instead of query when applying filters like priority, brand, certifications, etc."},"include_ingredients":{"type":"string","description":"Comma-separated additional ingredients the product must contain beyond its category (e.g., for 'collagen with hyaluronic acid', set product_category_name='Collagen' and include_ingredients='hyaluronic acid')"},"exclude_ingredients":{"type":"string","description":"Comma-separated ingredients the product must NOT contain (e.g., 'stevia,sucralose')"},"priority":{"type":"string","description":"Sorting priority. Options: best_value, most_trusted, most_popular, most_expensive (default: most_trusted)"},"certifications":{"type":"string","description":"Comma-separated certifications (e.g., 'gluten_free,non_gmo')"},"brand":{"type":"string","description":"Filter by brand name"},"max_price":{"type":"number","description":"Maximum price in dollars (e.g., 30.00)"},"servings":{"type":"string","description":"Comma-separated serving counts (e.g., '30,60,90')"},"form":{"type":"string","description":"Comma-separated product forms (e.g., 'capsule,tablet,powder')"},"limit":{"type":"integer","description":"Maximum products to return (default: 10, max: 50)","default":10,"minimum":1,"maximum":50},"offset":{"type":"integer","description":"Number of products to skip for pagination (default: 0)","default":0,"minimum":0}},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/outputTemplate":"ui://widget/product-search-1790631875.html","openai/toolInvocation/invoking":"Finding products...","openai/toolInvocation/invoked":"Found products","openai/widgetAccessible":true,"co.supp/requiresAuth":false}},{"name":"suppco_get_brand_trust_score","description":"Get trust score, quality ratings, certifications, and testing history for a supplement brand.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"brand_name":{"type":"string","description":"Brand name (e.g., Thorne, Life Extension, NOW Foods)"}},"required":["brand_name"],"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/outputTemplate":"ui://widget/brand-trust-1790631875.html","openai/toolInvocation/invoking":"Loading brand information...","openai/toolInvocation/invoked":"Brand information loaded","co.supp/requiresAuth":false}},{"name":"suppco_search_effects","description":"Search research-backed supplement-condition connections with evidence grades (A-F), confidence levels, and supporting studies.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"supplement_name":{"type":"string","description":"Supplement/nutrient name (e.g., \"Fish Oil\", \"Magnesium\", \"Vitamin D\"). Omit to find all supplements for a specific health condition."},"health_condition":{"type":"string","description":"Health condition or goal (e.g., \"Heart Health\", \"Sleep\", \"Cognitive Function\"). Omit to get all researched effects for a specific supplement."}},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/outputTemplate":"ui://widget/effects-search-1790631875.html","openai/toolInvocation/invoking":"Searching research...","openai/toolInvocation/invoked":"Research found","co.supp/requiresAuth":false}},{"name":"suppco_get_nutrient_info","description":"Get nutrient/supplement overview including dosing guidelines, health effects, and research evidence.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"nutrient_name":{"type":"string","description":"The nutrient or supplement name (e.g., \"Vitamin D3\", \"Magnesium\", \"Fish Oil\")"}},"required":["nutrient_name"],"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/outputTemplate":"ui://widget/nutrient-info-1790631875.html","openai/toolInvocation/invoking":"Loading nutrient information...","openai/toolInvocation/invoked":"Nutrient information loaded","co.supp/requiresAuth":false}},{"name":"suppco_search_protocols","description":"Search evidence-based health protocols with supplement stacks for specific health goals.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"query":{"type":"string","description":"Search query for health protocols. Examples: \"longevity\", \"weight loss\", \"improve sleep\", \"athletic performance\", \"cognitive enhancement\""}},"required":["query"],"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/outputTemplate":"ui://widget/protocol-search-1790631875.html","openai/toolInvocation/invoking":"Searching protocols...","openai/toolInvocation/invoked":"Protocols found","co.supp/requiresAuth":false}},{"name":"suppco_get_product_info","description":"Get complete product information including trust score, certifications, testing status, active ingredients, inactive ingredients with risk assessments, and quality details. Accepts one or more products by UUID, slug, or product name (max 5).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"products":{"type":"string","description":"One or more product identifiers separated by ' | ' (max 5). Each can be a UUID, slug, or product name. Prefer slugs or UUIDs when available — they give exact matches. Example: 'thorne-vitamin-d-k2' (single slug), 'Thorne Magnesium | Pure Encapsulations Vitamin D' (multiple by name)."}},"required":["products"],"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}],"co.supp/requiresAuth":false}},{"name":"suppco_get_my_stack","description":"Get user's current supplement stack with all products, dosages, and daily totals.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/outputTemplate":"ui://widget/my-stack-1790631875.html","openai/toolInvocation/invoking":"Loading your stack...","openai/toolInvocation/invoked":"Stack loaded","openai/widgetAccessible":true,"co.supp/requiresAuth":true}},{"name":"suppco_get_my_nutrient_plan","description":"Get user's personalized supplement plan with recommended nutrients and dosages.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/outputTemplate":"ui://widget/nutrient-plan-1790631875.html","openai/toolInvocation/invoking":"Loading your nutrient plan...","openai/toolInvocation/invoked":"Plan loaded","co.supp/requiresAuth":true}},{"name":"suppco_get_my_nutrient_totals","description":"Get total daily nutrients from current stack with comparisons to recommended values.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/outputTemplate":"ui://widget/nutrient-totals-1790631875.html","openai/toolInvocation/invoking":"Calculating nutrients...","openai/toolInvocation/invoked":"Nutrients calculated","co.supp/requiresAuth":true}},{"name":"suppco_get_my_protocols","description":"Get health protocols user is following with progress tracking and supplement recommendations.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/outputTemplate":"ui://widget/my-protocols-1790631875.html","openai/toolInvocation/invoking":"Loading your protocols...","openai/toolInvocation/invoked":"Protocols loaded","co.supp/requiresAuth":true}},{"name":"suppco_update_my_profile","description":"Update user's profile including age, sex, health goals, and supplement preferences.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"age":{"type":"integer","description":"User age in years","minimum":13,"maximum":120},"sex":{"type":"string","enum":["male","female","other"],"description":"Biological sex"},"biggest_challenge":{"type":"string","description":"Biggest challenge with supplements","maxLength":500},"dietary_preferences":{"type":"array","items":{"type":"string"},"description":"Dietary preferences and restrictions. Common values: vegan, vegetarian, gluten-free, dairy-free, soy-free, nut-free, kosher, halal"},"expertise":{"type":"string","description":"Experience level with supplements (e.g., beginner, intermediate, advanced)","maxLength":100},"buying_preference":{"type":"string","description":"Supplement buying preference (e.g., budget-conscious, premium-only, best-value)","maxLength":100},"preferred_form":{"type":"string","description":"Preferred supplement form. Common values: capsule, tablet, powder, liquid, gummy","maxLength":50},"health_goals":{"type":"array","items":{"type":"string"},"description":"Health goals to optimize for. Available goals: Sleep, Energy, Stress & Mood, Cognition, Immune Support, Bone & Joint, Cardiovascular, Organ Health"}},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"co.supp/requiresAuth":true}},{"name":"suppco_save_memory","description":"Save a note or preference about the user for personalized future interactions.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"memory":{"type":"string","description":"The note to remember about the user (preferences, allergies, goals, etc.)","maxLength":1000}},"required":["memory"],"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"co.supp/requiresAuth":true}},{"name":"suppco_manage_stack","description":"Add, remove, or swap products in user's supplement stack using natural language commands.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","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\""}},"required":["action_description"],"type":"object"},"annotations":{"destructiveHint":true,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/widgetAccessible":true,"co.supp/requiresAuth":true}},{"name":"suppco_get_my_lab_report","description":"Get user's latest lab results with biomarker analysis, out-of-range values, and supplement recommendations.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/outputTemplate":"ui://widget/lab-report-1790631875.html","openai/toolInvocation/invoking":"Loading lab results...","openai/toolInvocation/invoked":"Lab results loaded","co.supp/requiresAuth":true}},{"name":"suppco_get_stack_score","description":"Get user's StackScore with ratings across Quality, Value, Goals, and Dosage categories plus coaching recommendations.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"category":{"type":"string","enum":["quality","value","goals","dosage"],"description":"Optional category filter. Available categories: 'quality' (brand trust, certifications), 'value' (cost effectiveness), 'goals' (health goal alignment), 'dosage' (optimal nutrient amounts). Omit to get all categories."}},"type":"object"},"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["mcp"]}],"openai/toolInvocation/invoking":"Calculating your StackScore...","openai/toolInvocation/invoked":"StackScore loaded","co.supp/requiresAuth":true}}],"prompts":[{"name":"research_supplement_evidence","description":"Show evidence-backed benefits and research for a specific supplement or ingredient, including scientific summaries, evidence grades (A-F), and clinical studies","arguments":[{"name":"supplement_name","description":"Name of supplement, ingredient, or nutrient to research (e.g., \"Fish Oil\", \"Magnesium\", \"Vitamin D\")","required":true}]},{"name":"compare_products","description":"Compare supplement products side-by-side including TrustScores, ingredient quality, dosing, pricing, and certifications","arguments":[{"name":"product_or_ingredient","description":"Product name, brand, or ingredient to compare (e.g., \"Thorne Magnesium vs Life Extension Magnesium\", \"creatine options\")","required":true},{"name":"health_goal","description":"Health goal or use case to optimize for (e.g., \"sleep\", \"energy\", \"cardiovascular\")","required":false}]},{"name":"product_deep_dive","description":"Get comprehensive analysis of a specific product including full ingredient breakdown, TrustScore details, third-party testing, certifications, and research backing","arguments":[{"name":"product_name_or_slug","description":"Product name or URL slug (e.g., \"Thorne Vitamin D-K2\" or \"thorne-vitamin-d-k2\")","required":true}]},{"name":"analyze_stack_gaps","description":"Analyze your supplement stack for nutrient gaps, redundancies, and optimization opportunities based on your health goals (requires sign-in)"},{"name":"check_allergy_conflicts","description":"Scan your supplement stack for ingredients that may conflict with allergies, sensitivities, or dietary restrictions (requires sign-in)","arguments":[{"name":"product_name","description":"Specific product to check (if omitted, checks your entire stack)","required":false}]},{"name":"analyze_lab_results","description":"Analyze your blood work results and get personalized supplement recommendations based on biomarker data (requires sign-in)"}]}