thehealthai/clarity-mcp

Clarity is a condition-aware ingredient checker and scanner for wellness,
fitness, tracker, and health-AI workflows. Results can include a verdict, an
evidence tier (Gold/Silver/Bronze), and citations when available.
Hosted MCP server — no install and no key required for anonymous,
rate-limited access. Endpoint:
**https://mcp.healthai.com** (Streamable HTTP, JSON-RPC 2.0). Published to the
official MCP Registry as **com.healthai/clarity** (domain-verified namespace).
For a human-readable implementation guide covering Claude.ai, Claude Code,
OpenAI's Responses API, generic remote MCP configuration, tool boundaries, and
the MCP-versus-REST decision, see
**healthai.com/clarity/mcp**.
Use it
**Claude Code:**
**Claude Desktop / Cursor / any client with native remote MCP** — add to the
config's mcpServers:
For older clients without native remote support, bridge with mcp-remote:
"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.healthai.com"].
**OpenAI Responses API:** pass the hosted endpoint as a remote MCP tool and
keep approvals enabled while evaluating it:
Tools (9)
| Tool | What it answers |
|---|---|
| check_ingredient | Verdict + evidence tier + citation for a cosmetic/food/supplement ingredient, under one condition lens or several at once (lenses: [..]) |
| check_stack | Audit a supplement stack in one call: per-item condition verdicts plus every curated interaction within the stack |
| find_alternatives | Safer same-category swaps for a flagged product — general quality-score ranked, lens-flag screened, coverage-honest (food/skincare; verify the pick with scan_barcode) |
| strain_lookup | Verdict, tier, PMID citation and safety flags for a cannabis or mushroom species/strain |
| scan_barcode | Look up a product by UPC/EAN, flag its ingredients for a condition lens, and surface any active FDA recall |
| validate_claim | Fact-check a free-text health claim against Clarity's curated position — supports / contradicts / does-not-cover, with citation |
| check_interaction | Curated ingredient-to-ingredient interactions — type, severity, mechanism, clinical note, source (single or pair) |
| score_product | Category-specific product quality score by barcode (food / skincare / supplement), each dimension distinct, always with data-quality coverage |
| check_recall | Consumer-product recall matches by brand and optional product name, with source URLs and a medical-device scope boundary |
**Condition lenses:** breastfeeding, lactation, pregnancy, histamine,
mcas, rosacea, hs, allergy, all.
Every result includes human_url — a live Clarity page for that exact answer
(gated against the site's keep-list so it never 410s), for agents to hand their
user as the source link. The server also exposes MCP prompts
(audit_supplement_stack, fact_check_health_claim, product_safety_check) and
resources (clarity://methodology, clarity://lenses).
Anonymous use is rate-limited to 60 tool calls/min per IP (Durable Object