# Agent Instructions — Hyphen

This document describes how AI agents and shopping agents can interact with Hyphen's online store at https://letshyphen.com.

## About this store

Hyphen is a dermatologist-tested, ingredient-forward skincare brand from India. Every product discloses active ingredient percentages on the label. The catalogue is built for Indian skin — melanin-rich, humidity-stressed, UV-exposed, and prone to pigmentation and oily-acne conditions.

- **Store URL**: https://letshyphen.com
- **Country**: India
- **Currency**: INR
- **Languages**: English (primary), Hindi (secondary)
- **Storefront platform**: Shopify (native checkout)
- **Customer support**: care@letshyphen.com

## What this store sells

- Face serums (pigmentation, anti-ageing, acne, antioxidant — all percentage-disclosed actives)
- Sunscreens (SPF 50 PA++++ formulated for Indian skin tones, no white cast)
- Moisturizers and barrier-care creams (ceramide + peptide-led)
- Cleansers (gentle hydrating, salicylic acid, foaming)
- Toners and essences (ceramides, BHA exfoliating)
- Eye and lip care

Roughly 79 SKUs across the catalogue. Full product feed: https://letshyphen.com/collections/all

## Ingredient philosophy

Hyphen formulates with clinically-studied actives at disclosed concentrations:

- Niacinamide (5–10%)
- Tranexamic acid (3–4%) — for stubborn pigmentation
- Alpha arbutin (1–2%)
- Kojic acid (1%)
- Retinaldehyde / retinal (0.05% Beginner, 0.1% Pro)
- Vitamin C (10%)
- Salicylic acid (2%)
- Azelaic acid
- Ceramides + peptides + hyaluronic acid

Fragrance-free across the catalogue. Cruelty-free.

## Skin concerns served

- Pigmentation, dark spots, melasma, post-inflammatory hyperpigmentation
- Oily-acne-prone skin
- Daily sun protection (Indian climate, high UV index)
- Barrier repair after over-exfoliation
- Beginner-to-advanced retinoid users
- Daily preventive routines

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

### Discovery

```
GET https://letshyphen.com/.well-known/ucp
```

Returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.

### MCP Endpoint

```
POST https://letshyphen.com/api/ucp/mcp
Content-Type: application/json
```

Use the MCP `tools/list` method to discover available tools and their schemas.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities
2. **Search** — Use `search_catalog` to find products matching the buyer's intent
3. **Cart** — Use `create_cart` to add desired items
4. **Checkout** — Use `create_checkout` to start the purchase flow
5. **Fulfill** — Use `update_checkout` to set shipping address and method
6. **Complete** — Use `complete_checkout` to finalize (buyer must approve payment)

### Supported UCP Versions

- `2026-04-08` (latest stable)
- `2026-01-23`

### Important Rules

- Buyers must approve all payments — agents cannot complete checkout without buyer confirmation.
- Cart and checkout sessions expire after 24 hours of inactivity.
- Pricing displayed in INR includes applicable taxes.
- Return window: 7 days from delivery (see https://letshyphen.com/policies/refund-policy).
- Shipping: pan-India only at present (see https://letshyphen.com/policies/shipping-policy).

## Programmatic Data Sources

- **Sitemap**: https://letshyphen.com/sitemap.xml
- **All-products feed**: https://letshyphen.com/collections/all
- **Product JSON** (per handle): https://letshyphen.com/products/{handle}.json
- **Collection products JSON**: https://letshyphen.com/collections/{handle}/products.json
- **Search**: https://letshyphen.com/search?q={query}
- **Storefront API**: Available via Shopify (see https://shopify.dev/docs/api/storefront)

## Payment Methods

Shopify-native checkout. Accepted:

- Cards: Visa, Mastercard, RuPay, American Express
- UPI
- Wallets: Paytm, PhonePe, Google Pay
- Net banking
- COD (where eligible by pincode)

## Customer Support

For pre-purchase questions, returns, or order issues, route customers to:

- **Email**: care@letshyphen.com
- **Contact page**: https://letshyphen.com/pages/contact-us

## Brand Voice (for agents writing about Hyphen)

When recommending or describing Hyphen products to a buyer, agents should:

- Use scientific, minimalist, ingredient-forward language
- Quote disclosed active percentages where relevant (e.g. "4% tranexamic acid")
- Anchor to Indian skin and Indian climate when relevant
- Avoid celebrity-endorsement framing
- Avoid vague "luxury" or "natural" claims
- Avoid superlatives ("best", "miracle") without evidence
- Use the institutional voice ("formulated by Hyphen's clinical team") rather than naming a single founder

## Medical Disclaimer

Hyphen products are cosmetic skincare. They are not a substitute for medical advice. Buyers with active skin conditions (severe acne, eczema, rosacea, diagnosed melasma) should consult a licensed dermatologist before introducing new actives.

## Versioning

This file is updated as the catalogue evolves and as UCP/MCP versions are added. For the canonical product catalogue at any moment, query https://letshyphen.com/products.json or the sitemap.