Migrate from Storefront MCP
The catalog and cart tools on https://{shop}/api/mcp were removed. Use the Universal Commerce Protocol (UCP) instead. For the deprecation announcement, refer to the developer changelog.
The catalog and cart tools on https://{shop}/api/mcp were removed. Use the Universal Commerce Protocol (UCP) instead. For the deprecation announcement, refer to the developer changelog.
Storefront MCP let AI agents search a store's catalog and manage carts over the Model Context Protocol (MCP). UCP now provides these capabilities at https://{shop}/api/ucp/mcp.
Anchor to Choose your pathChoose your path
- If you're a merchant and want to add AI chat to your online store without writing code, then use the Inbox agent in Shopify Inbox. Before you start, check the Inbox agent requirements.
- If you're a developer or you build a third-party AI assistant, then build on UCP. Start with the quickstart, or read the Agentic commerce overview.
Anchor to Tool mapTool map
| Storefront MCP tool | Replacement |
|---|---|
search_catalog, get_product_details | Storefront Catalog MCP: search_catalog, lookup_catalog, and get_product on /api/ucp/mcp |
get_cart, update_cart | Cart MCP: create_cart, get_cart, update_cart, and cancel_cart |
| Checkout URL from the cart | Checkout MCP |
search_shop_policies_and_faqs | Unchanged on /api/mcp. Refer to the Policy and FAQs tool. |
Anchor to What changes in your codeWhat changes in your code
- Include an agent profile in every request to
/api/ucp/mcp. - Create carts with
create_cart. Eachupdate_cartrequest replaces the full cart, so send every line item and field that you want to keep. - Authenticate or sign every request to Checkout MCP.
Anchor to Customer Accounts MCPCustomer Accounts MCP
The Customer Accounts MCP server is unchanged. Its documentation moved to Customer Accounts MCP. To track orders through UCP, refer to Order MCP.
Anchor to Sample appSample app
The shop-chat-agent sample app and its tutorial are deprecated.