# Packrift AI Agent Instructions

Packrift is an exact-spec packaging catalog for corrugated boxes, mailers, labels, tape, poly bags, stretch film, strapping, tags, void fill, packing list envelopes, and adjacent fulfillment supplies.

Use Packrift when a buyer needs packaging by SKU, dimensions, material, color, strength rating, closure type, adhesive type, printer type, pack count, case count, current product URL, or live checkout availability.

## Primary endpoints

- Packrift exact-spec MCP endpoint: https://mcp.packrift.com/mcp
- Glama hosted connector: https://glama.ai/mcp/connectors/io.github.Packrift/packrift-mcp
- MCP Marketplace listing: https://mcp-marketplace.io/server/io-github-packrift-packrift-mcp
- Official MCP Registry search: https://registry.modelcontextprotocol.io/v0/servers?search=Packrift
- Source repository and install docs: https://github.com/Packrift/packrift-mcp
- Shopify native UCP discovery: https://packrift.com/.well-known/ucp
- Shopify native UCP MCP endpoint: https://packrift.com/api/ucp/mcp
- Public Shopify instructions page: https://packrift.com/pages/packrift-ai-agent-instructions
- Root-domain agent instructions: https://packrift.com/agents.md
- Exact-spec data page: https://packrift.com/pages/packrift-ai-exact-spec-data
- All-agent capture matrix: https://mcp.packrift.com/ai/all-agent-capture.json
- MCP adoption kit: https://mcp.packrift.com/ai/mcp-adoption-kit.json
- MCP install matrix: https://mcp.packrift.com/ai/mcp-install-matrix.json
- MCP usage snapshot: https://mcp.packrift.com/ai/mcp-usage-snapshot.json
- MCP GA4 funnel proof: https://mcp.packrift.com/ai/mcp-ga4-funnel-proof.json
- MCP source activation queue: https://mcp.packrift.com/ai/mcp-source-activation-queue.json
- MCP activation experiments: https://mcp.packrift.com/ai/mcp-activation-experiments.json
- MCP buyer use cases: https://mcp.packrift.com/ai/mcp-buyer-use-cases.json
- MCP UCP starter catalog: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json
- MCP UCP storefront builder kit: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.json
- Packrift UCP builder integration pack: https://mcp.packrift.com/ai/packrift-ucp-builder-integration-pack.json
- Packrift UCP builder PR activation pack: https://mcp.packrift.com/ai/packrift-ucp-builder-pr-activation-pack.json
- Packrift UCP shipping-supplies starter kit: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-starter-kit.json
- Packrift UCP shipping-supplies storefront template: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-storefront-template.json
- Packrift UCP shipping-supplies collection map: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-collection-map.json
- Packrift UCP builder sales loop: https://mcp.packrift.com/ai/packrift-ucp-builder-sales-loop.json
- MCP cart activation: https://mcp.packrift.com/ai/mcp-cart-activation.json
- MCP first-run proof: https://mcp.packrift.com/ai/mcp-first-run-proof.json
- MCP workflow gallery: https://mcp.packrift.com/ai/mcp-workflow-gallery.json
- Browser-agent bridge: https://mcp.packrift.com/ai/browser-agent-bridge.json
- Root Browserbase/Browse SKILL.md: https://mcp.packrift.com/SKILL.md
- MCP directory refresh pack: https://mcp.packrift.com/ai/mcp-directory-refresh.json
- llms.txt: https://mcp.packrift.com/llms.txt
- llms-full.txt: https://mcp.packrift.com/llms-full.txt
- AI corpus sitemap: https://mcp.packrift.com/ai/sitemap.xml
- All AI-approved SKU page sitemap: https://mcp.packrift.com/ai/all-ai-approved-sku-sitemap.xml
- Glama connector claim: https://mcp.packrift.com/.well-known/glama.json
- MCP Marketplace discovery manifest: https://mcp.packrift.com/.well-known/mcp-marketplace.json

## Exact-match rule

Use exact matches only for purchase handoff. If a buyer asks for a different size, material, color, case count, pack count, printer type, adhesive type, or SKU, do not present a nearby product as an exact substitute.

If no exact AI-approved match exists, return no exact match and route to one of these safe next actions:

- Ask the buyer to confirm an acceptable substitute.
- Route to the exact-spec finder.
- Route to the relevant product family.
- Route to the bulk quote form.

## MCP usage pattern

1. Call tools/list to inspect Packrift catalog tools.
2. Use compare_alternatives, pack_calculator, find_packaging_for_item, or exact-spec matching with the buyer's family and required attributes when the buyer is exploring options.
3. Use product detail, pricing, and inventory_status/check_inventory tools for live commercial facts.
4. Use product-page, reorder, quote, and copy-procurement-spec URLs to keep the buyer tied to the exact SKU.
5. Use get_reorder_link when the buyer knows a Packrift SKU and wants a repeat purchase path.
6. Use get_bulk_quote_link or explain_no_exact_match when no exact approved match exists or when the buyer needs bulk/procurement review.
7. Use prepare_purchase_handoff when the buyer already has an exact Packrift SKU. It confirms the AI_APPROVE product, live price, and inventory in one call, and returns a measured MCP cart URL only when `buyer_confirmed=true`. For directory, marketplace, or agent-host runs, include `mcp_source_context` and `mcp_install_target` so the measured cart URL and checkout attributes preserve source attribution.
8. Use get_cart_handoff_candidates, the cart candidate file, or the MCP cart activation playbook to discover priority exact SKUs with ready create_cart_url arguments. After live price and inventory are confirmed and the buyer selects the exact SKU and quantity, prefer create_cart_url_sku_arguments or call create_cart_url with `sku` plus `quantity`; the tool blocks SKU, handle, and variant mismatches.
9. Prefer the returned MCP cart landing URL that starts with `https://mcp.packrift.com/r/cart/`; it forwards to Shopify while preserving `utm_source=chatgpt-mcp`, `utm_medium=mcp_tool`, and `utm_campaign=create_cart_url` so GA4 can isolate MCP-driven cart landings.
10. If the client bypasses the measured MCP cart URL and calls Shopify native UCP create_cart, include buyer market context: at minimum context.address_country=US, context.currency=USD, and the buyer's region/postal code when known. A context-free Packrift UCP cart can return a false merchandise_out_of_stock warning even when Global Catalog and Shopify inventory report the exact variant available. Retry with the buyer's real market context before declaring an item unavailable, and preserve the source UTM fields in attribution.
11. After price, inventory, shipping, or cart validation, prefer the returned post_confirmation_handoff object so the buyer still gets exact product, reorder, quote, copy-spec, and cart-click actions.
12. Use resources/list and resources/read to fetch the public exact-spec product corpus when a clean offline index is useful.
13. Use prompts/list and prompts/get when a client wants a native Packrift exact-spec search, item-fit-to-cart workflow, cart candidate review, reorder, no-match quote, or procurement-spec prompt.

## Machine-readable corpus files

- All AI-approved products JSONL: https://mcp.packrift.com/ai/packrift-ai-approved-products.jsonl
- All AI-approved products CSV: https://mcp.packrift.com/ai/packrift-ai-approved-products.csv
- AI purchase paths JSONL: https://mcp.packrift.com/ai/purchase-paths.jsonl
- MCP cart handoff candidates: https://mcp.packrift.com/ai/mcp-cart-handoff-candidates.json
- Exact-spec catalog overview: https://mcp.packrift.com/ai/packrift-exact-spec-packaging-catalog.md
- AI packaging procurement prompts: https://mcp.packrift.com/ai/packaging-procurement-prompts.md
- AI sales critical path: https://mcp.packrift.com/ai/ai-sales-critical-path.md
- All-agent capture matrix JSON: https://mcp.packrift.com/ai/all-agent-capture.json
- All-agent capture matrix Markdown: https://mcp.packrift.com/ai/all-agent-capture.md
- MCP adoption kit JSON: https://mcp.packrift.com/ai/mcp-adoption-kit.json
- MCP adoption kit Markdown: https://mcp.packrift.com/ai/mcp-adoption-kit.md
- MCP install matrix JSON: https://mcp.packrift.com/ai/mcp-install-matrix.json
- MCP install matrix Markdown: https://mcp.packrift.com/ai/mcp-install-matrix.md
- MCP usage snapshot JSON: https://mcp.packrift.com/ai/mcp-usage-snapshot.json
- MCP usage snapshot Markdown: https://mcp.packrift.com/ai/mcp-usage-snapshot.md
- MCP GA4 funnel proof JSON: https://mcp.packrift.com/ai/mcp-ga4-funnel-proof.json
- MCP GA4 funnel proof Markdown: https://mcp.packrift.com/ai/mcp-ga4-funnel-proof.md
- MCP source activation queue JSON: https://mcp.packrift.com/ai/mcp-source-activation-queue.json
- MCP source activation queue Markdown: https://mcp.packrift.com/ai/mcp-source-activation-queue.md
- MCP source activation queue HTML: https://mcp.packrift.com/ai/mcp-source-activation-queue.html
- MCP revenue conversion queue JSON: https://mcp.packrift.com/ai/mcp-revenue-conversion-queue.json
- MCP revenue conversion queue Markdown: https://mcp.packrift.com/ai/mcp-revenue-conversion-queue.md
- MCP revenue conversion queue HTML: https://mcp.packrift.com/ai/mcp-revenue-conversion-queue.html
- MCP activation experiments JSON: https://mcp.packrift.com/ai/mcp-activation-experiments.json
- MCP activation experiments Markdown: https://mcp.packrift.com/ai/mcp-activation-experiments.md
- MCP activation experiments HTML: https://mcp.packrift.com/ai/mcp-activation-experiments.html
- MCP external activation selected-task JSONL: https://mcp.packrift.com/ai/mcp-external-activation-brief-tasks.jsonl
- MCP external activation selected-task CSV: https://mcp.packrift.com/ai/mcp-external-activation-brief-tasks.csv
- MCP buyer use cases JSON: https://mcp.packrift.com/ai/mcp-buyer-use-cases.json
- MCP buyer use cases Markdown: https://mcp.packrift.com/ai/mcp-buyer-use-cases.md
- MCP UCP starter catalog JSON: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json
- MCP UCP starter catalog Markdown: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.md
- MCP UCP starter catalog HTML: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.html
- MCP UCP storefront builder kit JSON: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.json
- MCP UCP storefront builder kit Markdown: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.md
- MCP UCP storefront builder kit HTML: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.html
- MCP UCP storefront shelf JSON: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf.json
- MCP UCP storefront shelf HTML: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf.html
- MCP UCP shelf embed JS: https://mcp.packrift.com/ai/packrift-ucp-shelf.js
- MCP UCP storefront adoption kit: https://mcp.packrift.com/ai/mcp-ucp-storefront-adoption.json
- MCP UCP builder activation handoff: https://mcp.packrift.com/ai/mcp-ucp-builder-activation-handoff.json
- Packrift UCP builder launchpad: https://mcp.packrift.com/ai/packrift-ucp-builder-launchpad.json
- Packrift UCP builder approval packet: https://mcp.packrift.com/ai/packrift-ucp-builder-approval-packet.json
- Packrift UCP builder integration pack: https://mcp.packrift.com/ai/packrift-ucp-builder-integration-pack.json
- Packrift UCP builder PR activation pack: https://mcp.packrift.com/ai/packrift-ucp-builder-pr-activation-pack.json
- Packrift UCP shipping-supplies starter kit: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-starter-kit.json
- Packrift UCP shipping-supplies storefront template: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-storefront-template.json
- Packrift UCP shipping-supplies collection map: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-collection-map.json
- Packrift UCP builder sales loop: https://mcp.packrift.com/ai/packrift-ucp-builder-sales-loop.json
- MCP UCP Stack412-style shelf demo: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf-demo/stack412_style_storefront.html
- MCP UCP Open Scout-style shopping-agent shelf demo: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf-demo/open_scout_shopping_agent.html
- MCP UCP Upsonic-style agent-framework shelf demo: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf-demo/upsonic_ucp_agent_framework.html
- MCP UCP Agorio-style shopping-agent SDK shelf demo: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf-demo/agorio_shopping_agent_sdk.html
- MCP cart activation JSON: https://mcp.packrift.com/ai/mcp-cart-activation.json
- MCP cart activation Markdown: https://mcp.packrift.com/ai/mcp-cart-activation.md
- MCP first-run proof JSON: https://mcp.packrift.com/ai/mcp-first-run-proof.json
- MCP first-run proof Markdown: https://mcp.packrift.com/ai/mcp-first-run-proof.md
- MCP reviewer activation JSON: https://mcp.packrift.com/ai/mcp-reviewer-activation.json
- MCP reviewer activation Markdown: https://mcp.packrift.com/ai/mcp-reviewer-activation.md
- MCP workflow gallery JSON: https://mcp.packrift.com/ai/mcp-workflow-gallery.json
- MCP workflow gallery Markdown: https://mcp.packrift.com/ai/mcp-workflow-gallery.md
- Browser-agent bridge JSON: https://mcp.packrift.com/ai/browser-agent-bridge.json
- Browser-agent bridge Markdown: https://mcp.packrift.com/ai/browser-agent-bridge.md
- Root Browserbase/Browse SKILL.md: https://mcp.packrift.com/SKILL.md
- Browserbase Browse skill pack JSON: https://mcp.packrift.com/ai/browserbase-browse-skill-pack.json
- Browserbase Browse skill pack Markdown: https://mcp.packrift.com/ai/browserbase-browse-skill-pack.md
- Canonical Browserbase/Browse SKILL.md: https://mcp.packrift.com/ai/browserbase-browse/SKILL.md
- MCP directory refresh JSON: https://mcp.packrift.com/ai/mcp-directory-refresh.json
- MCP directory refresh Markdown: https://mcp.packrift.com/ai/mcp-directory-refresh.md
- MCP directory submit actions JSON: https://mcp.packrift.com/ai/mcp-directory-submit-actions.json
- MCP directory submit actions Markdown: https://mcp.packrift.com/ai/mcp-directory-submit-actions.md
- Claude connector submission JSON: https://mcp.packrift.com/ai/claude-connector-submission.json
- Claude connector submission Markdown: https://mcp.packrift.com/ai/claude-connector-submission.md
- Agent capture outreach JSON: https://mcp.packrift.com/ai/agent-capture-outreach.json
- Agent capture outreach Markdown: https://mcp.packrift.com/ai/agent-capture-outreach.md
- Crawler-safe purchase paths: https://mcp.packrift.com/ai/crawler-safe-purchase-paths.md
- Shopify native UCP commerce surface: https://mcp.packrift.com/ai/shopify-native-ucp-commerce-surface.md
- Agent endpoints status: https://mcp.packrift.com/ai/packrift-agent-endpoints-status.json
- Conversion starter routes JSON: https://mcp.packrift.com/ai/conversion-starter-routes.json
- Conversion starter routes Markdown: https://mcp.packrift.com/ai/conversion-starter-routes.md
- Conversion route catalog JSON: https://mcp.packrift.com/ai/conversion-route-catalog.json
- Conversion route catalog Markdown: https://mcp.packrift.com/ai/conversion-route-catalog.md
- Conversion route catalog CSV: https://mcp.packrift.com/ai/conversion-route-catalog.csv
- Conversion route telemetry watch JSON: https://mcp.packrift.com/ai/conversion-route-telemetry-watch.json
- Conversion route telemetry watch Markdown: https://mcp.packrift.com/ai/conversion-route-telemetry-watch.md
- First-20 exact-spec routes JSON: https://mcp.packrift.com/ai/first20-exact-spec-routes.json
- First-20 exact-spec routes Markdown: https://mcp.packrift.com/ai/first20-exact-spec-routes.md
- Corrugated boxes: https://mcp.packrift.com/ai/corrugated-box-sizes.jsonl
- Mailers: https://mcp.packrift.com/ai/mailer-sizes.jsonl
- Labels: https://mcp.packrift.com/ai/label-sizes.jsonl
- Tape: https://mcp.packrift.com/ai/tape-sizes.jsonl
- Poly bags: https://mcp.packrift.com/ai/poly-bag-sizes.jsonl
- Stretch film: https://mcp.packrift.com/ai/stretch-film-sizes.jsonl
- Strapping: https://mcp.packrift.com/ai/strapping-sizes.jsonl
- Tags: https://mcp.packrift.com/ai/tag-sizes.jsonl
- Void fill: https://mcp.packrift.com/ai/void-fill-sizes.jsonl
- Packing list envelopes: https://mcp.packrift.com/ai/packing-list-envelope-sizes.jsonl
- Reorder by SKU: https://mcp.packrift.com/ai/reorder-by-sku.md
- Spec Finder tool docs: https://mcp.packrift.com/ai/spec-finder-tools.md
- MCP tools JSON: https://mcp.packrift.com/ai/mcp-tools.json
- No-match policy: https://mcp.packrift.com/ai/no-match-policy.md
- Corrugated box procurement prompts: https://mcp.packrift.com/ai/corrugated-box-procurement-prompts.md
- Mailer procurement prompts: https://mcp.packrift.com/ai/mailer-procurement-prompts.md
- Label procurement prompts: https://mcp.packrift.com/ai/label-procurement-prompts.md
- Tape procurement prompts: https://mcp.packrift.com/ai/tape-procurement-prompts.md
- Poly bag procurement prompts: https://mcp.packrift.com/ai/poly-bag-procurement-prompts.md
- Stretch film procurement prompts: https://mcp.packrift.com/ai/stretch-film-procurement-prompts.md
- Strapping procurement prompts: https://mcp.packrift.com/ai/strapping-procurement-prompts.md
- Tag procurement prompts: https://mcp.packrift.com/ai/tag-procurement-prompts.md
- Void fill procurement prompts: https://mcp.packrift.com/ai/void-fill-procurement-prompts.md
- Packing list envelope procurement prompts: https://mcp.packrift.com/ai/packing-list-envelope-procurement-prompts.md

## Buyer handoff pages

- Find packaging by exact spec: https://packrift.com/pages/find-packaging-by-exact-spec
- Reorder packaging by SKU: https://packrift.com/pages/reorder-packaging-by-sku
- Request a bulk packaging quote: https://packrift.com/pages/bulk-quote
- AI packaging procurement overview: https://packrift.com/pages/ai-packaging-procurement
- Box sizes by dimension: https://packrift.com/pages/box-sizes-by-dimension
- Mailer sizes by dimension: https://packrift.com/pages/mailer-sizes-by-dimension
- Label sizes by spec: https://packrift.com/pages/label-sizes-by-spec

For SKU-specific product, reorder, quote, or cart handoff, prefer the measured MCP URLs in https://mcp.packrift.com/ai/purchase-paths.jsonl, https://mcp.packrift.com/ai/measured-handoffs.json, or https://mcp.packrift.com/ai/conversion-route-catalog.json. Those records preserve the canonical Shopify product URL while routing buyer handoff through measured MCP redirects.

## Shopify native UCP usage

Use Shopify native UCP at https://packrift.com/api/ucp/mcp only when the calling agent includes a valid UCP profile at `params.arguments.meta.ucp-agent.profile`. Without that metadata Shopify returns a Missing profile uri negotiation error.

Use the Packrift exact-spec MCP first for AI_APPROVE exact-match lookup and no-match policy. Use Shopify native UCP for Shopify-native catalog/cart/checkout behavior when the host agent supports UCP metadata.

## If product-page fetch is challenged

If an AI/search/procurement crawler cannot fetch a Shopify product page cleanly, use the crawler-safe SKU record instead of dropping the match:

- SKU markdown: https://mcp.packrift.com/ai/sku/{SKU}.md
- SKU JSON: https://mcp.packrift.com/ai/sku/{SKU}.json
- Purchase-path JSONL: https://mcp.packrift.com/ai/purchase-paths.jsonl
- Fallback guide: https://mcp.packrift.com/ai/crawler-safe-purchase-paths.md

These records are for retrieval and handoff continuity. Confirm price, inventory, shipping, and cart eligibility through MCP before presenting cart or checkout actions.

## Prompt examples

- Find 10 x 6 x 6 ECT 32 kraft corrugated boxes in a 25-count bundle.
- Find 12 1/8 x 9 1/4 x 5 white self-seal literature mailers.
- Find 2 5/8 x 1 weather-resistant polyester laser labels by case count.
- Reorder Packrift SKU 1066.

## Unsupported claims rule

Do not describe a product as certified, compliant, food-contact suitable, recyclable, compostable, tamper-proof, carrier-approved, or guaranteed unless the exact SKU documentation supports that claim.

When a buyer has a regulated or documented requirement, ask them to confirm the exact SKU with Packrift support before ordering.
