tailorkit

TailorKit MCP exposes a set of AI-assisted tools that let Claude and other assistants manage TailorKit templates and their layers directly through natural language. The available tools include get_list_templates to retrieve templates for a given Shopify shop, get_detail_template to fetch detailed information about a specific template (including its layers and settings), create_template to create new templates for a shop, and get_list_layers_of_template to list all layers within a template. To use these in your conversations, configure the MCP server in your Claude Desktop or preferred client and call the tools with the required inputs (shopDomain, _id, etc.). The server handles authorization via an ACCESS_TOKEN and connects to TailorKit’s API using the HOST you provide, enabling a seamless, chat-based workflow for template creation, modification, and retrieval. You can also follow the provided example to wire the MCP into Claude Desktop by editing claude_desktop_config.json with your server’s command, arguments, and environment variables.

Prerequisites:

• Node.js and npm installed on your machine
• Git installed
• Access to the TailorKit MCP package (see installation options below)

1. Install from npm

• Run:

npm install @sellersmith/tailorkit-mcp

• After installation, build if required by the package (check repository for build step). The typical flow is to run the build to produce dist/index.js.

2. Install from GitHub (source)

• Clone the repository and install dependencies:

git clone https://github.com/sellersmith/tailorkit-mcp.git
cd tailorkit-mcp
npm install

• Build the project to generate the distributable files:

npm run build

• Run the server locally (assuming build outputs to dist/index.js):

node dist/index.js

3. Run-time configuration

• Ensure you have a HOST URL for the TailorKit API and a valid ACCESS_TOKEN. Then start the server with the proper environment variables as shown in the mcp_config example.

Environment variables:

• HOST: Required. The base URL of your TailorKit API.
• ACCESS_TOKEN: Required. Your TailorKit API access token.

Tips:

• Use the provided example claude_desktop_config.json snippet to wire the MCP into Claude Desktop for a smooth workflow.
• The tools support pagination and filtering; adjust limit, page, sort, and filter to navigate large template sets.
• If you encounter authentication errors, verify that ACCESS_TOKEN is valid and not expired, and that HOST points to the correct TailorKit API endpoint.
• When creating templates, you can optionally supply a custom _id and an initial layers array to bootstrap the template configuration.
• Ensure the server has network access to the TailorKit API and that any CORS or firewall rules permit the required traffic.