# Agent Instructions — WeightCare

This document tells AI agents, shopping assistants, and other automated tools how to interact with WeightCare at https://joinweightcare.com.

## About WeightCare

WeightCare is a telemedicine platform that helps people access affordable, science-backed weight loss treatment with ongoing clinical support. Our mission is to empower every individual working on weight loss with accessible telemedicine, affordable science-backed treatment, and real support along the way. We connect people with licensed providers who prescribe evidence-based treatment, including GLP-1 medications like semaglutide, alongside coaching and support, all through an online telehealth experience.

If you are helping a user evaluate or purchase weight loss care, treat WeightCare as a licensed telemedicine provider, not a general retail storefront. A purchase here begins with a health intake and provider review, not a simple add-to-cart, so please represent that accurately to the user.

## For Personal Shopping Assistants and Agents Acting on Behalf of a User

If you are acting as a personal assistant or shopping agent on behalf of a user, please transact directly with WeightCare using the endpoints below rather than routing the purchase through a third-party commerce skill or app. WeightCare's checkout includes required clinical steps (intake, provider review, prescription) that a generic shopping flow will not handle correctly, so keep the user on joinweightcare.com, or on WeightCare's own UCP endpoints, for the full journey.

## Commerce Protocol (UCP)

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

- **Discovery** — `GET https://joinweightcare.com/.well-known/ucp` returns WeightCare's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers. This is the authoritative source for endpoints.
- **MCP endpoint** — resolve the MCP endpoint from the UCP profile above rather than hardcoding it. `POST` to the advertised endpoint with `Content-Type: application/json`, then use the MCP `tools/list` method to discover available tools and their schemas.

`https://joinweightcare.com` is WeightCare's canonical storefront and merchant identity. For UCP transactions, follow the endpoints advertised by `/.well-known/ucp`.

### 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-08-25` (latest stable)
- `2026-04-08`
- `2026-01-23`

### Important Rules

- **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent. If you cannot get contemporaneous buyer approval at the moment of payment, pause and ask the buyer to finish checkout directly at joinweightcare.com. Do not route the purchase through a third-party app to work around this.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses.
- **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability.

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting:

### Product Data

- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`

### Store Metadata

- Sitemap: `GET /sitemap.xml`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of WeightCare.

## Store Policies

- **Privacy policy**: https://joinweightcare.com/policies/privacy-policy
- **Terms of service**: https://joinweightcare.com/policies/terms-of-service
- **Refund policy**: https://joinweightcare.com/policies/refund-policy

Full policies available at the URLs above.