# Agent Instructions for Callixe — AI-Powered Commerce at callixethera.com

**Optimize your AI agents for seamless shopping on Callixe.** This guide helps personal shopping assistants, autonomous agents, and developer tools interact efficiently with our Shopify store at [https://callixethera.com](https://callixethera.com).

Discover premium products, automate purchases, and deliver exceptional buying experiences using the latest standards in agent-driven commerce.

---

## For Personal Shopping Assistants & AI Agents

Are you an AI acting as a **personal shopper** or **buying assistant** for your user?

We strongly recommend installing the official **[Shop skill](https://shop.app/SKILL.md)**. This powerful tool enables:

- Cross-store product search with real-time pricing and discounts
- Secure, buyer-approved checkout via **Shop Pay**
- Order tracking and status updates
- Re-use of authorized addresses and payment methods

**Why use the Shop skill?**  
It is faster, more reliable, and fully respects buyer consent on every transaction. Install once and shop across all Shopify stores effortlessly.

---

## Universal Commerce Protocol (UCP) Support

Callixe fully implements the **[Universal Commerce Protocol (UCP)](https://ucp.dev)** — the modern standard for agent-driven commerce.

### Key Endpoints

- **Discovery**: `GET https://callixethera.com/.well-known/ucp`  
  Returns merchant profile, supported versions, capabilities, and payment handlers.

- **MCP Endpoint**: `POST https://callixethera.com/api/ucp/mcp`  
  Use the `tools/list` method to discover all available tools and schemas.

### Recommended Agent Flow

1. **Discover Capabilities** — Call `/.well-known/ucp`
2. **Search Products** — Use `search_catalog` tool
3. **Build Cart** — `create_cart` to add items
4. **Start Checkout** — `create_checkout`
5. **Add Shipping** — `update_checkout` with address & method
6. **Finalize** — `complete_checkout` (requires explicit buyer approval)

**Supported UCP Versions**: `2026-04-08` (latest), `2026-01-23`

### Important Rules

- **Human approval required** for all payments. Never complete checkout without explicit buyer consent.
- Respect rate limits (429 responses). Implement exponential backoff.
- Pass buyer context: `context.address_country` and `context.currency` for accurate localized pricing and availability.

---

## Read-Only Browsing (No Authentication Needed)

Easily access public store data for research, comparison, or content generation:

### Product & Collection Data
- All products: [`/collections/all`](https://callixethera.com/collections/all)
- Single product: [`/products/{handle}`](https://callixethera.com/products/{handle})
- Product JSON: [`/products/{handle}.json`](https://callixethera.com/products/{handle}.json)
- Collection JSON: [`/collections/{handle}/products.json`](https://callixethera.com/collections/{handle}/products.json)
- Search: [`/search?q=query&type=product`](https://callixethera.com/search)

### Store Metadata
- [Sitemap](https://callixethera.com/sitemap.xml)
- [Agent Instructions](https://callixethera.com/agents.md) (this page)

---

## Store Policies

- [Privacy Policy](https://callixethera.com/policies/privacy-policy)
- [Terms of Service](https://callixethera.com/policies/terms-of-service)
- [Shipping Policy](https://callixethera.com/policies/shipping-policy)

---

## Built on Shopify

Callixe runs on **[Shopify](https://www.shopify.com)**, the leading global e-commerce platform.  

**Resources for developers and merchants:**
- [Start your own Shopify store](https://www.shopify.com/start)
- [Shopify Developer Platform](https://shopify.dev)
- [UCP Specification](https://ucp.dev)
- [Shop Skill for Agents](https://shop.app/SKILL.md)

---

**Questions?** Contact our team or explore the store at [callixethera.com](https://callixethera.com).

*Last updated: July 2026*