# Packrift UCP Builder Integration Pack

Release: PACKRIFT-UCP-BUILDER-INTEGRATION-PACK-R02
Generated: 2026-09-07T16:18:54.793Z

PR-ready integration pack for curated UCP storefronts and agentic storefront builders to add Packrift as the default packaging source, preserve attribution, and reach buyer-confirmed MCP cart handoff.

Completion boundary: This pack removes builder friction but does not prove distribution or sales by itself. Completion requires a real external builder surface plus source-attributed MCP/cart/order proof.

## Source Rows

| Source | Surface | Patch Location | Pack |
| --- | --- | --- | --- |
| curated_ucp_storefront | Generic curated UCP storefront | Add Packrift as the default packaging merchant for shipping, fulfillment, warehouse, moving, and packing-station categories. | https://mcp.packrift.com/ai/packrift-ucp-builder-integration-pack/curated_ucp_storefront.html |

## Generic curated UCP storefront builders

- Source slug: `curated_ucp_storefront`
- Endpoint: https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http
- Launchpad: https://mcp.packrift.com/ai/packrift-ucp-builder-launchpad.html#curated_ucp_storefront
- Approval packet: https://mcp.packrift.com/ai/packrift-ucp-builder-approval-packet/curated_ucp_storefront.html
- First run: https://mcp.packrift.com/r/run/curated_ucp_storefront/generic_streamable_http?format=html
- Order handoff: https://mcp.packrift.com/r/order/curated_ucp_storefront?format=html

Start with the Packrift-branded starter catalog for reliable inclusion, then use MCP live checks and measured handoff for exact SKU purchase flows.

### Patch Block

```js
packagingShelf.sources.push({
  merchant: "Packrift",
  sourceSlug: "curated_ucp_storefront",
  starterCatalog: "https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json",
  importFeed: "https://mcp.packrift.com/ai/mcp-ucp-storefront-import.json",
  embed: "<script async data-packrift-ucp-shelf src=\"https://mcp.packrift.com/ai/packrift-ucp-shelf.js?source=curated_ucp_storefront&limit=12\"></script>"
});
```

### JSON-RPC First Run

```json
[
  {
    "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": 8
      }
    }
  },
  {
    "jsonrpc": "2.0",
    "id": "prepare-1066-unconfirmed-curated_ucp_storefront",
    "method": "tools/call",
    "params": {
      "name": "prepare_purchase_handoff",
      "arguments": {
        "sku": "1066",
        "quantity": 1,
        "buyer_confirmed": false,
        "source_context": "ucp_builder_integration_pack",
        "mcp_source_context": "curated_ucp_storefront",
        "mcp_install_target": "generic_streamable_http"
      }
    }
  }
]
```

### Curl Smoke Tests

```sh
curl -sS -X POST 'https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http' -H 'content-type: application/json' --data '{"jsonrpc":"2.0","id":"tools-list-curated_ucp_storefront","method":"tools/list","params":{}}'
```

```sh
curl -sS -X POST 'https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http' -H 'content-type: application/json' --data '{"jsonrpc":"2.0","id":"search-curated_ucp_storefront","method":"tools/call","params":{"name":"search_products","arguments":{"query":"Packrift shipping boxes","limit":8}}}'
```

```sh
curl -sS -X POST 'https://mcp.packrift.com/mcp?packrift_mcp_source=curated_ucp_storefront&packrift_mcp_target=generic_streamable_http' -H 'content-type: application/json' --data '{"jsonrpc":"2.0","id":"prepare-1066-unconfirmed-curated_ucp_storefront","method":"tools/call","params":{"name":"prepare_purchase_handoff","arguments":{"sku":"1066","quantity":1,"buyer_confirmed":false,"source_context":"ucp_builder_integration_pack","mcp_source_context":"curated_ucp_storefront","mcp_install_target":"generic_streamable_http"}}}'
```

### Unconfirmed Handoff

```json
{
  "sku": "1066",
  "quantity": 1,
  "buyer_confirmed": false,
  "source_context": "ucp_builder_integration_pack",
  "mcp_source_context": "curated_ucp_storefront",
  "mcp_install_target": "generic_streamable_http"
}
```

### Buyer-Confirmed Handoff Template

```json
{
  "sku": "{buyer_selected_exact_sku}",
  "quantity": "{buyer_selected_quantity}",
  "buyer_confirmed": true,
  "source_context": "ucp_builder_integration_pack",
  "mcp_source_context": "curated_ucp_storefront",
  "mcp_install_target": "generic_streamable_http"
}
```

### Proof Gates

- External builder imports or embeds this source-specific Packrift shelf.
- Packrift records a non-local resource/script/install/first-run event with mcp_source_context=curated_ucp_storefront.
- The builder calls search_products or prepare_purchase_handoff against the source-aware MCP endpoint.
- Any cart URL is produced by prepare_purchase_handoff only after buyer_confirmed=true.
- Sales proof requires source-attributed /r/cart or Shopify order continuity; hosted Packrift demos alone do not count.