# Packrift MCP Install Matrix

Release: PACKRIFT-MCP-INSTALL-MATRIX-R09
Generated: 2026-05-20T21:13:10.685Z
Canonical endpoint: https://mcp.packrift.com/mcp

## Purpose

Give agent hosts, developers, directories, and AI-commerce workflows copy-ready Packrift MCP install paths and smoke tests without creating a duplicate Packrift CLI or buyer surface.

## Install Principles

- Use https://mcp.packrift.com/mcp as the canonical runtime endpoint.
- Prefer remote MCP install paths over local self-hosting.
- For stdio-only hosts, use the mcp-remote bridge as a thin compatibility wrapper around the hosted endpoint.
- Do not ask buyers for Packrift API keys.
- Use browser agents only as read-first discovery bridges; confirm live commerce facts through MCP.
- Use /r/config/{source} when sharing copy-ready MCP JSON config from a directory, partner, campaign, or agent handoff so the fetch is measurable.
- Use /r/install/{source}/{target} when a directory, partner, or agent handoff needs a target-specific install command or config and install-intent attribution.
- Use /ai/mcp-activation-wave.json when the material tool-call gate is open; it selects the current source-aware real-host runs to execute through this install matrix.
- Use prepare_purchase_handoff for known exact SKUs when the host needs one compact live-confirmation and guarded cart-handoff tool call.
- Confirm exact SKU, live price, and live inventory before cart handoff.
- Run the cart-1066 smoke test after install; it returns a measured cart URL only and does not place an order.
- Route no-exact-match cases to quote recovery instead of forcing nearby substitutes.

## Copy-Ready Generic Config

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp"
    }
  }
}
```

## Copy-Ready Stdio Bridge Config

```json
{
  "mcpServers": {
    "packrift": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.packrift.com/mcp"
      ]
    }
  }
}
```

## Copy-Ready Cline Config

```json
{
  "mcpServers": {
    "packrift": {
      "type": "streamableHttp",
      "url": "https://mcp.packrift.com/mcp",
      "disabled": false,
      "timeout": 60
    }
  }
}
```

## Tracked Install Actions

Template: `https://mcp.packrift.com/r/install/{source}/{target}`

- generic_streamable_http: https://mcp.packrift.com/r/install/generic/generic_streamable_http?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=generic_streamable_http
- stdio_mcp_remote: https://mcp.packrift.com/r/install/generic/stdio_mcp_remote?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=stdio_mcp_remote
- claude_code: https://mcp.packrift.com/r/install/generic/claude_code?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=claude_code
- codex: https://mcp.packrift.com/r/install/generic/codex?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=codex
- cursor_windsurf_vscode: https://mcp.packrift.com/r/install/generic/cursor_windsurf_vscode?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=cursor_windsurf_vscode
- cline: https://mcp.packrift.com/r/install/generic/cline?utm_source=generic&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=cline

## Source-Aware Install Examples

Runtime source inference: PACKRIFT-MCP-RUNTIME-SOURCE-INFERENCE-R03

Use a source-aware endpoint from /r/config/{source}, /r/install/{source}/{target}, or the examples below.

No duplicate work rule: Do not create a separate Packrift CLI or buyer surface for attribution. Use the hosted endpoint with source-aware config and first-run URLs.

### mcp_so -> generic_streamable_http

MCP.so has mature MCP tool and cart proof; the next useful action is source-preserving buyer or reviewer follow-through.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=mcp_so&packrift_mcp_target=generic_streamable_http`

Tracked config: https://mcp.packrift.com/r/config/mcp_so?utm_source=mcp_so&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/mcp_so/generic_streamable_http?utm_source=mcp_so&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=generic_streamable_http

Tracked first run shell: https://mcp.packrift.com/r/run/mcp_so/generic_streamable_http?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=mcp_so&packrift_mcp_target=generic_streamable_http"
    }
  }
}
```

### cline_mcp_marketplace -> cline

Cline Marketplace review already has a canonical issue; use this exact tracked config instead of creating duplicate submissions.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=cline_mcp_marketplace&packrift_mcp_target=cline`

Tracked config: https://mcp.packrift.com/r/config/cline_mcp_marketplace?utm_source=cline_mcp_marketplace&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/cline_mcp_marketplace/cline?utm_source=cline_mcp_marketplace&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=cline

Tracked first run shell: https://mcp.packrift.com/r/run/cline_mcp_marketplace/cline?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=cline_mcp_marketplace&packrift_mcp_target=cline"
    }
  }
}
```

### glama_connector -> glama_connector

Glama has a live hosted connector and qualified cart landings; keep connector-side installs and tool calls attributable.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=glama_connector&packrift_mcp_target=glama_connector`

Tracked config: https://mcp.packrift.com/r/config/glama_connector?utm_source=glama_connector&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/glama_connector/glama_connector?utm_source=glama_connector&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=glama_connector

Tracked first run shell: https://mcp.packrift.com/r/run/glama_connector/glama_connector?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=glama_connector&packrift_mcp_target=glama_connector"
    }
  }
}
```

### docker_mcp_catalog -> generic_streamable_http

Docker MCP Catalog has a live PR path; use source-aware remote MCP runs while the catalog review is pending.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=docker_mcp_catalog&packrift_mcp_target=generic_streamable_http`

Tracked config: https://mcp.packrift.com/r/config/docker_mcp_catalog?utm_source=docker_mcp_catalog&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/docker_mcp_catalog/generic_streamable_http?utm_source=docker_mcp_catalog&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=generic_streamable_http

Tracked first run shell: https://mcp.packrift.com/r/run/docker_mcp_catalog/generic_streamable_http?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=docker_mcp_catalog&packrift_mcp_target=generic_streamable_http"
    }
  }
}
```

### official_registry -> generic_streamable_http

The official registry listing is current and should preserve attribution when copied into downstream MCP directories.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=official_registry&packrift_mcp_target=generic_streamable_http`

Tracked config: https://mcp.packrift.com/r/config/official_registry?utm_source=official_registry&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/official_registry/generic_streamable_http?utm_source=official_registry&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=generic_streamable_http

Tracked first run shell: https://mcp.packrift.com/r/run/official_registry/generic_streamable_http?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=official_registry&packrift_mcp_target=generic_streamable_http"
    }
  }
}
```

### mcpservers_org -> generic_streamable_http

mcpservers.org is live and should remain measurable as downstream agents copy the hosted endpoint.

Source-aware endpoint: `https://mcp.packrift.com/mcp?packrift_mcp_source=mcpservers_org&packrift_mcp_target=generic_streamable_http`

Tracked config: https://mcp.packrift.com/r/config/mcpservers_org?utm_source=mcpservers_org&utm_medium=directory_config&utm_campaign=packrift_mcp_install&utm_content=client_config

Tracked install: https://mcp.packrift.com/r/install/mcpservers_org/generic_streamable_http?utm_source=mcpservers_org&utm_medium=install_action&utm_campaign=packrift_mcp_install&utm_content=generic_streamable_http

Tracked first run shell: https://mcp.packrift.com/r/run/mcpservers_org/generic_streamable_http?format=sh

Generic remote MCP JSON:

```json
{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp?packrift_mcp_source=mcpservers_org&packrift_mcp_target=generic_streamable_http"
    }
  }
}
```

## Activation Wave

JSON: https://mcp.packrift.com/ai/mcp-activation-wave.json

HTML: https://mcp.packrift.com/ai/mcp-activation-wave.html

Use this after a directory, marketplace, or partner has seen Packrift but has not produced real external MCP host tool calls.

Success signal: A valid activation run reaches create_cart_url from a real MCP host and later appears in the source activation queue or funnel snapshot as non-suppressed external proof.

No duplicate work rule: Do not create a Packrift CLI or duplicate checkout surface; use the hosted endpoint plus source-aware install and first-run URLs.

## Host Matrix

| Host | Status | Preferred | Audience | First tests |
| --- | --- | --- | --- | --- |
| Generic Streamable HTTP MCP client | ready | yes | Any MCP-capable host that accepts a remote HTTP endpoint. | `tools-list`, `prompts-list`, `candidate-1066`, `cart-1066` |
| Stdio MCP bridge with mcp-remote | ready | yes | Legacy MCP hosts that only accept a local stdio command and cannot connect to remote HTTP directly. | `tools-list`, `prompts-list`, `candidate-1066`, `price-1066`, `inventory-1066`, `cart-1066` |
| Claude Code | ready | yes | Developers adding Packrift to Claude Code as a remote MCP server. | `tools-list`, `candidate-1066`, `price-1066`, `inventory-1066`, `cart-1066` |
| Codex | ready | yes | Codex workspaces that should use Packrift as a remote MCP endpoint. | `tools-list`, `prompts-list`, `candidate-1066`, `cart-1066` |
| Claude Desktop | ready | yes | Claude Desktop users editing MCP server config. | `tools-list`, `candidate-1066`, `cart-1066` |
| Cursor, Windsurf, VS Code, and Roo-style MCP hosts | ready | yes | IDE agents that accept MCP JSON config or remote server URLs. | `tools-list`, `prompts-list`, `candidate-1066`, `cart-1066` |
| Cline | ready | yes | Cline users and Cline MCP Marketplace reviewers who need a direct remote MCP config. | `tools-list`, `candidate-1066`, `price-1066`, `inventory-1066`, `cart-1066` |
| Glama hosted connector | live | yes | Users who prefer installing from a connector directory instead of hand-editing config. | `tools-list`, `candidate-1066`, `cart-1066` |
| MCP Marketplace | live | yes | Users browsing marketplace-style MCP directories. | `tools-list`, `candidate-1066`, `cart-1066` |
| Browserbase Browse and browser agents | bridge | no | Browser agents that can read public URLs but may not install MCP directly. | `candidate-1066`, `price-1066`, `inventory-1066`, `cart-1066` |
| Optional self-hosted container | optional | no | Directories or local environments that require a package-style install surface. | `tools-list` |

## Smoke Tests

| ID | Test | Purpose |
| --- | --- | --- |
| tools-list | List tools | Confirm the hosted endpoint is reachable and exposes the current Packrift tool surface. |
| prompts-list | List prompts | Confirm exact-spec, reorder, and cart handoff workflows are visible to the host agent. |
| candidate-1066 | Fetch one ready cart handoff candidate | Start with a known AI-approved SKU and inspect the required live-confirmation sequence before any cart action. |
| price-1066 | Confirm live price | Verify a host can call live commercial checks before presenting a buyer-facing recommendation. |
| inventory-1066 | Confirm live inventory | Verify a host can prevent cart handoff when an exact SKU is unavailable. |
| cart-1066 | Create measured cart handoff URL | Confirm the post-install path reaches a measured MCP /r/cart URL for a known exact SKU. This creates a URL only; it does not place an order. |

## Smoke Test Requests

### tools-list

```json
{
  "jsonrpc": "2.0",
  "id": "tools",
  "method": "tools/list"
}
```

### prompts-list

```json
{
  "jsonrpc": "2.0",
  "id": "prompts",
  "method": "prompts/list"
}
```

### candidate-1066

```json
{
  "jsonrpc": "2.0",
  "id": "candidate-1066",
  "method": "tools/call",
  "params": {
    "name": "get_cart_handoff_candidates",
    "arguments": {
      "sku": "1066",
      "limit": 1
    }
  }
}
```

### price-1066

```json
{
  "jsonrpc": "2.0",
  "id": "price-1066",
  "method": "tools/call",
  "params": {
    "name": "get_pricing",
    "arguments": {
      "variant_ids": [
        "53472879935856"
      ],
      "quantity": 1
    }
  }
}
```

### inventory-1066

```json
{
  "jsonrpc": "2.0",
  "id": "inventory-1066",
  "method": "tools/call",
  "params": {
    "name": "check_inventory",
    "arguments": {
      "variant_ids": [
        "53472879935856"
      ]
    }
  }
}
```

### cart-1066

```json
{
  "jsonrpc": "2.0",
  "id": "cart-1066",
  "method": "tools/call",
  "params": {
    "name": "create_cart_url",
    "arguments": {
      "sku": "1066",
      "quantity": 1,
      "selected_sku": "1066",
      "selected_handle": "10x6x6-ect-32-kraft-long-corrugated-boxes-25-bundle",
      "match_type": "install_matrix_first_useful_run",
      "source_context": "install_matrix_first_cart_run",
      "journey_id": "mcp_install_matrix_1066_53472879935856",
      "result_set_id": "mcp_install_matrix_first_run",
      "utm_term": "1066"
    }
  }
}
```

## Conversion Path

1. Install or connect the hosted Packrift MCP endpoint.
2. Run tools/list and prompts/list.
3. For a known exact SKU, call prepare_purchase_handoff with buyer_confirmed=false first; call again with buyer_confirmed=true only after the buyer confirms SKU and quantity.
4. Call get_cart_handoff_candidates for a known SKU or search_products for the buyer request.
5. Call get_product, get_pricing, and check_inventory for the exact selected SKU.
6. For first-run verification, call create_cart_url for the known SKU 1066 demo after live checks; it returns a URL only and does not place an order.
7. For real buyer workflows, call create_cart_url only after buyer confirmation.
8. Use the returned MCP cart landing URL so ref=mcp and mcp_tool attribution stay measurable.

## Proof URLs

- health: https://mcp.packrift.com/health
- mcp_start: https://mcp.packrift.com/ai/mcp-start.json
- manifest: https://mcp.packrift.com/manifest
- adoption_kit: https://mcp.packrift.com/ai/mcp-adoption-kit.json
- install_actions: https://mcp.packrift.com/ai/mcp-install-actions.json
- tracked_install_template: https://mcp.packrift.com/r/install/{source}/{target}
- client_config: https://mcp.packrift.com/ai/mcp-client-config.json
- tracked_config_template: https://mcp.packrift.com/r/config/{source}
- tracked_config_generic: https://mcp.packrift.com/r/config/generic
- root_mcp_json: https://mcp.packrift.com/mcp.json
- well_known_mcp_json: https://mcp.packrift.com/.well-known/mcp.json
- browser_agent_bridge: https://mcp.packrift.com/ai/browser-agent-bridge.json
- buyer_use_cases: https://mcp.packrift.com/ai/mcp-buyer-use-cases.json
- cart_activation: https://mcp.packrift.com/ai/mcp-cart-activation.json
- first_run_proof: https://mcp.packrift.com/ai/mcp-first-run-proof.json
- workflow_gallery: https://mcp.packrift.com/ai/mcp-workflow-gallery.json
- usage_snapshot: https://mcp.packrift.com/ai/mcp-usage-snapshot.json
- source_activation_queue: https://mcp.packrift.com/ai/mcp-source-activation-queue.json
- activation_wave: https://mcp.packrift.com/ai/mcp-activation-wave.json
- activation_wave_html: https://mcp.packrift.com/ai/mcp-activation-wave.html
- cart_handoff_candidates: https://mcp.packrift.com/ai/mcp-cart-handoff-candidates.json
- measured_handoffs: https://mcp.packrift.com/ai/measured-handoffs.json
- all_agent_capture: https://mcp.packrift.com/ai/all-agent-capture.json
- agent_capture_outreach: https://mcp.packrift.com/ai/agent-capture-outreach.json

Machine-readable version: https://mcp.packrift.com/ai/mcp-install-matrix.json