---
title: Shop MCP
description: Search millions of products from Shop.app directly inside your agent
source_url:
  html: https://shopify.dev/docs/apps/build/shop-mcp
  md: https://shopify.dev/docs/apps/build/shop-mcp.md
---

# Shop MCP

Shop MCP is a remote Model Context Protocol (MCP) server that gives your agent access to [Shop.app](https://shop.app) product catalog. Ask your agent to find products, and it returns live results with images, prices, ratings, and purchase links.

***

## What you can do

After you connect Shop MCP, you can ask your agent to find products, browse categories, or search by activity. For example:

* "Find me a gift for a coffee lover"
* "Show me some candles"
* "I need new running shoes"
* "What yoga mats does Shop have?"

Your agent searches Shop.app and returns products with images, prices, shop names, star ratings, and links to purchase directly on Shop.app.

***

## Tools

### `search`

Searches for products on Shop.app.

#### Input

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | string | Yes | Natural language product search query |

#### Output

The `search` tool returns a response containing up to 30 products.

Each product includes the following fields:

| Field | Type | Description |
| - | - | - |
| `id` | string | Product ID |
| `title` | string | Product title |
| `price` | object | Current price as `{amount, currencyCode}` |
| `originalPrice` | object | Original price as `{amount, currencyCode}`, if discounted (may be absent) |
| `url` | string | Direct link to the merchant's product page |
| `slug` | string | URL slug for the product |
| `images` | array | Product images, each with `url`, `width`, `height`, and `altText` |
| `shop.name` | string | Shop name |
| `shop.id` | string | Shop ID |
| `shop.shopifyId` | string | Shopify shop ID |
| `reviewAnalytics.averageRating` | number | Average review rating (may be absent) |

Pagination is not supported. Each request returns a single set of results.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `openWorldHint: false`

***

## How it works

1. Your agent sends your product search prompt to the `search` tool.
2. The tool returns structured product data that your agent can present to you, with each product linking directly to the merchant's product page.

***

## Set up

MCP setup instructions vary depending on your agent provider. For example, to add Shop MCP in Claude Web:

1. Go to [claude.ai/customize/connectors](https://claude.ai/customize/connectors).
2. Click **Add custom connector**.
3. Label it **Shop** and enter the server URL: `https://shop.app/mcp`
4. Click **Add**.

***

## Privacy

The Shop MCP is subject to [Shop's privacy policy](https://shop.app/privacy).

***