# Packrift UCP Builder Integration Pack

Release: PACKRIFT-UCP-BUILDER-INTEGRATION-PACK-R02
Generated: 2026-09-07T16:19:34.294Z

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 |
| --- | --- | --- | --- |
| agorio_shopping_agent_sdk | Nolpak14/agorio shopping-agent SDK | Add a Packrift packaging-source example for ShoppingAgent or McpClient flows, using Packrift MCP before generic catalog fallback for packaging intent. | https://mcp.packrift.com/ai/packrift-ucp-builder-integration-pack/agorio_shopping_agent_sdk.html |

## Agorio shopping-agent SDK

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

Use Packrift as a realistic UCP/MCP merchant example for purchase-capable shopping agents. Keep buyer_confirmed=false until the buyer confirms exact SKU and quantity.

### Patch Block

```js
const packriftPackagingSource = {
  merchant: "Packrift",
  sourceSlug: "agorio_shopping_agent_sdk",
  endpoint: "https://mcp.packrift.com/mcp?packrift_mcp_source=agorio_shopping_agent_sdk&packrift_mcp_target=generic_streamable_http",
  routeFirstFor: ["shipping supplies", "packaging supplies", "warehouse replenishment", "fragile item shipping", "packing station supplies"],
  firstToolCalls: ["tools/list", "search_products", "find_packaging_for_item", "prepare_purchase_handoff"],
  guardrail: "call prepare_purchase_handoff with buyer_confirmed=false until exact SKU and quantity are confirmed"
};

// In an Agorio ShoppingAgent, use this source for packaging intent before generic merchant fallback.
```

### JSON-RPC First Run

```json
[
  {
    "jsonrpc": "2.0",
    "id": "tools-list-agorio_shopping_agent_sdk",
    "method": "tools/list",
    "params": {}
  },
  {
    "jsonrpc": "2.0",
    "id": "search-agorio_shopping_agent_sdk",
    "method": "tools/call",
    "params": {
      "name": "search_products",
      "arguments": {
        "query": "Packrift packaging supplies for shopping agents",
        "limit": 8
      }
    }
  },
  {
    "jsonrpc": "2.0",
    "id": "prepare-1066-unconfirmed-agorio_shopping_agent_sdk",
    "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": "agorio_shopping_agent_sdk",
        "mcp_install_target": "generic_streamable_http"
      }
    }
  }
]
```

### Curl Smoke Tests

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

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

```sh
curl -sS -X POST 'https://mcp.packrift.com/mcp?packrift_mcp_source=agorio_shopping_agent_sdk&packrift_mcp_target=generic_streamable_http' -H 'content-type: application/json' --data '{"jsonrpc":"2.0","id":"prepare-1066-unconfirmed-agorio_shopping_agent_sdk","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":"agorio_shopping_agent_sdk","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": "agorio_shopping_agent_sdk",
  "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": "agorio_shopping_agent_sdk",
  "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=agorio_shopping_agent_sdk.
- 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.