Agent skill

Shopify AI Toolkit Wrapper

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search.

MITAuto-check passedBackend & APIs

Install Shopify AI Toolkit Wrapper

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-ai-toolkit-wrapper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace shopify-ai-toolkit-wrapper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/shopify-ai-toolkit-wrapper .claude/skills/shopify-ai-toolkit-wrapper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shopify-ai-toolkit-wrapper
GitHub stars
2.8k
Token cost
~1.5k tokens
SKILL.md length
539 words
Files
4 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search.

  • Works in 4 steps: MCP Configuration → GraphQL Schema Validation → Liquid Template Linting → …
  • Setting up Shopify MCP integration
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Calls npx; needs SHOPIFY_ACCESS_TOKEN

What it does

Shopify AI Toolkit Wrapper is an agent skill from jeremylongshore/tons-of-skills-marketplace. Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search. Use when setting up Shopify MCP integration, validating GraphQL queries, or linting Liquid templates. Trigger with phrases like "shopify ai toolkit", "shopify mcp", "shopify claude integration", "shopify graphql validation", "shopify liquid lint".

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/graphql-validation.md`, `references/mcp-config.md` and `references/workflow-integration.md`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering GraphQL, MCP servers and Linting and formatting. It works with Shopify, Model Context Protocol and GraphQL. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Setting up Shopify MCP integration
  • Validating GraphQL queries
  • Linting Liquid templates
  • With phrases like shopify ai toolkit

Example prompts

  • “shopify ai toolkit”
  • “shopify mcp”
  • “shopify claude integration”
  • “/shopify-ai-toolkit-wrapper”

Requirements

  • Node.js
  • A credential in SHOPIFY_ACCESS_TOKEN
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(npm:*), Grep

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. MCP Configuration
  2. GraphQL Schema Validation
  3. Liquid Template Linting
  4. Documentation Search

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(npm:*)
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • shopify.dev
    • modelcontextprotocol.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SHOPIFY_ACCESS_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Shopify AI Toolkit Wrapper loads about 1.5k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 100 tokens; SKILL.md has 539 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 539 words, ~1,503 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-ai-toolkit-wrapper/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
shopify-ai-toolkit-wrapper
description
Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search. Use when setting up Shopify MCP integration, validating GraphQL queries, or linting Liquid templates. Trigger with phrases like "shopify ai toolkit", "shopify mcp", "shopify claude integration", "shopify graphql validation", "shopify liquid lint".
allowed-tools
Read, Write, Edit, Bash(npm:*), Grep
compatibility
Designed for Claude Code
version
2.7.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, ecommerce, shopify

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: read_products, read_themes)
  • Claude Code with MCP support enabled

Instructions

Step 1: MCP Configuration

Create or update .mcp.json in your project root:

json
{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "-y",
        "@shopify/ai-toolkit-mcp"
      ],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "${SHOPIFY_ACCESS_TOKEN}",
        "SHOPIFY_STORE_URL": "https://your-store.myshopify.com"
      }
    }
  }
}

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:

bash
export SHOPIFY_ACCESS_TOKEN="shpat_xxxxxxxxxxxxxxxxxxxx"
export SHOPIFY_STORE_URL="https://your-store.myshopify.com"

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:

IssueBadFix
Deprecated filterimg_url: '800x'image_url: width: 800
Scope leak{% include 'card' %}{% render 'card', product: product %}
Unbounded loopcollections.all.productsAdd limit: 50 or use paginate

Query Shopify's official documentation through the MCP server for up-to-date API information:

# Example MCP queries you can make:
# - "What fields are available on the Product object?"
# - "Show me the companyCreate mutation input shape"
# - "What scopes do I need for B2B operations?"
# - "What changed in the 2024-10 API version?"

This is especially useful for checking API version changes and deprecated fields without leaving your editor.

See references/workflow-integration.md for combining MCP tools with other shopify-pack skills.

Output

  • MCP server configured and connected to your Shopify store
  • GraphQL queries validated against live schema before execution
  • Liquid templates linted for deprecated filters and anti-patterns
  • Real-time documentation search available in Claude Code
Show full SKILL.md (238 more words)Show less

Error Handling

ErrorCauseSolution
MCP connection refusedMCP server failed to startCheck Node.js version (18+), run npx @shopify/ai-toolkit-mcp manually to see errors
Invalid access tokenToken expired or wrong formatRegenerate token in Shopify admin (Settings > Apps > Develop apps)
Schema introspection failedInsufficient API scopesAdd read_products and read_themes scopes to your app
Rate limited on doc queriesToo many documentation requestsSpace out queries; docs are cached after first fetch
ENOENT: .mcp.json not foundConfig file missing or wrong locationMust be in project root or ~/.claude/.mcp.json for global config
Package not foundMCP package name changedCheck shopify.dev/docs for the current official package name

Examples

Validating a GraphQL Mutation Before Execution

You need to call productCreate but aren't sure which input fields changed in the latest API version. Use the MCP server to validate your query against the live schema.

See GraphQL Validation for common validation errors and deprecated field mappings.

Setting Up MCP for a Team Project

Configure the Shopify MCP server at project, user, and global levels so the entire team gets schema validation automatically.

See MCP Config for advanced configuration and troubleshooting.

Combining MCP Validation with Other Shopify Skills

Chain MCP schema validation before running mutations from other shopify-pack skills like B2B or checkout extensions.

See Workflow Integration for the combined workflow patterns.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/.curated/shopify-ai-toolkit-wrapper of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/graphql-validation.md
  • references/mcp-config.md
  • references/workflow-integration.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Shopify AI Toolkit Wrapper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shopify AI Toolkit Wrapper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify AI Toolkit Wrapper this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.5kAutomated safety check: PassMIT
Shopifyasgeirtj/system_prompts_leaks69k—~2kAutomated safety check: PassCC0-1.0
QA Find Bugs MCPbex-co/beancount-io297—~3.1kAutomated safety check: PassMIT
MondayLeoYeAI/openclaw-master-skills2.2k—~4.3kAutomated safety check: PassMIT
Build Error AdapterArcadeAI/arcade-mcp1k—~2kAutomated safety check: PassMIT
SpikardGoldziher/spikard124—~799Automated safety check: PassMIT

Similar skills

  • Shopify

    asgeirtj/system_prompts_leaks

    Set up and operate a Shopify store with Shopify's official MCP server (the installed shopify command, NOT the npm Shopify CLI).

    69k GitHub stars~2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • QA Find Bugs MCP

    bex-co/beancount-io

    Hunt bugs in the Beancount.io remote MCP server by driving the real POST /api-gateway/mcp endpoint with JSON-RPC and real MCP clients, checking transport, discovery, credential boundaries, tool and…

    297 GitHub stars~3.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Monday

    LeoYeAI/openclaw-master-skills

    Manage monday.com boards, items, columns, groups, updates, and workflows via MCP server (preferred) and GraphQL API (fallback).

    2.2k GitHub stars~4.3k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Build Error Adapter

    ArcadeAI/arcade-mcp

    Build new Arcade error adapters from scratch using public Arcade TDK patterns.

    1k GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Spikard

    Goldziher/spikard

    Scaffold Spikard projects and generate code from OpenAPI, AsyncAPI, OpenRPC, GraphQL, and Protobuf schemas using the Spikard CLI or its MCP server.

    124 GitHub stars~799 tokensUpdated today
    Backend & APIsAuto-check passed
  • Thegraph MCP Skill

    holon-run/uxc

    Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first…

    116 GitHub stars~1.1k tokensUpdated 26 days ago
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Shopify AI Toolkit Wrapper

What does Shopify AI Toolkit Wrapper do?

Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search. Shopify AI Toolkit Wrapper is an agent skill from jeremylongshore/tons-of-skills-marketplace. Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search.

When should I use Shopify AI Toolkit Wrapper?

Shopify AI Toolkit Wrapper fits situations like: setting up Shopify MCP integration; validating GraphQL queries; linting Liquid templates; with phrases like shopify ai toolkit.

How do I install Shopify AI Toolkit Wrapper in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-ai-toolkit-wrapper -a claude-code`. Or copy the skill folder (skills/.curated/shopify-ai-toolkit-wrapper in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/shopify-ai-toolkit-wrapper in your project. Claude Code loads it when a task matches its description.

How do I install Shopify AI Toolkit Wrapper in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-ai-toolkit-wrapper -a codex`. Or copy the skill folder (skills/.curated/shopify-ai-toolkit-wrapper in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/shopify-ai-toolkit-wrapper in your project. Codex loads it when a task matches its description.

Can I use Shopify AI Toolkit Wrapper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-ai-toolkit-wrapper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shopify-ai-toolkit-wrapper, .gemini/skills/shopify-ai-toolkit-wrapper, .github/skills/shopify-ai-toolkit-wrapper and .opencode/skills/shopify-ai-toolkit-wrapper in your project.

What does Shopify AI Toolkit Wrapper need to run?

Going by SKILL.md and its folder, Shopify AI Toolkit Wrapper needs the command-line tools its instructions call (npx) and credentials named SHOPIFY_ACCESS_TOKEN. Our summary lists: Node.js; A credential in SHOPIFY_ACCESS_TOKEN. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(npm:*), Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Shopify AI Toolkit Wrapper access the network?

SKILL.md names 2 domains. As links in the text: shopify.dev and modelcontextprotocol.io. This is read from the text; nothing was executed.

Is Shopify AI Toolkit Wrapper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shopify AI Toolkit Wrapper use?

Shopify AI Toolkit Wrapper is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shopify AI Toolkit Wrapper use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Shopify AI Toolkit Wrapper?

Skills that share tags, products or a category with Shopify AI Toolkit Wrapper: Shopify (asgeirtj/system_prompts_leaks, 69k stars), QA Find Bugs MCP (bex-co/beancount-io, 297 stars), Monday (LeoYeAI/openclaw-master-skills, 2.2k stars) and Build Error Adapter (ArcadeAI/arcade-mcp, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify AI Toolkit Wrapper?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.