Model Context Protocol

Clarity MCP

Condition-aware ingredient intelligence for agents. Every answer carries its verdict, its evidence tier, and — honestly — how well-evidenced it is.

Transport Streamable HTTP · JSON-RPC 2.0 at POST / · v0.3.0

Tools

check_ingredient

Verdict, evidence tier, evidence_state & citations for an ingredient, under a condition lens.

scan_barcode

Resolve a product by barcode, flag its ingredients for the lens, and surface any active FDA recall.

score_product

Category-distinct quality scores (food / skincare / supplement) with match-coverage confidence.

strain_lookup

Cannabis & mushroom species verdicts with tier and PMID references.

Evidence model — honesty over completeness

Gold primary-source + human-reviewed Silver literature-cited + reviewed Bronze curated, review in progress

Each lens also reports evidence_state: cited · curated_uncited · not_assessed. The verdict is always there; the state tells you how far to trust it.

Quick start

curl -s https://mcp.healthai.com \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"check_ingredient",
                 "arguments":{"name":"aged cheddar cheese","lens":"histamine"}}}'

List tools with {"method":"tools/list"}. Condition lenses: breastfeeding, pregnancy, histamine, mcas, rosacea, hs, allergy, fertility, toddler.

Access

Free, 60 tool calls/min per client. Send an X-API-Key header for higher, metered limits. Bulk snapshots & high-volume commercial access are licensed — hello@healthai.com.