Skip to main content

Note

Start with Shop MCP for most agents and apps. For exceptions and other options, refer to Choose your path.

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 22.19.0 or higher. The toolkit is supported on any agent that supports the skills format.

Terminal: Install the UCP CLI

npm install -g @shopify/ucp-cli

Terminal: Install the Shopify plugin

claude plugin install shopify-ai-toolkit@claude-plugins-official

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 so Shopify can set its rate limits and tool access.
  • 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.

Anchor to Negotiate and authenticateStep 1 Negotiate and authenticate

Publish a profile, a JSON file that describes your agent, so Shopify can verify who's calling. How your agent identifies itself sets its rate limits and which tools it can use. Shopify calls these levels trust tiers. Agents that authenticate with a token can get permission to complete checkouts themselves, instead of sending buyers to the merchant's checkout page. You host the profile at a well-known URL and reference it on every UCP request. The UCP CLI uses a Shopify-managed profile until you publish your own.

Diagram showing an agent presenting its profile to Shopify, with a key icon representing authenticated capability negotiation.




Was this page helpful?