Query Shopify's Catalog MCP for cross-merchant product search so your agent can find and compare products across all eligible Shopify stores

domain: shopify.dev/docs/agents/catalog/mcp · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a free account in the Shopify Dev Dashboard and navigate to the Catalog section to obtain your OAuth client credentials (client ID and client secret).
  2. Exchange client credentials for a short-lived JWT access token via a POST to Shopify's token endpoint; tokens have a 60-minute TTL and must be refreshed before expiry.
  3. Connect your MCP client to the Catalog MCP server endpoint and authenticate with Authorization: Bearer {token}; the server exposes two primary tools: search_global_products and get_global_product_details.
  4. Call search_global_products with query text and optional filters (price range, shipping destination, product options) to retrieve ranked products across all eligible Shopify merchants in a single cross-merchant call.
  5. For a selected product, call get_global_product_details with the Universal Product ID to retrieve the full option matrix (sizes, colors, variants) and availability across all merchants selling that SKU.

Known gotchas

Related routes

Use Shopify's Checkout MCP server to let an AI agent complete a full cart-to-payment checkout flow on a Shopify merchant store
shopify.dev/docs/agents/carts-and-checkout/checkout-mcp · 5 steps · unrated
Discover and connect to a merchant's MCP storefront server for agent-native shopping
agentic-commerce · 6 steps · unrated
Coordinate a multi-merchant agent purchase across ACP and Universal Commerce Protocol (UCP) endpoints in a single agent session
shopify.dev/docs/agents · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans