Shopify

$ curl -s https://shopify.dev/docs/agents.md | sed -n 1,14p
---
title: Agentic commerce
description: >-
  Build AI agents that authenticate with Shopify, search the Catalog, build
  carts and checkouts, and monitor orders using the Universal Commerce Protocol
  (UCP).
source_url:
  html: 'https://shopify.dev/docs/agents'
  md: 'https://shopify.dev/docs/agents.md'
---

# Build commerce agents with UCP

Build unified agentic experiences that securely act on behalf of buyers with the [Universal Commerce Protocol (UCP)](https://ucp.dev) and Shopify's UCP-compliant MCP servers.

$ curl -sL https://www.shopify.com/llms.txt | head -4
# Shopify

> [Shopify](https://www.shopify.com/about) is the leading commerce platform for starting, running, and growing a business. Millions of businesses started here, selling online, in person, on marketplaces, through social, and now in AI chats. Yours can too.

$ curl -si -X POST https://catalog.shopify.com/api/ucp/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'  # full [redacted]less handshake
HTTP/2 200

x-shopify-ucp-mcp-api-version: 2026-08-25

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true},"prompts":{"listChanged":true},"resources":{"listChanged":true},"logging":{}},"serverInfo":{"name":"universal-ucp-mcp","version":"0.1.0"}}}

$ mktemp -d && npm install @shopify/ucp-cli && ucp --version && ucp --help
\
added 11 packages in 291ms
\ucp version: 0.8.0
ucp@0.8.0 — Reference CLI + MCP server for the Universal Commerce Protocol

Usage: ucp <command>

Commands:
  cart      Build a shoppable cart with line items and cost estimates
  catalog   Search for products, enumerate variants and options, check availability
  checkout  Complete a purchase, pick fulfillment options, confirm payment
  discover  See what operations a business supports before calling them
  doctor    Verify your install is healthy and businesses are reachable
  order     Check the status of an order after purchase
  profile   Profile management

$ curl -s -X POST https://hardware.shopify.com/api/ucp/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'  # merchant-storefront UCP endpoint
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true},"prompts":{"listChanged":true},"resources":{"listChanged":true},"logging":{}},"serverInfo":{"name":"universal-commerce","version":"0.1.0"}}}

$ ucp catalog search --business https://hardware.shopify.com --set /query='card reader' && ucp cart create --business https://hardware.shopify.com --set /line_items/0/item/id=<variant>  # real [redacted]less cart on Shopify's own store
variant: gid://shopify/ProductVariant/47695038775318
## result.id

gid://shopify/Cart/hWNGbdQaTFGWnKfq0SY49S7k?[redacted]=e6a18779ee98a90860ff4795ecd962eb
--
| ucp checkout create --business <business> --input '{"cart_id":"<cart_id>","line_items":[]}'                                                                                                                                                                                                                                                      | create checkout from this cart — substitute <cart_id> with result.id and <business> with the same business used for this cart; line_items is required and can be empty for cart conversion |
| ucp cart update --input-schema --business <business>                                                                                                                                                                                                                                                                                             | inspect the cart update schema before requesting shipping estimates — only send fulfillment fields the merchant advertises                                                                 |
| ucp cart update <cart_id> --business <business> --input '{"line_items":[{"id":"<line_item_id>","item":{"id":"<item_id>"},"quantity":<quantity>}],"fulfillment":{"methods":[{"type":"shipping","line_item_ids":["<line_item_id>"],"destinations":[{"address_country":"<country>","address_region":"<region>","postal_code":"<postal_code>"}]}]}}' | request cart-stage shipping estimates with request-shaped line_items; returned cart fulfillment/totals are estimates                                                                       |

$ npm install @shopify/ucp-cli && ucp profile init --name pa-probe && ucp catalog search --set /query='wireless headphones'  # [redacted]less live cross-merchant search
## ucp

| [redacted]     | Value      |
|---------|------------|
| version | 2026-08-25 |
| status  | success    |

## result

| title                                                                                                                                                                                              | price | currency | variant                                     | buy                                                                                                              |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|----------|---------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| Crusher® Evo                                                                                                                                                                                       | 21999 | USD      | gid://shopify/ProductVariant/44522482794553 | https://www.skullcandy.com/cart/44522482794553:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog        |
| OpenRun                                                                                                                                                                                            | 12995 | USD      | gid://shopify/ProductVariant/41378978267336 | https://shokz.com/cart/41378978267336:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog                 |
| MOMENTUM 4 Wireless                                                                                                                                                                                | 29995 | USD      | gid://shopify/ProductVariant/45464964333851 | https://us.sennheiser-hearing.com/cart/45464964333851:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog |
| Heavys H1H Headphones                                                                                                                                                                              | 23900 | USD      | gid://shopify/ProductVariant/40746106323018 | https://www.heavys.com/cart/40746106323018:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog            |
| Crusher® ANC 2                                                                                                                                                                                     | 23999 | USD      | gid://shopify/ProductVariant/43456297173049 | https://www.skullcandy.com/cart/43456297173049:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog        |
| SENNHEISER Momentum 4 Wireless Headphones - Bluetooth Headset for Crystal-Clear Calls with Adaptive Noise Cancellation, 60h Battery Life, Customizable Sound and Lightweight Folding Design, Black | 28105 | USD      | gid://shopify/ProductVariant/41090854060091 | https://saveoncells.com/cart/41090854060091:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog           |
| OpenMove                                                                                                                                                                                           | 7995  | USD      | gid://shopify/ProductVariant/32327111704663 | https://shokz.com/cart/32327111704663:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog                 |
| OpenSwim Pro                                                                                                                                                                                       | 22995 | USD      | gid://shopify/ProductVariant/48392486879416 | https://playmakersfit.com/cart/48392486879416:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog         |
| GO POP+ True Wireless Earbuds Black                                                                                                                                                                | 2499  | USD      | gid://shopify/ProductVariant/40349687251016 | https://www.jlab.com/cart/40349687251016:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog              |
| CozyBand Wireless Headphones                                                                                                                                                                       | 4500  | USD      | gid://shopify/ProductVariant/42111563366648 | https://www.cozyband.com/cart/42111563366648:1?_gsid=M2vHdJo4VZvP&utm_source=shopify&utm_medium=catalog          |

## cta.description

$ curl -s -X POST https://catalog.shopify.com/api/ucp/mcp -d '<tools/call search_catalog without agent profile>'  # documented profile gate answers with a structured error
{"jsonrpc":"2.0","id":3,"error":{"code":-32001,"message":"UCP discovery failed","data":{"code":"invalid_profile_url","content":"Unable to fetch agent profile: Missing profile uri"}}}