Shopify MCP Server

Enables AI assistants to query Shopify's official developer documentation through a search_dev_docs tool that integrates with the MCP protocol. The tool accepts natural language queries and returns relevant documentation snippets, guides, and API references from Shopify's knowledge base. This is implemented as a registered MCP tool that the server exposes via stdio transport, allowing clients like Claude Desktop and Cursor to invoke documentation lookups without direct API calls.

Provides the introspect_admin_schema tool that allows AI assistants to explore and understand the Shopify Admin GraphQL schema structure, including available types, fields, mutations, and queries. The server bundles the GraphQL schema as static data files (included in the npm package) and exposes introspection capabilities through MCP, enabling clients to query schema metadata without making direct calls to Shopify's introspection endpoint. This supports schema-aware code generation and helps developers understand API capabilities before writing queries.

Provides the shopify_admin_graphql prompt that delivers specialized instructions to AI language models for generating accurate GraphQL queries and mutations against the Shopify Admin API. This prompt is registered with the MCP server and delivered to clients, helping AI assistants understand Shopify-specific GraphQL patterns, naming conventions, required fields, and best practices. The prompt acts as a system-level instruction that improves the quality and correctness of AI-generated GraphQL operations without requiring developers to manually craft detailed prompts.

Implements a fully functional Model Context Protocol (MCP) server using the MCP SDK's McpServer class and StdioServerTransport, enabling bidirectional communication between AI clients (Claude Desktop, Cursor) and Shopify-specific tools and prompts. The server handles MCP protocol handshakes, tool registration, prompt registration, and message routing over standard input/output. This architecture allows any MCP-compatible client to discover and invoke Shopify tools without custom integration code.

Packages the Shopify Admin GraphQL schema as static data files within the npm package (@shopify/dev-mcp), eliminating the need for runtime schema downloads or live introspection calls. The schema is compiled and bundled during the package build process, allowing the server to serve schema metadata instantly without network dependencies. This approach enables offline schema exploration and reduces latency for schema-based operations.

Provides standardized configuration templates and setup instructions for integrating the Shopify MCP server with popular AI development clients (Cursor and Claude Desktop). The server includes platform-specific configuration examples (including Windows-specific alternatives) that clients use to discover and launch the MCP server process. This enables developers to add Shopify tools to their AI assistant with minimal configuration effort.

Distributes the Shopify MCP server as a published npm package (@shopify/dev-mcp) that can be installed globally or executed directly via npx without installation. The package includes compiled JavaScript, bundled schema data, and a CLI entry point that launches the MCP server listening on stdio. This distribution model enables zero-friction adoption — developers can run the server immediately with a single command.

The Shopify MCP Server is a middleware solution designed for e-commerce developers, enabling seamless integration with Shopify APIs and enhancing the development experience through specialized tools and prompts.