Skip to main content

About Shop MCP

Shop MCP is the recommended way to build shopping into an agent or app. Shop MCP is a hosted Model Context Protocol (MCP) server from Shopify, accessed at https://mcp.shop.com/, that lets your agent find products from Shopify merchants, check out with them, and use the buyer's Shop account.

You don't need an API key or to define a UCP profile, since Shop MCP sends its own profile, and search works without an account. You don't need an AI model either. Agents in MCP clients, apps that call the tools from a backend, and scripts that use the Shop CLI all reach the same tools. Agents can load instructions for the tools from https://mcp.shop.com/skill.md.

Connect to https://mcp.shop.com/ itself, with no /mcp path. Your MCP client must support the 2026-07-28 version of the MCP specification. If your client supports only an earlier version, then use the Shop CLI or call the server over HTTP.


Install the Shop CLI and its agent skill, then run your first product search without an account or API key using the following commands. For other ways to connect, choose a guide below. The full Shop MCP documentation and tool reference are on shop.dev.

Each guide reaches the same tools. To sign in a buyer from their own agent, a script, or a prototype, use Shop's public client with the device flow.

For an app that you distribute, register your own client so buyers recognize your app when they sign in.

Terminal: Install the Shop CLI and skill

npm install --global @shopify/shop@latest
shop skill --install

Terminal: Search without an account

shop search 'rain jacket' --country CA --currency CAD --limit 5

Anchor to What your agent can doWhat your agent can do

Shop MCP covers the whole purchase, from search to order tracking. Search, physical-store lookup, carts, and checkouts work without sign-in. When a buyer signs in with Shop, your agent can also pay with Shop Pay, use the buyer's saved details, and track their orders.

The table below compares what your agent can do with and without Shop sign-in. For details about each tool refer to the Shop MCP tool reference.

Capability and toolsWithout Shop sign-inWith Shop sign-in
Search products

  • search_catalog
  • lookup_catalog
  • get_product
Search and view productsSearch and view products using saved preferences
Find physical stores

  • search_locations
  • lookup_locations
Find merchant locationsFind merchant locations
Build carts

  • create_cart
  • get_cart
  • update_cart
Create and update cartsCreate and update carts
Create checkouts

  • create_checkout
  • get_checkout
  • update_checkout
Create and update checkoutsCreate and update checkouts using saved addresses for delivery
Finish a purchase

  • complete_checkout
Buyer reviews and pays on the merchant's checkout pageAgent completes checkout after buyer confirmation and payment selection
Access account details

  • get_account
Requires sign-inRead saved addresses, payment methods, and spend permissions
Pay at non-Shopify stores

  • create_spend_request
  • Other spend request tools
Requires sign-inRequest a single-purchase card, approved by the buyer in Shop
Track orders

  • search_orders
Requires sign-inSearch the buyer's Shop-tracked orders

Each checkout belongs to one merchant, so a purchase from three stores takes three checkouts. Your agent can also earn commission on the sales it drives, through promoted placements. For every tool and its arguments, refer to the Shop MCP tool reference.

Use Shop MCP by default. For exceptions and other options, refer to Choose your path.


Signed-in buyers pay with Shop Pay, using the payment methods and addresses saved to their Shop account. Your agent passes the Shop Pay payment method that the checkout returns, and never handles the buyer's card details. Eligible Shop Pay orders are protected against fraud-related chargebacks through Shopify Protect.

Read About Shop Pay to learn more.


Was this page helpful?