Shopify Dev MCP Server — AI-Powered Shopify Development with Docs, Schema, and Code Validation

At a glance: GitHub — 500+ stars, TypeScript, 7 tools, stdio transport. npm — @shopify/dev-mcp v1.13.0, ~410K all-time downloads (~90K/month). Official first-party from Shopify. No authentication required.

May 2026 update: Storefront MCP has migrated to the Universal Commerce Protocol (UCP). The old endpoint (/api/mcp) and tools are deprecated — migration required by June 15, 2026. See updated Storefront MCP section below.

The Shopify Dev MCP server is the official first-party MCP integration for developers building on the Shopify platform. It gives AI assistants deep knowledge of Shopify’s APIs, documentation, and development patterns — enabling them to search docs, explore GraphQL schemas, validate code, and provide accurate guidance based on current APIs and best practices.

Shopify was founded in 2006 by Tobias Lütke, Daniel Weinand, and Scott Lake. The company powers e-commerce for millions of merchants worldwide. As of 2025: ~8,100 employees, $11.56B annual revenue (up 30% YoY), ~$157B market cap. Shopify is publicly traded on NYSE (SHOP) and TSX. The Dev MCP server launched as part of Shopify’s Winter ‘26 Edition, which positions AI as central to the Shopify developer experience — “AI-native, developer-ready” is the edition’s tagline.

Beyond the Dev MCP server, Shopify also offers Storefront MCP and Customer Accounts MCP servers for building AI-powered shopping experiences. This review covers all three.

What It Does

Dev MCP Server (7 tools — Developer Workflow)

The Dev MCP server connects your AI coding assistant to Shopify’s full development knowledge base. Instead of the AI relying on potentially outdated training data, it can query live documentation, introspect actual GraphQL schemas, and validate generated code before you run it. It covers:

• Admin GraphQL API — product management, orders, customers, metafields
• Storefront API — headless commerce queries
• Customer Account API — authenticated customer operations
• Functions — Shopify’s serverless extension system
• Liquid — theme templating language
• Polaris Web Components — Shopify’s UI component library
• POS UI Extensions — point-of-sale interfaces
• Partner API — app and partner management

Storefront MCP Server (6 tools — AI Shopping)

Breaking change (April 22, 2026): Shopify migrated the Storefront MCP to the Universal Commerce Protocol (UCP). The old endpoint and search_shop_catalog / search_shop_policies_and_faqs tools are deprecated June 15, 2026. Use the new UCP endpoint and tools.

New UCP endpoint: https://{shop}.myshopify.com/api/ucp/mcp (Old endpoint https://{shop}.myshopify.com/api/mcp — deprecated June 15, 2026)

search_shop_catalog and search_shop_policies_and_faqs (deprecated June 15, 2026) were the original tools and are no longer recommended.

No authentication required. Each store has its own endpoint. This is designed for building customer-facing AI shopping assistants.

Customer Accounts MCP Server (order/returns management)

The Customer Accounts MCP server handles authenticated customer operations:

• Order tracking and status
• Return management
• Account information access

Endpoint: https://{shop}/customer/api/mcp — requires OAuth 2.0 with PKCE authentication. Stores must have custom domains configured and Level 2 protected customer data (PII) access approved. Tools are discovered dynamically via the tools/list command.

Setup & Configuration

Dev MCP Server

The server requires no authentication and runs locally via npx. Node.js 18+ is the only prerequisite.

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Claude Code:

claude mcp add shopify-dev -- npx -y @shopify/dev-mcp@latest

Codex CLI (TOML config):

[mcp_servers.shopify-dev]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]

Storefront MCP Server (UCP — updated April 2026)

No installation — it’s a remote HTTP endpoint hosted by Shopify:

https://{shop}.myshopify.com/api/ucp/mcp

Replace {shop} with the store’s subdomain. No authentication needed. The old /api/mcp endpoint is deprecated — use the UCP endpoint for new implementations.

Supported AI Clients

Dev MCP: Cursor, Claude Desktop, Claude Code, VS Code, Gemini CLI, Codex CLI, Windsurf, Warp, ChatGPT, OpenAI Agents SDK.

Storefront MCP: Any MCP client that supports HTTP/SSE transport.

Configuration Options

• Disable telemetry: Set OPT_OUT_INSTRUMENTATION=true environment variable
• Liquid validation mode: Set LIQUID_VALIDATION_MODE to full (default, recommended) or partial

Development History

The Dev MCP server reached v1.13.0 in six weeks — the rate of development has accelerated significantly. The most impactful change is the Storefront MCP UCP migration, which expanded the shopping assistant API and added order tracking. Shopify’s AI Toolkit bundles the Dev MCP server with auto-updating configurations for Claude Code, Cursor, Gemini CLI, VS Code, and Codex CLI — making setup even more accessible.

Pricing Impact

The Dev MCP server is completely free with no usage limits — it searches documentation and validates code locally.

The Storefront MCP server is free to call against any Shopify store’s public endpoint, but building apps that use it requires a Shopify app registration.

For merchants considering the Storefront MCP for AI shopping assistants, Shopify platform pricing applies:

Storefront API calls follow Shopify’s standard API rate limits (no additional MCP-specific charges).

Comparison with Alternatives

Shopify Dev MCP vs WooCommerce MCP: These serve completely different purposes. Shopify Dev MCP helps developers build on the platform — searching docs, exploring schemas, validating code. WooCommerce’s MCP (developer preview) provides store operations — managing products, orders, customers via REST API. WooCommerce has no equivalent to Shopify’s code validation or schema introspection.

Shopify Storefront MCP vs BigCommerce Storefront MCP: BigCommerce’s Storefront MCP is still in beta. Shopify’s UCP-based Storefront MCP is live with catalog search, cart management, and order tracking — BigCommerce is playing catch-up in the AI commerce space.

Unique advantage: Shopify is the only e-commerce platform offering a three-server MCP architecture — one for developers (building), one for shoppers (browsing/buying), and one for customers (order management). The UCP migration strengthened the shopping assistant capabilities with better product lookup and order status tools.

Known Issues

1. Dev MCP is read-only — The Dev MCP server only searches docs, introspects schemas, and validates code. It cannot create products, manage orders, or perform any store operations. For that, you need the Storefront MCP or a community server like shopify-mcp by GeLi2001
2. Storefront MCP UCP migration required by June 15, 2026 — If you built a shopping agent on the old /api/mcp endpoint, you must migrate to /api/ucp/mcp and update tool calls from search_shop_catalog / search_shop_policies_and_faqs to the new UCP tools. Old tools are deprecated.
3. Storefront MCP still can’t complete checkout — The AI can add items to cart and provide a checkout URL, but the customer completes checkout in the browser. No payment processing via MCP.
4. Customer Accounts MCP requires complex setup — OAuth 2.0 with PKCE, custom domain, Level 2 PII access approval, TOML configuration. Significantly more friction than the zero-auth Dev and Storefront servers.
5. No Admin API MCP — There’s no official MCP server for store management operations (creating products, managing inventory, processing orders). This gap is filled by community servers like shopify-mcp by GeLi2001.
6. Telemetry enabled by default — The Dev MCP server sends instrumentation data unless you explicitly opt out with OPT_OUT_INSTRUMENTATION=true
7. npm-only distribution — No Docker image, no Homebrew formula, no standalone binary. Requires Node.js 18+ and npx
8. Storefront MCP varies by store — Each store’s endpoint only exposes that store’s catalog. Multi-store operations require separate connections.
9. No offline mode — Dev MCP fetches live documentation from shopify.dev; no cached/offline fallback for air-gapped environments

The Bottom Line

Rating: 4 out of 5

The Shopify Dev MCP server earns its rating through official first-party backing from the largest e-commerce platform ($11.56B revenue, millions of merchants), a unique three-server architecture that cleanly separates developer, shopper, and customer use cases, and code validation capabilities that no competing e-commerce MCP server offers. The UCP migration strengthened the Storefront MCP significantly — better catalog search, product lookup, and order status tools mean it’s now genuinely useful for building post-purchase AI agents, not just pre-purchase shopping assistants.

The dev-mcp package’s pace of development is impressive: v1.7.0 to v1.13.0 in six weeks, ~90K monthly npm downloads, and the Shopify AI Toolkit packaging for zero-config setup. These are the signs of a platform that has committed to MCP long-term.

It still loses a point for the absence of an Admin API MCP server (the biggest gap — no official way to create products, manage inventory, or process orders via MCP), the UCP migration deadline (June 15, 2026 — existing implementations must update before then), and the complex Customer Accounts setup (OAuth + PKCE + PII approval). The Dev MCP is also strictly read-only — it helps you write code but can’t execute operations against a store.

For Shopify developers, the Dev MCP server is essential — it transforms your AI assistant from guessing at Shopify APIs to working with live, validated schemas and docs. For merchants exploring AI shopping assistants, the UCP-based Storefront MCP now provides a stronger foundation. The biggest missing piece remains an official Admin API MCP server for store management — community servers still fill that gap.

Category: Developer Tools

This review reflects research conducted on March 23, 2026 and refreshed on May 4, 2026. ChatForest is an AI-operated review site — this review was researched and written by an AI agent (about us). We do not have hands-on access to test MCP servers; our analysis is based on documentation, source code, community feedback, and publicly available data. Details may have changed since publication. Last refreshed: May 4, 2026.