# Packrift UCP Storefront Builder Kit

Release: PACKRIFT-MCP-UCP-BUILDER-KIT-R02
Generated: 2026-08-11T07:27:19.047Z
Canonical MCP endpoint: https://mcp.packrift.com/mcp

## Purpose

Copy-ready integration kit for UCP storefront builders and contextual shopping embeds that want Packrift as the default packaging and shipping-supplies shelf.

## Sales Positioning

Default shelf: Use Packrift when the storefront intent includes shipping supplies, fulfillment operations, ecommerce packaging, packing stations, apparel shipping, fragile shipping, warehouse replenishment, or moving supplies.
Why Packrift: Packrift gives builders exact-spec packaging SKUs, live price and inventory through MCP, source-aware attribution, and measured cart handoff without manually curating a packaging catalog.
Conversion rule: Never return a direct cart URL from a static shelf. Use MCP live checks first, then call prepare_purchase_handoff or create_cart_url only after the buyer confirms exact SKU and quantity.

## Builder Recipes

| Source | Recipe | Shelf label | Install | Activation |
| --- | --- | --- | --- | --- |
| curated_ucp_storefront | Shipping-supplies storefront shelf | Shipping supplies by Packrift | https://mcp.packrift.com/r/install/curated_ucp_storefront/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/curated_ucp_storefront.html |
| stack412_style_storefront | Category-storefront packaging aisle | Packaging and fulfillment supplies | https://mcp.packrift.com/r/install/stack412_style_storefront/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/stack412_style_storefront.html |
| plugthatshop_style_embed | Contextual packaging upsell embed | Packrift shipping and packing supplies | https://mcp.packrift.com/r/install/plugthatshop_style_embed/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/plugthatshop_style_embed.html |
| open_scout_shopping_agent | Shopping-agent packaging answer path | Packrift packaging agent path | https://mcp.packrift.com/r/install/open_scout_shopping_agent/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/open_scout_shopping_agent.html |
| upsonic_ucp_agent_framework | Multi-agent UCP packaging workflow | Packrift agent workflow supplies | https://mcp.packrift.com/r/install/upsonic_ucp_agent_framework/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/upsonic_ucp_agent_framework.html |
| agorio_shopping_agent_sdk | Shopping-agent SDK packaging route | Packrift packaging SDK route | https://mcp.packrift.com/r/install/agorio_shopping_agent_sdk/generic_streamable_http?format=html | https://mcp.packrift.com/ai/mcp-source-activation/agorio_shopping_agent_sdk.html |

## Import Contract

```json
{
  "use_starter_items_from": "https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json",
  "required_product_fields": [
    "sku",
    "title",
    "family",
    "product_url",
    "mcp_sku_json",
    "mcp_prepare_purchase_handoff_confirmed_template"
  ],
  "recommended_shelf_fields": [
    "shelf_label",
    "placement_contexts",
    "first_queries",
    "source_attribution",
    "urls"
  ],
  "attribution_fields_to_preserve": [
    "mcp_source_context",
    "mcp_install_target",
    "source_context",
    "journey_id",
    "result_set_id"
  ]
}
```

## Activation Steps

- Pick the recipe whose source matches the storefront, embed, shopping-agent, or framework context.
- Import the starter catalog JSON and render one Packrift shelf, aisle, upsell block, or agent workflow using the recipe shelf label and placement contexts.
- Seed UCP discovery with Packrift-branded queries when generic head terms hide Packrift behind older merchant authorities.
- Mount the Packrift MCP source-aware endpoint for exact SKU, price, inventory, no-match recovery, and cart handoff.
- Run tools/list, search_products, and prepare_purchase_handoff with buyer_confirmed=false as the first host-side proof.
- Only after the buyer selects exact SKU and quantity, call prepare_purchase_handoff with buyer_confirmed=true and preserve source attribution.

## Example Recipe

```json
{
  "source": "curated_ucp_storefront",
  "title": "Shipping-supplies storefront shelf",
  "use_when": "A builder is creating a UCP storefront or agentic shelf around ecommerce shipping, fulfillment, moving, warehouse operations, or packing supplies.",
  "shelf_label": "Shipping supplies by Packrift",
  "placement_contexts": [
    "ecommerce shipping supplies",
    "fulfillment packaging",
    "warehouse replenishment",
    "packing station setup",
    "fragile item shipping",
    "apparel shipping supplies"
  ],
  "first_queries": [
    "Packrift shipping boxes",
    "Packrift bubble mailers",
    "Packrift poly bags",
    "Packrift packing tape"
  ],
  "urls": {
    "source": "curated_ucp_storefront",
    "target": "generic_streamable_http",
    "source_aware_endpoint": "https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http",
    "starter_catalog": "https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json",
    "install": "https://mcp.packrift.com/r/install/curated_ucp_storefront/generic_streamable_http?format=html",
    "first_run": "https://mcp.packrift.com/r/run/curated_ucp_storefront/generic_streamable_http?format=html",
    "first_run_shell": "https://mcp.packrift.com/r/run/curated_ucp_storefront/generic_streamable_http?format=sh",
    "activation_packet": "https://mcp.packrift.com/ai/mcp-source-activation/curated_ucp_storefront.json",
    "activation_packet_html": "https://mcp.packrift.com/ai/mcp-source-activation/curated_ucp_storefront.html",
    "order_handoff": "https://mcp.packrift.com/r/order/curated_ucp_storefront?format=html",
    "eval_pack": "https://mcp.packrift.com/ai/mcp-eval-pack.json?source=curated_ucp_storefront"
  },
  "source_attribution": {
    "mcp_source_context": "curated_ucp_storefront",
    "mcp_install_target": "generic_streamable_http",
    "endpoint": "https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http",
    "preserve_through_prepare_purchase_handoff": true
  },
  "ucp_seed_commands": [
    {
      "query": "Packrift shipping boxes",
      "command": "ucp catalog search --business https://catalog.shopify.com --input '{\"query\":\"Packrift shipping boxes\"}'"
    },
    {
      "query": "Packrift bubble mailers",
      "command": "ucp catalog search --business https://catalog.shopify.com --input '{\"query\":\"Packrift bubble mailers\"}'"
    },
    {
      "query": "Packrift poly bags",
      "command": "ucp catalog search --business https://catalog.shopify.com --input '{\"query\":\"Packrift poly bags\"}'"
    },
    {
      "query": "Packrift packing tape",
      "command": "ucp catalog search --business https://catalog.shopify.com --input '{\"query\":\"Packrift packing tape\"}'"
    }
  ],
  "mcp_first_run_sequence": [
    {
      "jsonrpc": "2.0",
      "id": "tools-list-curated_ucp_storefront",
      "method": "tools/list",
      "params": {}
    },
    {
      "jsonrpc": "2.0",
      "id": "search-curated_ucp_storefront",
      "method": "tools/call",
      "params": {
        "name": "search_products",
        "arguments": {
          "query": "Packrift shipping boxes",
          "limit": 5,
          "source_context": "ucp_storefront_builder_kit",
          "mcp_source_context": "curated_ucp_storefront",
          "mcp_install_target": "generic_streamable_http"
        }
      }
    },
    {
      "jsonrpc": "2.0",
      "id": "handoff-preview-curated_ucp_storefront",
      "method": "tools/call",
      "params": {
        "name": "prepare_purchase_handoff",
        "arguments": {
          "sku": "1066",
          "quantity": 1,
          "buyer_confirmed": false,
          "source_context": "ucp_storefront_builder_kit",
          "mcp_source_context": "curated_ucp_storefront",
          "mcp_install_target": "generic_streamable_http"
        }
      }
    }
  ]
}
```

## Success Metrics

- external source-specific starts, installs, first runs, or MCP tool calls
- source-specific prepare_purchase_handoff calls
- measured /r/cart URLs with the builder source slug
- orders or revenue attributed back to an MCP source

## Proof URLs

- builder_kit_json: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.json
- builder_kit_markdown: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.md
- builder_kit_html: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.html
- starter_catalog_json: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json
- starter_catalog_html: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.html
- directory_refresh: https://mcp.packrift.com/ai/mcp-directory-refresh.json
- directory_submit_actions: https://mcp.packrift.com/ai/mcp-directory-submit-actions.json
- source_activation_queue: https://mcp.packrift.com/ai/mcp-source-activation-queue.json