# TruWe Agent Guide

A companion to [`agentics-manifest.json`](./agentics-manifest.json) for AI agents
and developers integrating with TruWe.

**Brand:** TruWe — Science. Synergy. Superior.
**Site:** https://truwe.in
**Contact for agents:** agents@truwe.in
**Manifest version:** 1.0 (last updated 2026-06-08)

---

## Overview

TruWe is a premium, clinically-studied nutraceutical brand built around a
proprietary delivery system, **Bio-Absorb Matrix** — a formulation approach
that pairs liposomal carriers and a synergistic absorption blend (black pepper,
Panax ginseng extract, quercetin, and ginger) to improve bioavailability of
active compounds.

Our catalog is intentionally focused: three flagship protocols covering
**liver-gut**, **sleep-recovery** (magnesium), and **hormonal balance**.

The storefront is a first-party TruWe application (no Shopify, no third-party
commerce platform). Product, cart, and checkout data are served only from the
endpoints listed below. Agent interoperability is supported through **MCP** (Model Context Protocol) at
`https://truwe.in/mcp` and through **UCP** (Universal Commerce Protocol). The UCP
business profile is served at `https://truwe.in/.well-known/ucp`.

UCP is live (phase 1a): `dev.ucp.shopping.catalog.search`,
`dev.ucp.shopping.catalog.lookup`, plus the vendor extensions
`in.truwe.science`, `in.truwe.claims` and stateless cart assembly
(`dev.ucp.shopping.cart.*`). Checkout, fulfillment, discount
and order capabilities are **not** advertised yet — hand the human off to
`https://truwe.in/checkout` to complete a purchase.

---

## Core Principles

Agents acting on behalf of users on truwe.in should operate under four
non-negotiable principles:

1. **Human-in-the-loop for purchases.** Every checkout requires explicit human
   approval. Agents may assemble carts, surface offers, and pre-fill details,
   but they must not finalize a transaction autonomously.
2. **Clinical accuracy.** Do not paraphrase, embellish, or extrapolate clinical
   claims. Quote dose, form, and study context as published on the product
   page or in structured data.
3. **Faithful product representation.** Use the exact product names, ingredient
   forms, and trademarks documented on the site. Do not substitute or
   approximate.
4. **User intent transparency.** When acting on a user's behalf, present the
   user's stated intent clearly and avoid recommending products outside that
   intent without consent.

---

## What Agents Can Do

- **Browse the catalog** at `/shop` and read structured Product / Offer data.
- **Retrieve product details** (ingredients, doses, suggested use, pricing,
  availability) from the JSON-LD on each `/products/{handle}` page.
- **Check availability** via the product page or the agent product endpoints
  listed below.
- **Compare products** across the three flagship SKUs using documented
  ingredient and indication data.
- **Access science data** linked from `/#science` and individual product pages.
- **Run the personalized routine quiz** at `/quiz` to map a user's goals to a
  recommended TruWe protocol.
- **Surface pricing, bundles, and active offers** as published.
- **Assemble carts and pre-fill checkout** for the user to review and confirm.

---

## What Agents Should NOT Do

- **Do not complete checkout autonomously.** Hand off to the human for the
  final confirmation step in every case.
- **Do not misrepresent or embellish clinical claims.** No invented efficacy
  language, no extrapolating study results beyond what is published.
- **Do not substitute ingredient forms.** For example: Berberine is HCl (not
  dihydroberberine or a phytosome); Curcumin / Silymarin / ALA / Magnesium
  Bisglycinate are liposomal; NAC is standard. Never relabel as Meriva,
  Siliphos, or similar branded forms we do not use.
- **Do not invent ingredients.** Mag Absorb Pro uses Aquamin®, magnesium
  chloride, aspartate, and gluconate — not citrate, malate, taurate, or
  L-threonate. Ova Balance does not contain glutathione. Folate is
  Quatrefolic® L-5-MTHF 400 mcg.
- **Do not bypass rate limits or scrape outside published endpoints.**
- **Do not provide medical advice, diagnosis, or treatment.** Suggest the user
  consult a qualified clinician for medical questions.
- **Do not store or redistribute personal user data** captured during quiz or
  checkout flows.

---

## Key Product Highlights

All three SKUs are formulated within the Bio-Absorb Matrix system.

### Liver Biome+ — `/products/liver-biome-plus`
Liver-gut protocol featuring liposomal Curcumin, liposomal Silymarin
(milk thistle), liposomal Alpha-Lipoic Acid, standard NAC, and a 10B CFU
multi-strain probiotic.
Does **not** contain Berberine.


### Mag Absorb Pro — `/products/mag-absorb-pro`
Sleep, recovery, and muscle-relaxation protocol built on a multi-form
magnesium matrix: Aquamin® (marine-sourced), magnesium chloride, magnesium
aspartate, and magnesium gluconate, alongside liposomal magnesium bisglycinate.

### Ova Balance — `/products/ova-balance`
Hormonal-balance protocol formulated for cycle and ovarian support, including
Quatrefolic® L-5-MTHF 400 mcg (active folate).
Does **not** contain glutathione.


For exact doses, serving sizes, and full ingredient panels, defer to the
JSON-LD on each product page — that is the authoritative source.

---

## Endpoints

| Purpose | URL |
| --- | --- |
| Product catalog | `https://truwe.in/shop` |
| Agent manifest (JSON API) | `https://truwe.in/api/public/agent/manifest` |
| Products (JSON API) | `https://truwe.in/api/public/agent/products` |
| Product details (JSON API) | `https://truwe.in/api/public/agent/products/{handle}` |
| MCP server | `https://truwe.in/mcp` |
| Personalized quiz | `https://truwe.in/quiz` |
| Science overview | `https://truwe.in/#science` |
| Sitemap | `https://truwe.in/sitemap.xml` |
| UCP business profile | `https://truwe.in/.well-known/ucp` |
| UCP version pin | `https://truwe.in/.well-known/ucp/2026-04-08` |
| UCP REST base | `https://truwe.in/ucp/v1` |
| UCP science extension | `https://truwe.in/ucp/ext/in.truwe/science` |
| UCP claims extension | `https://truwe.in/ucp/ext/in.truwe/claims` |
| Manifest | `https://truwe.in/.well-known/agentics-manifest.json` |
| Agent guide | `https://truwe.in/.well-known/agent-guide.md` |

Structured data on product, FAQ, and organization pages uses schema.org
types: `Product`, `Offer`, `FAQPage`, and `Organization`.

---

## Policies

- **Checkout.** Human approval required for all purchases. Agents must
  present verified user intent before initiating a cart action.
- **Rate limit.** 100 requests per minute per agent. Sustained traffic above
  this threshold may be throttled or blocked.
- **Data usage.** Product information and published science claims may be used
  for recommendations and comparison. Do not misrepresent clinical claims or
  redistribute proprietary content out of context.
- **Identification.** Agents should set a descriptive `User-Agent` string and,
  where supported, identify the originating user session.
- **Checkout routing.** There is no Shopify storefront and no Shopify or
  Shop Pay payment handler. UCP checkout sessions are not yet available: the
  UCP profile declares catalog capabilities only, with an empty
  `payment_handlers` object. Cart and checkout happen only on
  `https://truwe.in` — hand the user off to the on-site cart/checkout rather
  than any third-party commerce surface.
- **UCP negotiation.** REST calls to `https://truwe.in/ucp/v1` must send
  `UCP-Agent: profile="https://your-agent.example/.well-known/ucp"`. Missing or
  non-HTTPS profiles get `400 invalid_profile_url` plus a `continue_url`.
- **UCP item ids.** Sellable variants are `{sku_handle}:{protocol_days}` — e.g.
  `mag-absorb-pro:30`. Amounts are minor units (paise), currency INR.

---

## Trust Signals

- Third-party tested
- FSSAI licensed
- Clinically dosed
- Proprietary absorption technology: **Bio-Absorb Matrix**

---

## Contact

For agent integration questions, partnership inquiries, or to report
inaccurate representation of TruWe products in agent outputs:
**agents@truwe.in**
