---
title: About Shop MCP
description: >-
  Shop MCP is the recommended way to build shopping into an agent or app. It's a
  hosted MCP server from Shopify for finding products from Shopify merchants,
  checking out with them, and using the buyer's Shop account.
source_url:
  html: 'https://shopify.dev/docs/agents/shop-mcp'
  md: 'https://shopify.dev/docs/agents/shop-mcp.md'
---

# About Shop MCP

[Shop MCP](https://shop.dev/docs/connect) is the recommended way to build shopping into an agent or app. Shop MCP is a hosted [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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](https://shopify.dev/docs/agents/profiles), 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](https://shop.dev/docs/cli) all reach the same tools. Agents can load instructions for the tools from [`https://mcp.shop.com/skill.md`](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](https://modelcontextprotocol.io/specification/2026-07-28). If your client supports only an earlier version, then use the Shop CLI or call the server over HTTP.

***

## Get started

Install the [Shop CLI](https://shop.dev/docs/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](https://shop.dev/docs).

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](https://shop.dev/docs/authentication#device-flow).

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

[Shop MCP quickstart\
\
](https://shop.dev/docs/quickstart)

[Call the tools from your app or backend, starting with a search that needs no account or API key.](https://shop.dev/docs/quickstart)

[Connect an agent\
\
](https://shop.dev/docs/connect)

[Add Shop MCP to an MCP client, such as Claude, ChatGPT, or your own agent.](https://shop.dev/docs/connect)

## Terminal: Install the Shop CLI and skill

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

## Terminal: Search without an account

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

***

## What 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](https://shop.dev/docs/tools).

| Capability and tools | Without Shop sign-in | With Shop sign-in |
| - | - | - |
| Search products - `search_catalog`
- `lookup_catalog`
- `get_product` | Search and view products | Search and view products using saved preferences |
| Find physical stores - `search_locations`
- `lookup_locations` | Find merchant locations | Find merchant locations |
| Build carts - `create_cart`
- `get_cart`
- `update_cart` | Create and update carts | Create and update carts |
| Create checkouts - `create_checkout`
- `get_checkout`
- `update_checkout` | Create and update checkouts | Create and update checkouts using saved addresses for delivery |
| Finish a purchase - `complete_checkout` | Buyer reviews and pays on the merchant's checkout page | Agent completes checkout after buyer confirmation and payment selection |
| Access account details - `get_account` | Requires sign-in | Read saved addresses, payment methods, and spend permissions |
| Pay at non-Shopify stores - `create_spend_request`
- Other spend request tools | Requires sign-in | Request a single-purchase card, approved by the buyer in Shop |
| Track orders - `search_orders` | Requires sign-in | Search 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](https://shopify.dev/docs/agents/catalog/promoted-placement). For every tool and its arguments, refer to the [Shop MCP tool reference](https://shop.dev/docs/tools).

Use Shop MCP by default. For exceptions and other options, refer to [Choose your path](https://shopify.dev/docs/agents#choose-your-path).

***

## How buyers pay

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](https://www.shopify.com/protect).

Read [About Shop Pay](https://shopify.dev/docs/agents/carts-and-checkout/shop-pay) to learn more.

***
