# Shopify Catalog

The world’s products, in one index

Search billions of products from millions of brands in one call, with current price, inventory and checkout links.

Page: https://www.shopify.com/catalog

MCP endpoint: https://mcp.shop.com

## Install

```sh
npm install --global @shopify/shop@latest
```

No key needed. Install the Shop CLI, then run `shop search` in your terminal.

## One API, three calls

### Search (`search_catalog`)

Find products by keyword, image or both. Filter by price, rating, color, gender, shipping and more.

```sh
shop search 'oak chair' --price-max 25000 --currency USD --ships-to US
```

### Get product (`get_product`)

Get one product’s description, options, images and ratings, plus the price at each store that sells it.

```sh
shop catalog get '<product-id>' --select 'Color=Natural oak' \
    --country US --currency USD
```

### Look up (`lookup_catalog`)

Turn up to 50 product IDs or Shopify store links to look up current price, inventory, images and a checkout link.

```sh
shop catalog lookup '<link>' '<link>' --ships-to US --currency USD
```

## Create a Catalog API key

In the Dev Dashboard, open Agents and create an API key to make requests to https://catalog.shopify.com/api/ucp/mcp from your own app. This key grants the higher rate limits required for production experiences.

[Open Dev Dashboard](https://dev.shopify.com/dashboard)

Use your key to get an access token, then send it with every call.

[Authentication guide](https://shopify.dev/docs/agents/get-started/authentication)

## Can I keep a copy of the results?

No. Do not cache results or re-host merchant images. Request fresh data when you need it and show images from the URLs in the response. For tests, use made-up data.

## Links

[Go to shop.dev](https://shop.dev)

[Catalog documentation](https://shopify.dev/docs/agents/catalog)

[Shop CLI](https://shop.dev/docs/cli)