---
title: >-
  Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/storefront-mcp-cart-tools-are-being-deprecated-in-favour-of-ucp-cart-mcp
  md: >-
    https://shopify.dev/changelog/storefront-mcp-cart-tools-are-being-deprecated-in-favour-of-ucp-cart-mcp.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2026-06-23T08:15:19-04:00'
  postedAt: '2026-06-24T12:00:00-04:00'
  updatedAt: '2026-06-23T10:18:32-04:00'
  effectiveAt: '2026-06-24T12:00:00-04:00'
---

June 24, 2026

Tags:

* Action Required
* API

# Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP

### What's changing

The cart tools on the Storefront MCP server are being deprecated in favour of the UCP-conforming Cart MCP tools:

* `get_cart` and `update_cart` on `https://{shop}.myshopify.com/api/mcp` are deprecated.

Cart MCP implements the UCP cart capability (`dev.ucp.shopping.cart`, version `2026-04-08`) and exposes the following tools at the `https://{shop-domain}/api/ucp/mcp` endpoint:

* `create_cart`: Create a new cart with line items and optional buyer context.
* `get_cart`: Retrieve the current state of a cart.
* `update_cart`: Replace the cart's contents.
* `cancel_cart`: Cancel a cart.

The deprecated tools will be maintained until August 31, 2026, but all documentation will refer to the Cart MCP tools.

### What you should do

If you're building with the Storefront MCP cart tools:

* Migrate `get_cart` and `update_cart` calls to the Cart MCP tools, and update endpoints to use `https://{shop-domain}/api/ucp/mcp`.

* Include a `meta` object carrying `ucp-agent.profile` in every request, and a `meta["idempotency-key"]` (UUID) for `cancel_cart`.

* Note that `update_cart` uses PUT semantics: each request replaces the cart's full state, so send the complete `line_items` array on every update rather than patching individual fields.

* Consult the updated request and response schemas for all cart tools and update your app to match.

  See the documentation for Cart MCP (<https://shopify.dev/docs/agents/carts-and-checkout/cart-mcp>) for more details.