--- title: Agentic commerce description: >- Build AI agents that authenticate with Shopify, search the Catalog, build carts and checkouts, and monitor orders using the Universal Commerce Protocol (UCP). source_url: html: 'https://shopify.dev/docs/agents' md: 'https://shopify.dev/docs/agents.md' --- # Agentic commerce has arrived Build unified agentic experiences that securely act on behalf of buyers with the [Universal Commerce Protocol (UCP)](https://ucp.dev) and Shopify's UCP-compliant MCP servers. [#### Start building\ \ ](https://shopify.dev/docs/agents/get-started/authentication) [Authenticate, search the Catalog, build a cart, refer buyers to checkout, and monitor orders.](https://shopify.dev/docs/agents/get-started/authentication) ## 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. ![The four-stage agentic commerce buyer journey: discovery, cart, checkout, and orders, connected by dashed arrows.](https://shopify.dev/assets/assets/images/agents/ucp-flow-4-light-C9RMxm5d.png) ![Negotiate and authenticate](https://shopify.dev/assets/assets/images/icons/32/number-1-DG-dFgp6.png)![Negotiate and authenticate](https://shopify.dev/assets/assets/images/icons/32/number-1-dark-axuV6Vij.png) ## 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 profiles\ \ ](https://shopify.dev/docs/agents/profiles) [Host a UCP profile for capability negotiation and signed-request verification.](https://shopify.dev/docs/agents/profiles) [Auth and rate limiting\ \ ](https://shopify.dev/docs/agents/profiles/auth-and-rate-limiting) [Trust tiers, capability matrix, and rate limits per tier.](https://shopify.dev/docs/agents/profiles/auth-and-rate-limiting) ![Diagram showing an agent presenting its profile to Shopify, with a key icon representing authenticated capability negotiation.](https://shopify.dev/assets/assets/images/agents/agents-auth-light-BQxS1ihn.png) ![Search results across multiple Shopify merchants, with product titles, images, and variant details surfaced for an agent to act on.](https://shopify.dev/assets/assets/images/agents/catalog-light-wSL3czp-.png) ![Discover products](https://shopify.dev/assets/assets/images/icons/32/number-2-KzqDfbX_.png)![Discover products](https://shopify.dev/assets/assets/images/icons/32/number-2-dark-Btbcv5X3.png) ## 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 Catalog\ \ ](https://shopify.dev/docs/agents/catalog/global-catalog) [Search products across every Shopify merchant from a single endpoint.](https://shopify.dev/docs/agents/catalog/global-catalog) [Storefront Catalog\ \ ](https://shopify.dev/docs/agents/catalog/storefront-catalog) [Scope discovery to a single merchant's storefront.](https://shopify.dev/docs/agents/catalog/storefront-catalog) ![Carts and checkout](https://shopify.dev/assets/assets/images/icons/32/number-3-69W0NVcD.png)![Carts and checkout](https://shopify.dev/assets/assets/images/icons/32/number-3-dark-Dap3AmqO.png) ## Carts and 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 MCP\ \ ](https://shopify.dev/docs/agents/carts-and-checkout/cart-mcp) [Build and iterate on carts with line items, localization, and buyer context.](https://shopify.dev/docs/agents/carts-and-checkout/cart-mcp) [Checkout MCP\ \ ](https://shopify.dev/docs/agents/carts-and-checkout/checkout-mcp) [Convert carts into checkouts and complete purchases for trusted agents.](https://shopify.dev/docs/agents/carts-and-checkout/checkout-mcp) ![A checkout session with line items, fulfillment options, and a continue link that hands the buyer off to the merchant storefront.](https://shopify.dev/assets/assets/images/agents/zoomedcheckoutlight-6vMgJOBz.png) ![An order detail view showing fulfillment status, line items, and post-purchase adjustments returned by get\_order and order webhooks.](https://shopify.dev/assets/assets/images/agents/order-light-DsWFrEev.png) ![Monitor orders](https://shopify.dev/assets/assets/images/icons/32/number-4-DqGMO7Cl.png)![Monitor orders](https://shopify.dev/assets/assets/images/icons/32/number-4-dark-B9fZ2kr3.png) ## 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 MCP\ \ ](https://shopify.dev/docs/agents/orders/order-mcp) [Fetch fresh order state on demand with the `get_order` tool.](https://shopify.dev/docs/agents/orders/order-mcp) [Order webhooks\ \ ](https://shopify.dev/docs/agents/orders/order-webhooks) [Subscribe to lifecycle events for fulfillment, returns, refunds, and edits.](https://shopify.dev/docs/agents/orders/order-webhooks)