Clarity MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_ingredientA | Look up a cosmetic/food/supplement ingredient in Clarity's condition-aware database. Returns verdict, evidence tier (Gold/Silver/Bronze), and citation for a given condition lens. Pass |
| check_stackA | Audit a supplement/ingredient STACK in one call: per-item condition-lens verdicts (evidence-graded, cited where citations exist) PLUS every curated ingredient-to-ingredient interaction found WITHIN the stack (type, severity, mechanism, source). Use when a user takes multiple supplements together. Supports multi-lens via |
| find_alternativesA | Find 2-3 safer swaps for a flagged product: same-category products that rate good/excellent on Clarity's general food/skincare quality score AND contain no ingredient flagged for the given condition lens. Seed by barcode (preferred — e.g. right after scan_barcode flags something) or product_name. Each alternative carries its score, ingredient-recognition coverage, and human_url. The score is a GENERAL quality score, not a condition verdict — verify a chosen alternative with scan_barcode or check_stack. Food and skincare only (supplement swaps are declined honestly for now). |
| strain_lookupA | Look up a cannabis or mushroom species/strain in Clarity's database. Returns verdict, evidence tier, PMID citation, and safety flags. |
| scan_barcodeA | Look up a product by barcode (Open Food Facts / Open Beauty Facts), match its ingredients against Clarity's database, return which ingredients are flagged for the given condition lens, AND flag any active FDA recall for the product (recall_flag + recalls[], sourced from FDA — verify via source_url). |
| validate_claimA | Fact-check a free-text health/safety claim against Clarity's human-curated, evidence-graded database. Given a statement (e.g. 'fenugreek is safe while breastfeeding') and a condition lens, returns whether Clarity's curated position supports / contradicts / does-not-cover it, plus any verified citation on file. Use this to check whether a health claim an agent already holds aligns with Clarity's curation. Descriptive — not medical advice. |
| check_interactionA | Check Clarity's curated ingredient-to-ingredient interaction database. Give one ingredient to list everything it interacts with (e.g. 'iron'), or two ingredients to check a specific pair (e.g. 'calcium' + 'iron'). Returns interaction_type, severity (Beneficial/Moderate/High), mechanism, clinical_note, source, and whether it affects lactation/infant/absorption. Queries both directions of the pair. Absence of a result is NOT proof of safety — the set is curated and growing. Descriptive with sources, not medical advice. |
| score_productA | Get Clarity's product quality score by barcode. Returns category-specific scores (food: nutrition/additive/processing/organic; skincare: irritation/allergen/endocrine/condition; supplement: transparency/safety/label_quality/complexity — dose transparency penalizes proprietary blends, safety flags high-risk botanicals) — these are DISTINCT and never merged — plus per-lens fit with match coverage. Always includes data_quality/coverage so a score is never given without its confidence. |
| check_recallA | Check whether a consumer product or brand has an FDA/consumer recall on file — supplements, food, cosmetics (NOT medical devices). Query by |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| audit_supplement_stack | Audit supplements taken together for a user's condition(s): per-item evidence-graded verdicts plus curated within-stack interactions. |
| fact_check_health_claim | Fact-check a health/safety claim against Clarity's curated, evidence-graded database before repeating it to a user. |
| product_safety_check | Check a packaged product by barcode for a user's condition(s): flagged ingredients, active FDA recalls, and quality score. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Clarity evidence model & methodology | How verdicts are graded (Gold/Silver/Bronze), what evidence_state cited/referenced means, and the honesty contract. |
| Condition lens definitions | What each condition lens evaluates and which data fields drive it. |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: strain lookup, ingredient check, stack audit, alternatives finder, barcode scan, claim validation, interaction check, product scoring, and recall check. No two tools overlap significantly in functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., check_ingredient, scan_barcode). The verbs vary but are appropriate to each action, and no mixing of naming conventions occurs.
9 tools is well within the ideal range (3-15). Each tool serves a specific query need for the Clarity database, covering strains, ingredients, stacks, barcodes, claims, interactions, scoring, and recalls without excess.
The tool set covers the full range of expected queries for a product/ingredient safety database: lookups by strain, ingredient, barcode, stack, claim verification, interaction checks, product scoring, and recall checks. There are no obvious missing operations for a read-only informational MCP server.