# Clarity by Health AI MCP server

Condition-aware ingredient and product checks for agents, with evidence tiers and citations.

## Links
- Registry page: https://www.getdrio.com/mcp/com-healthai-clarity
- Repository: https://github.com/healthai-hq/clarity-project
- Website: https://healthai.com/clarity/api/

## Install
- Endpoint: https://mcp.healthai.com
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.healthai.com

## Tools
- check_ingredient (Check an ingredient) - 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 `lenses` (array) instead of `lens` to check several conditions in ONE call (profile-shaped checking, e.g. a user who is pregnant AND has MCAS) — results then carry a per-lens breakdown under `lenses{}`. Every result includes human_url, a live Clarity page to hand the user as the source link. Endpoint: https://mcp.healthai.com
- check_stack (Audit a supplement stack) - 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 `lenses`. Absence of an interaction is NOT proof of safety — the curated set is growing. Every result includes human_url for the user. Endpoint: https://mcp.healthai.com
- find_alternatives (Find safer product alternatives) - 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). Endpoint: https://mcp.healthai.com
- strain_lookup (Look up a cannabis or mushroom strain) - Look up a cannabis or mushroom species/strain in Clarity's database. Returns verdict, evidence tier, PMID citation, and safety flags. Endpoint: https://mcp.healthai.com
- scan_barcode (Scan a product barcode) - 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). On a local-mirror miss, the tool may query Open Food/Beauty Facts, refresh Clarity's product mirror, and count unmatched ingredient tokens for coverage improvement. Endpoint: https://mcp.healthai.com
- validate_claim (Validate a health claim) - 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. Uncovered statements may be counted in Clarity's review queue; do not include personal information. Descriptive — not medical advice. Endpoint: https://mcp.healthai.com
- check_interaction (Check ingredient interactions) - 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. Endpoint: https://mcp.healthai.com
- score_product (Score a product) - 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. Endpoint: https://mcp.healthai.com
- check_recall (Check a consumer-product recall) - Check whether a consumer product or brand has an FDA/consumer recall on file — supplements, food, cosmetics (NOT medical devices). Query by `brand` (primary), optionally narrow by `product_name`. Returns recall_flag, whether any active Class I (most serious) recall exists, and each matching record with classification, reason, date, status, and a source_url to verify. Recall data has no barcode, so matches are brand/name text matches — confirm via source_url. For medical-DEVICE recalls, use the radar MCP (com.healthai/radar). Endpoint: https://mcp.healthai.com

## Resources
- clarity://methodology - How verdicts are graded (Gold/Silver/Bronze), what evidence_state cited/referenced means, and the honesty contract. MIME type: text/markdown
- clarity://lenses - What each condition lens evaluates and which data fields drive it. MIME type: text/markdown

## Prompts
- audit_supplement_stack - Audit supplements taken together for a user's condition(s): per-item evidence-graded verdicts plus curated within-stack interactions. Arguments: ingredients, conditions
- fact_check_health_claim - Fact-check a health/safety claim against Clarity's curated, evidence-graded database before repeating it to a user. Arguments: statement, condition
- product_safety_check - Check a packaged product by barcode for a user's condition(s): flagged ingredients, active FDA recalls, and quality score. Arguments: barcode, conditions

## Metadata
- Owner: com.healthai
- Version: 0.7.8
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 30, 2026
- Source: https://registry.modelcontextprotocol.io