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).
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.
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.
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.
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
Catalog MCP was select-partner-only through Summer '25 Edition and opened to all developers in Winter '26 Edition; if you enrolled earlier, verify your credentials still work with the generally available endpoint.
search_global_products results are limited to merchants who have opted into Shopify's Agentic Storefronts (US merchants activated by default March 24, 2026); merchants who opted out will not appear.
The Dev Dashboard client credentials used for Catalog MCP are separate from Shopify Partner API credentials and from Storefront API tokens; do not reuse credentials across these authentication systems.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp