Shopify’s latest developer release, “Add shopping and Shop Pay checkout to any agent with Shop MCP,” dramatically expands what agents and AI‑driven tools can do for shoppers. By exposing catalog search, cart building, and checkout—including Shop Pay payments—through a single MCP connection, developers can keep shoppers inside the conversational flow, reducing friction and cart abandonment.
What is Shop MCP?
Shop MCP (Marketplace Connect Protocol) is a lightweight, credential‑free API that sits at https://mcp.shop.com. It provides 17 ready‑made “tools” that agents can call to interact with Shopify’s catalog, shopper identities, carts, checkout, and order data. The service works with over 1 billion products and requires no API key for basic search, although keys can be generated for higher rate limits.
New Capabilities Delivered
Shop MCP groups its functionality into a few core flows:
• Search & product details – search_catalog, lookup_catalog, and get_product let your agent pull product titles, prices, stock, and images straight from the global catalog.
• Sign‑in with Shop – shoppers sign in once; subsequent calls automatically respect saved sizes, preferences, and addresses.
• Carts & checkout on Shopify stores – build a cart, create a checkout, and finalize the purchase with complete_checkout. The flow works with or without a signed‑in shopper, but a signed‑in shopper unlocks saved addresses and Shop Pay.
• Checkout on non‑Shopify stores – for external merchants, the shopper authorizes the purchase in Shopify, and the agent receives a single‑use card token to complete the transaction on the retailer’s own checkout page.
• Orders – search_orders lets agents fetch a shopper’s order history and tracking information, enabling post‑purchase support directly inside the conversation.
Who Is Affected?
The update is aimed at developers building MCP‑compatible agents, bots, or custom storefronts. If you already use the Catalog API directly, nothing changes—your existing integration continues to work unchanged. Merchants don’t need to take any action, but they will see orders placed through agents appear in their Shopify admin just like any other order.
Why This Matters for Merchants and Developers
Previously, agents could surface product info but had to hand shoppers off to the merchant’s website for payment, a step that often caused drop‑off. With Shop MCP, a signed‑in shopper can complete the purchase using their stored Shop Pay credentials without ever leaving the agent’s UI. The result is a smoother, faster checkout that leverages Shopify’s fraud‑protected payment flow, increasing conversion rates and giving developers a richer set of tools to build truly end‑to‑end shopping experiences.
How to Get Started
npm install -g @shopify/shop
shop search "ceramic coffee dripper"
The CLI returns JSON with store name, price, stock status, and image URLs—exactly what your agent will receive via the MCP endpoint.
// Search product
product = await mcp.call('search_catalog', {query:'leather tote'});
// Create cart
cart = await mcp.call('create_cart', {items:[{product_id:product.id, quantity:1}]});
// Create checkout (Shopify store)
checkout = await mcp.call('create_checkout', {cart_id:cart.id});
// If shopper is signed‑in, complete with Shop Pay
result = await mcp.call('complete_checkout', {checkout_id:checkout.id, payment_method:'shop_pay'});
Testing Tips & Gotchas
• No webhooks are available at launch, so poll get_checkout (or get_order) to monitor status changes. A simple exponential back‑off loop works well.
• Checkout on non‑Shopify stores returns a single‑use card token. Your agent must handle the token securely and never log the raw card details.
• If you encounter “rate limit exceeded” errors during development, create an API key as mentioned above or stagger your calls with a short delay.
Conclusion & Next Steps
Shop MCP transforms agents from mere product recommenders into full‑funnel shopping experiences. By leveraging the new search, cart, and Shop Pay checkout tools, developers can deliver frictionless purchases while merchants enjoy the same order management workflow they already trust. Start experimenting today with the “shop” CLI, point your agent at the skill markdown, and run an end‑to‑end test purchase. When you’re ready, roll the capability out to live shoppers and watch conversion rates climb.
Ready to bring checkout into your AI assistant or custom storefront? Dive into the Shop MCP overview, generate an API key, and let your shoppers buy without ever leaving the conversation.
