Agent skill · software engineering · jeremylongshore
shopify-ai-toolkit-wrapper
Integrate Shopify''s AI Toolkit MCP server with Claude Code for GraphQL
Why this skill is useful
Adds executable scripts for configuring Shopify's AI Toolkit MCP server, validating GraphQL queries, and linting Liquid templates that aren't in public docs.
What it needs
Requires node, npm installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify AI Toolkit Wrapper Overview Shopify's AI Toolkit provides an official MCP (Model Context Protocol) server for developer workflows. This skill configures it for Claude Code, enabling GraphQL schema validation, Liquid template linting, and real-time Shopify documentation search without leaving your editor. Prerequisites Node.js 18+ and npm/pnpm installed A Shopify store with a custom app or API access token Access scopes appropriate for your workflow (minimum: readproducts, readthemes) Claude Code with MCP support enabled Instructions Step 1: MCP Configuration Create or update .mcp.json in your project root: Note: The package name @shopify/ai-toolkit-mcp may change. Check shopify.dev/docs for the latest official MCP package name and configuration. Set your environment variables: See references/mcp-config.md for advanced configuration and troubleshooting. Step 2: GraphQL Schema Validation With the MCP server running, validate GraphQL queries against your store's live schema before executing them. The MCP introspects the schema and catches: Deprecated fields (e.g., priceRange should be priceRangeV2) Type mismatches in mutation inputs (e.g., ProductInput split into ProductCreateInput/ProductUpdateInput in 2024-10) Missing required fields and incorrect enum values See references/graphql-validation.md for common validation errors and deprecated field mappings. Step 3: Liquid Template Linting The AI Toolkit checks Liquid templates for syntax errors, deprecated filters, and performance anti-patterns: Issue Bad Fix ------- ----- ----- Deprecated filter imgurl: '800x' imageurl: width: 800 Scope leak {% include 'card' %} {% render 'card', product: product %} Unbounded loop collections.all.products Add limit: 50 or use paginate Step 4: Documentation Search Query Shopify's official documentation through the MCP server for up-to-date API information: This is especially useful for checking API version changes and deprecated fields without leaving your editor. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-ai-toolkit-wrapper