Packrift MCP

Create cart handoff URL

create_cart_url

Read-onlyIdempotent

Build the checkout handoff URL once the buyer has confirmed an exact product, quantity, live price, and stock. Preferred input is sku plus quantity; use items only when you already hold variant IDs as strings. Returns a tracked packrift.com cart URL plus a Shopify cart permalink; it never places an order.

Input Schema

TableJSON Schema

Name	Required	Description
`sku`	No	Shortcut for exact Packrift SKUs such as 1066, MFL1295, or LL251WR. When provided without items, the approved variant is resolved automatically.
`items`	No	Advanced path for agents that already have approved variant IDs. Most buyers should use sku plus quantity instead.
`quantity`	No	Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided.
`journey_id`	No	Optional continuity ID echoed from an earlier search or pricing result in this conversation.
`match_type`	No	Optional continuity label describing how the product was matched, echoed from earlier results.
`selected_sku`	No	Buyer-confirmed SKU. When provided, it must resolve to the same catalog item as the cart variant.
`discount_code`	No	Optional discount code to apply to the cart.
`result_set_id`	No	Optional continuity ID echoed from the result set the buyer chose from.
`source_context`	No	Optional short context label for the handoff, such as exact_match, reorder, or quote_followup.
`selected_handle`	No	Buyer-confirmed product handle. When provided, it must resolve to the same catalog item as the cart variant.

Schema Changelog

Changes observed during successful MCP inspections.

Changed21 schema fields changedJul 31, 2026

removedInput schema / properties / ai_commerce_id
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / analytics_context

Removed value: -{
-  "description": "Internal QA context for synthetic evals.",
-  "type": "object"
-}

addedInput schema / properties / discount_code / description

Added value: +"Optional discount code to apply to the cart."

addedInput schema / properties / journey_id / description

Added value: +"Optional continuity ID echoed from an earlier search or pricing result in this conversation."

addedInput schema / properties / match_type / description

Added value: +"Optional continuity label describing how the product was matched, echoed from earlier results."

removedInput schema / properties / mcp_install_target

Removed value: -{
-  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
-  "type": "string"
-}

removedInput schema / properties / mcp_source
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / mcp_source_context

Removed value: -{
-  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
-  "type": "string"
-}

removedInput schema / properties / mcp_target
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_ai_id
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_source
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_target
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / ref

Removed value: -{
-  "default": "mcp",
-  "type": "string"
-}

removedInput schema / properties / reorder_source
```
Removed value: -{
-  "type": "string"
-}
```

addedInput schema / properties / result_set_id / description

Added value: +"Optional continuity ID echoed from the result set the buyer chose from."

changedInput schema / properties / selected_handle / description

Previous value: -"Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant."New value: +"Buyer-confirmed product handle. When provided, it must resolve to the same catalog item as the cart variant."

changedInput schema / properties / selected_sku / description

Previous value: -"Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant."New value: +"Buyer-confirmed SKU. When provided, it must resolve to the same catalog item as the cart variant."

changedInput schema / properties / source_context / description

Previous value: -"Optional short context for analytics, such as exact_match, reorder, quote_followup, or ai_agent."New value: +"Optional short context label for the handoff, such as exact_match, reorder, or quote_followup."

removedInput schema / properties / source_slug
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / suppress_analytics

Removed value: -{
-  "description": "Internal QA flag. When true, do not record an AI-sales cart event.",
-  "type": "boolean"
-}

removedInput schema / properties / utm_term

Removed value: -{
-  "type": "string"
-}

Changed1 schema field changedJul 12, 2026

changedInput schema / properties / items / items / properties / qty / description

Previous value: -"Buyer-confirmed quantity for this line item."New value: +"Buyer-confirmed quantity for this line item. The alias key quantity is also accepted."

Changed16 schema fields changedMay 25, 2026

addedInput schema / anyOf

Added value: +[
+  {
+    "required": [
+      "items"
+    ]
+  },
+  {
+    "required": [
+      "sku"
+    ]
+  }
+]

addedInput schema / properties / items / description

Added value: +"Advanced path for agents that already have approved variant IDs. Most buyers should use sku plus quantity instead."

addedInput schema / properties / items / items / properties / qty / description
```
Added value: +"Buyer-confirmed quantity for this line item."
```

addedInput schema / properties / items / items / properties / variant_id / description

Added value: +"Numeric Shopify variant ID as a string, not a number. Example: \"53475949216112\"."

addedInput schema / properties / mcp_install_target

Added value: +{
+  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
+  "type": "string"
+}

addedInput schema / properties / mcp_source
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / mcp_source_context

Added value: +{
+  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
+  "type": "string"
+}

addedInput schema / properties / mcp_target
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_source
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_target
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / quantity

Added value: +{
+  "default": 1,
+  "description": "Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided.",
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / selected_handle / description

Added value: +"Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

addedInput schema / properties / selected_sku / description

Added value: +"Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

addedInput schema / properties / sku

Added value: +{
+  "description": "Shortcut for exact Packrift SKUs such as 1066, MFL1295, or LL251WR. When provided without items, the approved variant is resolved automatically.",
+  "type": "string"
+}

addedInput schema / properties / source_slug
```
Added value: +{
+  "type": "string"
+}
```
removedInput schema / required
```
Removed value: -[
-  "items"
-]
```

Changed16 schema fields changedMay 25, 2026

removedInput schema / anyOf

Removed value: -[
-  {
-    "required": [
-      "items"
-    ]
-  },
-  {
-    "required": [
-      "sku"
-    ]
-  }
-]

removedInput schema / properties / items / description

Removed value: -"Advanced path for agents that already have approved variant IDs. Most buyers should use sku plus quantity instead."

removedInput schema / properties / items / items / properties / qty / description
```
Removed value: -"Buyer-confirmed quantity for this line item."
```

removedInput schema / properties / items / items / properties / variant_id / description

Removed value: -"Numeric Shopify variant ID as a string, not a number. Example: \"53475949216112\"."

removedInput schema / properties / mcp_install_target

Removed value: -{
-  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
-  "type": "string"
-}

removedInput schema / properties / mcp_source
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / mcp_source_context

Removed value: -{
-  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
-  "type": "string"
-}

removedInput schema / properties / mcp_target
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_source
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_target
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / quantity

Removed value: -{
-  "default": 1,
-  "description": "Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided.",
-  "minimum": 1,
-  "type": "integer"
-}

removedInput schema / properties / selected_handle / description

Removed value: -"Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

removedInput schema / properties / selected_sku / description

Removed value: -"Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

removedInput schema / properties / sku

Removed value: -{
-  "description": "Shortcut for exact Packrift SKUs such as 1066, MFL1295, or LL251WR. When provided without items, the approved variant is resolved automatically.",
-  "type": "string"
-}

removedInput schema / properties / source_slug
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / required
```
Added value: +[
+  "items"
+]
```

Changed3 schema fields changedMay 24, 2026

addedInput schema / properties / items / description

Added value: +"Advanced path for agents that already have approved variant IDs. Most buyers should use sku plus quantity instead."

addedInput schema / properties / items / items / properties / qty / description
```
Added value: +"Buyer-confirmed quantity for this line item."
```

addedInput schema / properties / items / items / properties / variant_id / description

Added value: +"Numeric Shopify variant ID as a string, not a number. Example: \"53475949216112\"."

Changed25 schema fields changedMay 23, 2026

removedInput schema / additionalProperties
```
Removed value: -true
```
addedInput schema / properties / ai_commerce_id
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / analytics_context

Added value: +{
+  "description": "Internal QA context for synthetic evals.",
+  "type": "object"
+}

removedInput schema / properties / discount_code / description

Removed value: -"Optional Packrift discount code to apply at checkout."

removedInput schema / properties / items / description

Removed value: -"Alternative to sku: explicit line items."

removedInput schema / properties / items / items / properties / variant_id / description

Removed value: -"Numeric Shopify variant ID passed as a string, e.g. \"53472879935856\"."

addedInput schema / properties / journey_id
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / match_type
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / mcp_install_target

Added value: +{
+  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
+  "type": "string"
+}

addedInput schema / properties / mcp_source
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / mcp_source_context

Added value: +{
+  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
+  "type": "string"
+}

addedInput schema / properties / mcp_target
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_ai_id
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_source
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_target
```
Added value: +{
+  "type": "string"
+}
```

changedInput schema / properties / quantity / description

Previous value: -"Buyer-confirmed quantity. Used with sku. Ignored when items is provided."New value: +"Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided."

addedInput schema / properties / ref

Added value: +{
+  "default": "mcp",
+  "type": "string"
+}

addedInput schema / properties / reorder_source
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / result_set_id
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / selected_handle

Added value: +{
+  "description": "Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant.",
+  "type": "string"
+}

addedInput schema / properties / selected_sku

Added value: +{
+  "description": "Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant.",
+  "type": "string"
+}

addedInput schema / properties / source_context

Added value: +{
+  "description": "Optional short context for analytics, such as exact_match, reorder, quote_followup, or ai_agent.",
+  "type": "string"
+}

addedInput schema / properties / source_slug
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / suppress_analytics

Added value: +{
+  "description": "Internal QA flag. When true, do not record an AI-sales cart event.",
+  "type": "boolean"
+}

addedInput schema / properties / utm_term
```
Added value: +{
+  "type": "string"
+}
```

Changed25 schema fields changedMay 22, 2026

addedInput schema / additionalProperties
```
Added value: +true
```
removedInput schema / properties / ai_commerce_id
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / analytics_context

Removed value: -{
-  "description": "Internal QA context for synthetic evals.",
-  "type": "object"
-}

addedInput schema / properties / discount_code / description

Added value: +"Optional Packrift discount code to apply at checkout."

addedInput schema / properties / items / description

Added value: +"Alternative to sku: explicit line items."

addedInput schema / properties / items / items / properties / variant_id / description

Added value: +"Numeric Shopify variant ID passed as a string, e.g. \"53472879935856\"."

removedInput schema / properties / journey_id
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / match_type
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / mcp_install_target

Removed value: -{
-  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
-  "type": "string"
-}

removedInput schema / properties / mcp_source
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / mcp_source_context

Removed value: -{
-  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
-  "type": "string"
-}

removedInput schema / properties / mcp_target
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_ai_id
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_source
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / packrift_mcp_target
```
Removed value: -{
-  "type": "string"
-}
```

changedInput schema / properties / quantity / description

Previous value: -"Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided."New value: +"Buyer-confirmed quantity. Used with sku. Ignored when items is provided."

removedInput schema / properties / ref

Removed value: -{
-  "default": "mcp",
-  "type": "string"
-}

removedInput schema / properties / reorder_source
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / result_set_id
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / selected_handle

Removed value: -{
-  "description": "Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant.",
-  "type": "string"
-}

removedInput schema / properties / selected_sku

Removed value: -{
-  "description": "Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant.",
-  "type": "string"
-}

removedInput schema / properties / source_context

Removed value: -{
-  "description": "Optional short context for analytics, such as exact_match, reorder, quote_followup, or ai_agent.",
-  "type": "string"
-}

removedInput schema / properties / source_slug
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / suppress_analytics

Removed value: -{
-  "description": "Internal QA flag. When true, do not record an AI-sales cart event.",
-  "type": "boolean"
-}

removedInput schema / properties / utm_term

Removed value: -{
-  "type": "string"
-}

Changed7 schema fields changedMay 20, 2026

addedInput schema / properties / mcp_install_target

Added value: +{
+  "description": "Optional install target for source-aware MCP installs, such as cline, codex, or generic_streamable_http.",
+  "type": "string"
+}

addedInput schema / properties / mcp_source
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / mcp_source_context

Added value: +{
+  "description": "Optional source slug for source-aware MCP installs, such as cline_mcp_marketplace or mcp_so.",
+  "type": "string"
+}

addedInput schema / properties / mcp_target
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_source
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / packrift_mcp_target
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / source_slug
```
Added value: +{
+  "type": "string"
+}
```

Changed6 schema fields changedMay 19, 2026

addedInput schema / anyOf

Added value: +[
+  {
+    "required": [
+      "items"
+    ]
+  },
+  {
+    "required": [
+      "sku"
+    ]
+  }
+]

addedInput schema / properties / quantity

Added value: +{
+  "default": 1,
+  "description": "Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided.",
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / selected_handle / description

Added value: +"Buyer-confirmed product handle. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

addedInput schema / properties / selected_sku / description

Added value: +"Buyer-confirmed SKU. When provided, it must resolve to the same AI_APPROVE item as the cart variant."

addedInput schema / properties / sku

Added value: +{
+  "description": "Shortcut for exact Packrift SKUs such as 1066, MFL1295, or LL251WR. When provided without items, the approved variant is resolved automatically.",
+  "type": "string"
+}

removedInput schema / required
```
Removed value: -[
-  "items"
-]
```

Changed2 schema fields changedMay 14, 2026
- addedInput schema / properties / ai_commerce_id
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / packrift_ai_id
```
Added value: +{
+  "type": "string"
+}
```

Changed2 schema fields changedMay 10, 2026

addedInput schema / properties / analytics_context

Added value: +{
+  "description": "Internal QA context for synthetic evals.",
+  "type": "object"
+}

addedInput schema / properties / suppress_analytics

Added value: +{
+  "description": "Internal QA flag. When true, do not record an AI-sales cart event.",
+  "type": "boolean"
+}

Changed7 schema fields changedMay 7, 2026
- addedInput schema / properties / journey_id
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / match_type
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / reorder_source
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / result_set_id
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / selected_handle
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / selected_sku
```
Added value: +{
+  "type": "string"
+}
```
- addedInput schema / properties / utm_term
```
Added value: +{
+  "type": "string"
+}
```

Changed1 schema field changedMay 7, 2026

addedInput schema / properties / source_context

Added value: +{
+  "description": "Optional short context for analytics, such as exact_match, reorder, quote_followup, or ai_agent.",
+  "type": "string"
+}

First observedApr 30, 2026

TDQS

A4.1/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and idempotentHint. The description adds that the tool 'never places an order' and returns 'a tracked packrift.com cart URL plus a Shopify cart permalink', which gives concrete behavioral context beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each with a distinct purpose: purpose/precondition, input guidance, and output/side-effect. No filler. Front-loaded with the action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 10 parameters fully described in the schema and annotations covering safety, the description supplies the missing context about when to invoke and what to expect. It doesn't describe return format details, but output schema is absent anyway; the mention of the two URLs suffices.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description adds value by recommending 'sku plus quantity' over 'items' and clarifying that items are for when variant IDs are known. This guidance is not in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's verb and resource: 'Build the checkout handoff URL' and gives the precondition 'once the buyer has confirmed an exact product, quantity, live price, and stock.' It distinguishes the operation from sibling tools like get_bulk_quote_link and get_reorder_link by focusing on the checkout handoff context, though it does not explicitly name alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides clear guidance: 'Preferred input is sku plus quantity; use items only when you already hold variant IDs as strings.' Also conditions usage on buyer confirmation. It does not explicitly enumerate when-not-to-use relative to sibling tools, but the context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Packrift MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Create cart handoff URL

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources