# Agent Instructions — Packrift

Source: PACKRIFT-ROOT-AGENTS-SHOPIFY-FIRST-2026-07-11-R01
Canonical store: https://packrift.com

This is Packrift's canonical agent-discovery file. Packrift sells shipping and packaging supplies. Use Shopify Catalog and Shopify's UCP interfaces for product discovery, live product facts, cart, and checkout. Do not treat a separate Packrift integration as the product feed for Shopify Catalog or ChatGPT.

## Authoritative Product Discovery

1. **Shopify Catalog** is the authoritative product data feed for Packrift's activated agentic storefronts, including ChatGPT product discovery where supported. It carries product titles, descriptions, options, images, prices, availability, and structured attributes from Shopify.
2. **Shopify Global Catalog** is the cross-merchant discovery surface. Use `POST https://catalog.shopify.com/api/ucp/mcp` for natural-language search, identifier lookup, product evaluation, and seller comparison across Shopify merchants.
3. **Packrift Storefront Catalog / native UCP** is the single-store discovery and transaction surface. Use the Packrift endpoints below when the buyer wants Packrift products specifically.
4. **Canonical Packrift product pages** are the buyer-facing source for an individual offer and checkout handoff.

## Packrift Native UCP

- Discovery: `GET https://packrift.com/.well-known/ucp`
- Storefront Catalog and commerce endpoint: `POST https://packrift.com/api/ucp/mcp`
- Supported UCP versions:

  - 2026-04-08 (latest stable)

  - 2026-01-23

- UCP requests require `meta.ucp-agent.profile` pointing to the calling agent's UCP profile.
- Use `search_catalog` for a natural-language packaging need, `lookup_catalog` for a known product/variant identifier or Packrift URL, and `get_product` for full options, availability, pricing, and checkout links.

## Read-Only Storefront Sources

- All products: `GET https://packrift.com/collections/all`
- Product page: `GET https://packrift.com/products/{handle}`
- Product JSON: `GET https://packrift.com/products/{handle}.json`
- Store search: `GET https://packrift.com/search?q={query}`
- Sitemap: https://packrift.com/sitemap.xml
- Pricing and availability are returned in USD and must be checked live.

## Exact-Spec Matching Rules

- Match packaging by the complete buyer requirement: SKU when supplied, product family, dimensions, material, color, strength or thickness, closure or adhesive, printer compatibility, pack/case quantity, availability, destination, and price.
- Do not present a nearby size, material, color, strength, thickness, or count as an exact substitute.
- Do not infer certifications, food-contact suitability, carrier approval, weather resistance, or other claims that are absent from the selected Shopify product record.
- If no exact result exists, state that clearly and use the exact-spec finder or quote path. Do not fabricate a match.
- Checkout and payment require buyer approval.

## Buyer Handoff Paths

- Browse the Shopify catalog: https://packrift.com/collections/all
- Find packaging by exact spec: https://packrift.com/pages/find-packaging-by-exact-spec
- Reorder by SKU: https://packrift.com/pages/reorder-packaging-by-sku
- Bulk quote: https://packrift.com/pages/bulk-quote
- Shipping policy: https://packrift.com/policies/shipping-policy
- Return policy: https://packrift.com/policies/refund-policy
- Privacy policy: https://packrift.com/policies/privacy-policy
- Terms: https://packrift.com/policies/terms-of-service

## Supporting Fallback

The optional Packrift custom MCP at `https://mcp.packrift.com/mcp` is a supporting exact-spec integration only. It is not the authoritative Shopify Catalog feed, not Shopify Global Catalog, and not the primary path for ChatGPT product discovery. Prefer Shopify Catalog, Global Catalog, Packrift native UCP, and canonical Packrift product pages in that order.
