Agentic commerceSkip to main content Apps Storefronts Agents References Changelog Ask assistant/ Help • Log inCollapse sidebar Getting started Agentic commerce with UCP Getting started with agentic Negotiate and authenticate About profiles Authentication Discover products About Catalogs Global Catalog Storefront Catalog Complete checkout About carts and checkout Cart MCP Checkout Monitor orders About orders Order MCP Order webhooks Full index Build commerce agents with UCP Build unified agentic experiences that securely act on behalf of buyers with the Universal Commerce Protocol (UCP) and Shopify's UCP-compliant MCP servers. Start buildingInstall the toolkit, then walk the full flow from discovery to order tracking. Start building Install the toolkit, then walk the full flow from discovery to order tracking. Start building Install the toolkit, then walk the full flow from discovery to order tracking. Anchor to Get startedGet started Install the UCP CLI and Shopify AI Toolkit plugin for your supported AI tool. Built for agent workflows, the CLI provides structured commands to search the Catalog, build carts, create checkouts, hand off buyers, and track orders. The toolkit's ucp skill helps agents apply UCP best practices against each merchant's live schema. Before you install, make sure you have Node.js 18 or higher. The toolkit is supported on any agent that supports the skills format. Claude Code Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Terminal: Install the Shopify plugin Copy $ claude plugin install shopify-ai-toolkit@claude-plugins-official Codex Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Terminal: Install the Shopify plugin Copy $ codex plugin add shopify@openai-curated Antigravity CLI Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Terminal: Install the Shopify plugin Copy $ agy plugin install https://github.com/Shopify/shopify-ai-toolkit Cursor Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Cursor Chat: Copy $ /add-plugin shopify VS Code Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Command Palette > Chat: Install Plugin From Source Copy 1 https://github.com/Shopify/shopify-ai-toolkit Claude CodeCodexAntigravity CLICursorVS Code Terminal: Install the UCP CLI Copy $ npm install -g @shopify/ucp-cli Terminal: Install the Shopify plugin Copy $ claude plugin install shopify-ai-toolkit@claude-plugins-official Anchor to Access universal cartAccess universal cart One Cart, every brand. The Universal Cart API lets AI agents collect items from any merchant, on or off Shopify, into a single, unified cart, all via UCP. Request accessJoin the early access waitlist. Request access Join the early access waitlist. Request access Join the early access waitlist. Anchor to Understand how Shopify does UCPUnderstand how Shopify does UCP Shopify's MCP tools implement UCP at every step of the buyer journey: Negotiate and authenticate: Identify your agent and get the right access tier. Discover products: Search across hundreds of millions of Shopify listings. Carts and checkout: Build carts, convert them to checkouts, and hand off to the merchant for payment. Monitor orders: Receive order webhooks and fetch fresh order state on demand. Anchor to [object Object], Negotiate and authenticate Negotiate and authenticate Define a profile so Shopify can verify your agent and apply the right rate limits and tool access. Higher trust tiers unlock broader access, including direct checkout completion. Profiles are hosted at a well-known URL and referenced on every UCP request. About profilesHost a UCP profile for capability negotiation and signed-request verification. About profiles Host a UCP profile for capability negotiation and signed-request verification. About profiles Host a UCP profile for capability negotiation and signed-request verification. Auth and rate limitingTrust tiers, capability matrix, and rate limits per tier. Auth and rate limiting Trust tiers, capability matrix, and rate limits per tier. Auth and rate limiting Trust tiers, capability matrix, and rate limits per tier. Anchor to [object Object], Discover products Discover products Query products across all Shopify merchants with the Global Catalog, or scope results to a single merchant with a Storefront Catalog. When buyers pick a product, fetch the variant details you need to build a cart or hand off to a checkout permalink. Global CatalogSearch products across every Shopify merchant from a single endpoint. Global Catalog Search products across every Shopify merchant from a single endpoint. Global Catalog Search products across every Shopify merchant from a single endpoint. Storefront CatalogScope discovery to a single merchant's storefront. Storefront Catalog Scope discovery to a single merchant's storefront. Storefront Catalog Scope discovery to a single merchant's storefront. Anchor to [object Object], Build carts and convert to checkout Build carts and convert to checkout Build carts as buyers iterate. Add line items, apply localization, and estimate totals across multiple turns of conversation. When buyers are ready, convert the cart into a checkout and refer them to the merchant storefront to complete payment. Trusted agents can complete checkouts directly. Cart MCPBuild and iterate on carts with line items, localization, and buyer context. Cart MCP Build and iterate on carts with line items, localization, and buyer context. Cart MCP Build and iterate on carts with line items, localization, and buyer context. Checkout MCPConvert carts into checkouts and complete purchases for trusted agents. Checkout MCP Convert carts into checkouts and complete purchases for trusted agents. Checkout MCP Convert carts into checkouts and complete purchases for trusted agents. Anchor to [object Object], Monitor orders Monitor orders After checkout, monitor order lifecycle changes (fulfillment events, refunds, returns, exchanges, and cancellations) with UCP-shaped order webhooks. Fetch fresh order state on demand with the get_order MCP tool when the buyer asks "Where's my order?" or when reconciling a missed webhook. Order MCPFetch fresh order state on demand with the get_order tool. Order MCP Fetch fresh order state on demand with the get_order tool. Order MCP Fetch fresh order state on demand with the get_order tool. Order webhooksSubscribe to lifecycle events for fulfillment, returns, refunds, and edits. Order webhooks Subscribe to lifecycle events for fulfillment, returns, refunds, and edits. Order webhooks Subscribe to lifecycle events for fulfillment, returns, refunds, and edits. Was this page helpful?YesNo Updates Developer changelog Shopify Editions Business growth Shopify Partners Program Shopify App Store Shopify Academy Legal Terms of service API terms of use Privacy policy Partners Program Agreement Shopify About Shopify Shopify Plus Careers Investors Press and media