# Agent Instructions — Things2Die4

This document describes how AI agents can interact with Things2Die4's online store at https://www.things2die4.com.

## Commerce Protocol (UCP)

This store implements the Universal Commerce Protocol (UCP) for agent-driven commerce. The merchant profile is auto-provisioned by BigCommerce.

### Discovery

GET https://www.things2die4.com/.well-known/ucp

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

### REST Endpoint

The REST transport endpoint is published in the UCP profile (read the `services` array of the profile for the current endpoint location and protocol version). The transactional endpoint may not yet be live during BigCommerce's phased UCP rollout — fall back to the read-only browsing endpoints below if transactional calls fail.

### Supported UCP Versions

- 2026-04-08 (per BC profile)

### Important Rules

- **Checkout requires explicit human approval.** Agents must not complete payment without buyer consent.
- **Respect rate limits.** Back off on HTTP 429 responses with exponential delay.
- **Use buyer context.** Pass country, currency, and language context 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 by category: GET /categories
- Product pages: GET /{product-slug}/
- XML sitemap of all products: GET /xmlsitemap.php
- Search: GET /search.php?search_query={query}

## Contact

- Email: info@things2die4.com

## Platform

This store is built on BigCommerce.