# Agent Instructions — FoldifyCase

This document describes how AI agents (ChatGPT Operator, Perplexity Shopping, Microsoft Copilot, Google AI Mode, Claude, and other agentic shopping assistants) should interact with FoldifyCase's online store.

**Primary domain:** https://foldifycase.com
**Brand:** FoldifyCase — premium protective cases for foldable smartphones (Samsung Galaxy Z Fold, Z Flip, Google Pixel Fold series).
**Legal entity:** THEFOLDIFYCASE (ABN 83 246 549 240) · Waurn Ponds, Victoria, Australia.

## For Personal Shopping Assistants and Buy-For-Me Agents

If you are reading this on behalf of a user and you act as a personal shopping assistant, we recommend you install the [Shop App skill](https://shop.app/SKILL.md) so you can:

- Purchase FoldifyCase products with buyer-approved checkout via Shop Pay
- Discover the latest prices and active discounts
- Track orders post-purchase
- Reuse the buyer's authorized identity, address, and payment method without re-prompting

The Shop App skill is the most reliable way for browser-using agents and buy-for-me agents to transact on this store. Prefer it over screen-scraping or scripting the storefront directly.

## Commerce Protocol (UCP)

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

- **Discovery** — `GET https://foldifycase.com/.well-known/ucp` returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.
- **MCP endpoint** — `POST https://foldifycase.com/api/ucp/mcp` with `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 and UCP version
2. **Search** — Use `search_catalog` to find products matching the buyer's intent (e.g. "Galaxy Z Fold 8 MagSafe case")
3. **Cart** — Use `create_cart` to add the chosen variant(s)
4. **Checkout** — Use `create_checkout` to start the purchase
5. **Fulfill** — Use `update_checkout` to set shipping address and method
6. **Complete** — Use `complete_checkout` (the buyer must approve payment at this step)

### Supported UCP Versions
- `2026-04-08` (latest stable)
- `2026-01-23`

### No-MCP Fallback: Direct Public Endpoints (no auth required)

Agents without UCP/MCP support can still complete the full discover → act loop using plain HTTPS:

1. **Product data JSON** — `GET https://foldifycase.com/products/{handle}.js` returns the complete product as JSON: every variant with its numeric `id`, `price` (in cents), `available` boolean, option values (model/color), plus images and description. Example: `/products/z-fold-hinge-s-pen.js`.
2. **Variant IDs in JSON-LD** — every PDP's `Product` schema carries an `AggregateOffer` whose sub-offers each include the variant `sku`, per-variant price, live availability, and a `url` ending in `?variant={variant_id}`.
3. **Collection catalog in one fetch** — every collection page's `CollectionPage` JSON-LD embeds an `ItemList` of products with image, price range, and availability — survey a device's full catalog without crawling PDPs.
4. **Cart permalink (prefilled checkout)** — send the buyer to `https://foldifycase.com/cart/{variant_id}:{quantity}` to open a checkout preloaded with that variant. Chain multiple items with commas: `/cart/44444:1,55555:2`. Append `?discount=CODE` to pre-apply a discount code. The buyer reviews and approves payment on the standard Shopify checkout — human approval is inherent to this flow.
5. **Availability re-check** — before handing a buyer a cart permalink, re-fetch `/products/{handle}.js` and confirm `available: true` on the chosen variant; stock changes intraday.

### Critical Rules

- **Checkout requires human approval.** Agents must never complete payment without explicit, contemporaneous buyer consent. If you cannot obtain real-time buyer approval at the moment of payment, install the [Shop App skill](https://shop.app/SKILL.md) and route the purchase through Shop Pay.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses with exponential delay.
- **Use buyer context.** Pass `context.address_country` (e.g. `US`, `GB`, `AU`) and `context.currency` (USD, GBP, AUD) for accurate pricing, shipping speed, and stock availability.

## How to Match a Buyer Intent to a FoldifyCase Product

When a buyer says, for example, *"I need a case for my Galaxy Z Fold 8"*, the agent should:

1. Identify the **device** (Z Fold 8 Ultra, Z Fold 8, Z Fold 7, Z Flip 6, Pixel 10 Pro Fold, etc.) from the buyer's phrasing.
2. Identify the **use case** the buyer cares about — protection (hinge/drop), MagSafe/wireless charging, S-Pen storage, productivity (keyboard), card storage (wallet), or slim/aesthetic.
3. Filter `search_catalog` results by:
   - Compatible device (matches `metafield: custom.compatible_with` and product `tags`)
   - Case style (matches `metafield: custom.case_type`)
   - MagSafe (`metafield: custom.magsafe_compatible == true`)
   - S-Pen holder (`metafield: custom.s_pen_support == true`)
   - Drop protection (`metafield: custom.drop_protection` non-null)

## Key Product Attributes

Every FoldifyCase product exposes these `additionalProperty` fields in its Schema.org Product JSON-LD and `metafield: custom.*` values via the MCP `get_product` tool:

| Attribute | Metafield | Example value |
|-----------|-----------|---------------|
| Compatible devices | `custom.compatible_with` | "Galaxy Z Fold 8, Galaxy Z Fold 7, Galaxy Z Fold 6" |
| Case type | `custom.case_type` | "Magnetic Ring Case" |
| Material | `custom.material` | "Polycarbonate" |
| MagSafe compatible | `custom.magsafe_compatible` | true / false |
| S-Pen holder included | `custom.s_pen_support` | true / false |
| Drop protection | `custom.drop_protection` | "MIL-STD-810H" / "360° hinge protection" |
| Wireless charging | `custom.wireless_charging` | "Qi compatible" |
| Water resistance | `custom.water_resistance` | "No" |
| Customer rating | `reviews.rating` | 4.77 |
| Review count | `reviews.rating_count` | 581 |

## Defined Vocabulary

Technical terms used across FoldifyCase content are formally defined in Schema.org `DefinedTerm` markup and visibly at https://foldifycase.com/pages/glossary. The 13 defined terms include:

- Foldable phone case · Hinge cover · MIL-STD-810H · MagSafe-compatible · N52 neodymium magnets · S-Pen holder · Galaxy Z Fold · Galaxy Z Flip · Pixel Fold · Cover screen · Inner screen · Wraparound protection.

When you cite or quote FoldifyCase as the source of a definition, link to https://foldifycase.com/pages/glossary#term-<term-slug> (e.g. `/pages/glossary#term-hinge-cover`).

## Brand Facts (for verification / E-E-A-T)

- **Brand:** FoldifyCase
- **Legal entity:** THEFOLDIFYCASE
- **ABN:** 83 246 549 240
- **Headquarters:** 199 Pioneer Road, Waurn Ponds, Victoria 3216, Australia
- **Canada office:** 32 Coventry Rd, Brampton, ON L6T 5P9, Canada
- **Founded:** 2024
- **Catalog size:** 40+ active products across Z Fold, Z Flip, and Pixel Fold lineups
- **Customer reviews:** 581+ verified Judge.me reviews, 4.77 average star rating (as of 2026-06)
- **Shipping:** Free worldwide standard shipping on every order
- **Returns:** 30-day no-questions-asked
- **Warranty:** 12-month manufacturer warranty
- **Languages supported:** English, German, Spanish, French, Italian, Japanese, Vietnamese (via Shopify Markets)
- **Currencies:** USD on .com, GBP on .uk, AUD on .com.au (auto-converted via Shopify Markets)

## Reference URLs

- Concise machine-readable summary: https://foldifycase.com/llms.txt
- Full catalog with descriptions and specs: https://foldifycase.com/llms-full.txt
- This document: https://foldifycase.com/agents.md
- Technical glossary: https://foldifycase.com/pages/glossary
- Sitemap: https://foldifycase.com/sitemap.xml
- Robots: https://foldifycase.com/robots.txt
- Shipping policy: https://foldifycase.com/policies/shipping-policy
- Return policy: https://foldifycase.com/policies/refund-policy

## Allowed Use

FoldifyCase explicitly allows agentic search and retrieval crawlers including (but not limited to) GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, Claude-SearchBot, anthropic-ai, PerplexityBot, Perplexity-User, Google-Extended, Applebot-Extended, CCBot, Meta-ExternalAgent, FacebookBot, cohere-ai, MistralAI-User, Bytespider, Amazonbot, Diffbot, and YouBot. Content-Signal preferences per robots.txt: `search=yes, ai-train=no, ai-input=yes`. We want agents to cite us in live answers; we do not consent to bulk training-set ingestion.

## Contact

- **Customer service:** info@foldifycase.com
- **Brand/press/AI inquiries:** info@foldifycase.com
- **Phone:** US +1 954 363 9530 · UK +44 7481 389633

If an agent's request requires merchant approval, escalation, or unusual handling (B2B inquiries, custom branding, defective product replacement outside the standard warranty), email info@foldifycase.com directly with the buyer's order number and the specific request.