@anton.andrusenko/shopify-mcp-admin 1.1.1 → 1.1.3

package/README.md

@@ -40,9 +40,25 @@ npx @anton.andrusenko/shopify-mcp-admin
 npm install -g @anton.andrusenko/shopify-mcp-admin
 ```
 
-### Configuration
+### Setup Wizard (Recommended)
 
-Set your environment variables:
+The easiest way to get started is with the interactive setup wizard:
+
+```bash
+npx @anton.andrusenko/shopify-mcp-admin init
+```
+
+The wizard will:
+1. **Prompt for your store URL** and validate the format
+2. **Choose authentication method** — Legacy token or OAuth 2.0
+3. **Test the connection** — Verifies credentials before saving
+4. **Select your AI client** — Claude Desktop, Cursor, Windsurf, VS Code, LibreChat, or OpenAI
+5. **Configure tool loading** — All tools, role preset, or lazy loading
+6. **Generate and save config** — Creates the appropriate config file for your client
+
+### Manual Configuration
+
+Alternatively, set environment variables directly:
 
 ```bash
 export SHOPIFY_STORE_URL=your-store.myshopify.com
@@ -191,6 +207,198 @@ Quit and reopen Claude Desktop. You should see "shopify" in the MCP servers list
 
 ---
 
+## 💬 LibreChat Integration
+
+[LibreChat](https://www.librechat.ai/) is an open-source AI chat interface that supports MCP servers natively. This section provides a complete guide to set up LibreChat with the Shopify MCP server.
+
+### Prerequisites
+
+- **Docker Desktop** — [Download](https://www.docker.com/products/docker-desktop) and ensure it's running
+- **Git** — For cloning repositories
+- **LLM API Key** — OpenAI or Anthropic API key for the chat functionality
+
+### Quick Setup (Recommended)
+
+Use the included setup script for automated installation:
+
+```bash
+# Clone this repo (if you haven't already)
+git clone https://github.com/AntonAndrusenko/shopify-mcp-admin.git
+cd shopify-mcp-admin
+
+# Run the setup script
+./scripts/setup-librechat.sh
+```
+
+The script will:
+1. Check Docker is installed and running
+2. Clone LibreChat to `~/LibreChat`
+3. Prompt for your Shopify credentials (store URL, access token or OAuth)
+4. Create `librechat.yaml` with MCP server configuration
+5. Create `docker-compose.override.yml` to mount the config
+6. Pull Docker images and start all containers
+7. Verify the Shopify MCP server loads successfully
+
+**Script Options:**
+```bash
+# Install to a custom directory
+./scripts/setup-librechat.sh --install-dir /path/to/librechat
+
+# Use local development build instead of npm package
+./scripts/setup-librechat.sh --use-local
+
+# Show help
+./scripts/setup-librechat.sh --help
+```
+
+### Manual Setup
+
+<details>
+<summary>Click to expand manual installation steps</summary>
+
+#### Step 1: Clone and Configure LibreChat
+
+```bash
+# Clone LibreChat
+git clone https://github.com/danny-avila/LibreChat.git
+cd LibreChat
+
+# Create environment file
+cp .env.example .env
+```
+
+#### Step 2: Create MCP Server Configuration
+
+Create `librechat.yaml` in the LibreChat directory:
+
+```yaml
+version: 1.2.1
+
+mcpServers:
+  shopify:
+    type: stdio
+    command: npx
+    args:
+      - -y
+      - "@anton.andrusenko/shopify-mcp-admin"
+    env:
+      SHOPIFY_STORE_URL: "your-store.myshopify.com"
+      # Option 1: Access Token
+      SHOPIFY_ACCESS_TOKEN: "shpat_xxxxx"
+      # Option 2: OAuth (comment out ACCESS_TOKEN, uncomment these)
+      # SHOPIFY_CLIENT_ID: "your_client_id"
+      # SHOPIFY_CLIENT_SECRET: "your_client_secret"
+      LOG_LEVEL: "info"
+    serverInstructions: true
+    timeout: 30000
+    initTimeout: 15000
+```
+
+#### Step 3: Mount Configuration in Docker
+
+Create `docker-compose.override.yml`:
+
+```yaml
+services:
+  api:
+    volumes:
+      - type: bind
+        source: ./librechat.yaml
+        target: /app/librechat.yaml
+```
+
+#### Step 4: Start LibreChat
+
+```bash
+# Pull the latest images
+docker compose pull
+
+# Start all services
+docker compose up -d
+
+# Verify containers are running
+docker compose ps
+```
+
+#### Step 5: Verify MCP Server Loaded
+
+```bash
+# Check logs for MCP initialization
+docker compose logs api | grep -i "mcp"
+
+# You should see:
+# [MCP][shopify] Initialized in: XXXXms
+# MCP servers initialized successfully. Added 79 MCP tools.
+```
+
+</details>
+
+### After Installation: Enable MCP in LibreChat
+
+Once LibreChat is running, follow these steps to use the Shopify MCP server:
+
+#### 1. Create an Account
+- Open http://localhost:3080 in your browser
+- Click "Sign up" and create an account
+- Log in with your new credentials
+
+#### 2. Add an LLM API Key
+- Click your **profile avatar** (bottom-left)
+- Select **Settings**
+- Go to **User Provider Keys**
+- Add your API key:
+  - **OpenAI**: Paste your `sk-...` key
+  - **Anthropic**: Paste your `sk-ant-...` key
+- Click **Save**
+
+#### 3. Select the Shopify MCP Server
+- Start a **New Chat**
+- Look for the **MCP Servers** dropdown in the chat input area (shows a plug icon)
+- Click it and select **"shopify"**
+- You should see a "shopify" badge appear, indicating the MCP server is active
+
+#### 4. Test the Integration
+Try these prompts to verify everything works:
+
+```
+"What's my store name and what plan am I on?"
+"List my products"
+"Show me products with low inventory"
+```
+
+### Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| MCP server not appearing | Check logs: `docker compose logs api \| grep -i mcp` |
+| "shopify" badge not visible | Refresh the page, or restart: `docker compose restart` |
+| Tools not working | Verify Shopify credentials in `librechat.yaml` |
+| Docker won't start | Ensure Docker Desktop is running |
+| Permission denied on script | Run: `chmod +x ./scripts/setup-librechat.sh` |
+
+### Useful Commands
+
+```bash
+# View LibreChat logs
+cd ~/LibreChat && docker compose logs api -f
+
+# View only MCP-related logs
+cd ~/LibreChat && docker compose logs api | grep -i "mcp\|shopify"
+
+# Restart LibreChat (after config changes)
+cd ~/LibreChat && docker compose restart
+
+# Stop LibreChat
+cd ~/LibreChat && docker compose down
+
+# Update LibreChat
+cd ~/LibreChat && git pull && docker compose pull && docker compose up -d
+```
+
+> 📄 **Advanced Configuration:** See `librechat.yaml.example` for multi-store setups, role presets, and HTTP/SSE transport modes.
+
+---
+
 ## 🌐 OpenAI/ChatGPT Integration
 
 For OpenAI function calling or ChatGPT plugins, use HTTP transport mode.

package/dist/index.js

@@ -5675,7 +5675,7 @@ async function createMarket(input) {
     };
   }
   if (input.enabled !== void 0) {
-    graphqlInput.status = input.enabled ? "ACTIVE" : "INACTIVE";
+    graphqlInput.status = input.enabled ? "ACTIVE" : "DRAFT";
   }
   if (input.currencySettings) {
     const currencyInput = {};
@@ -5723,7 +5723,7 @@ async function updateMarket(marketId, input) {
     graphqlInput.handle = input.handle;
   }
   if (input.enabled !== void 0) {
-    graphqlInput.status = input.enabled ? "ACTIVE" : "INACTIVE";
+    graphqlInput.status = input.enabled ? "ACTIVE" : "DRAFT";
   }
   if (input.countryCodesToAdd && input.countryCodesToAdd.length > 0) {
     graphqlInput.conditions = graphqlInput.conditions || {};
@@ -5959,7 +5959,7 @@ var inputSchema6 = z8.object({
     'Array of ISO 3166-1 alpha-2 country codes to include in this market. Example: ["CA"] for Canada, ["FR", "DE", "IT"] for multiple European countries'
   ),
   enabled: z8.boolean().optional().default(false).describe(
-    "Whether the market should be enabled (status: ACTIVE). Default: false (creates market as INACTIVE/draft). Set to true only when ready to make the market live. \u26A0\uFE0F ACTIVE markets are immediately visible to customers in those regions."
+    "Whether the market should be enabled (status: ACTIVE). Default: false (creates market as DRAFT). Set to true only when ready to make the market live. \u26A0\uFE0F ACTIVE markets are immediately visible to customers in those regions."
   ),
   baseCurrency: z8.string().length(3).optional().describe(
     'Base currency code for the market (ISO 4217). Example: "USD", "EUR", "CAD", "GBP". If not set, uses store default currency.'
@@ -6006,7 +6006,7 @@ function registerCreateMarketTool() {
     {
       name: "create-market",
       title: "Create Market",
-      description: 'Create a new market for regional targeting. Markets group one or more regions (countries) for localized shopping experiences. Provide a name (required) and optionally: handle, country codes, currency settings, and enabled status. \u26A0\uFE0F **Note:** Markets are created as INACTIVE by default (enabled=false). Use update-market to activate when ready, or set enabled=true if you want it live immediately. **Currency:** Set baseCurrency (e.g., "CAD") and localCurrencies for multi-currency support. **Typical workflow:** create-market \u2192 create-web-presence (configure SEO URLs) \u2192 enable-shop-locale (add languages) \u2192 update-market (enable when ready). **Prerequisites:** None. Store must have Markets feature enabled on their plan. **Follow-ups:** get-market, update-market, create-web-presence.',
+      description: 'Create a new market for regional targeting. Markets group one or more regions (countries) for localized shopping experiences. Provide a name (required) and optionally: handle, country codes, currency settings, and enabled status. \u26A0\uFE0F **Note:** Markets are created as DRAFT by default (enabled=false). Use update-market to activate when ready, or set enabled=true if you want it live immediately. **Currency:** Set baseCurrency (e.g., "CAD") and localCurrencies for multi-currency support. **Typical workflow:** create-market \u2192 create-web-presence (configure SEO URLs) \u2192 enable-shop-locale (add languages) \u2192 update-market (enable when ready). **Prerequisites:** None. Store must have Markets feature enabled on their plan. **Follow-ups:** get-market, update-market, create-web-presence.',
       inputSchema: inputSchema6,
       outputSchema: outputSchema6,
       // AI Agent Optimization
@@ -9168,7 +9168,7 @@ var outputSchema22 = z24.object({
   name: z24.string().describe("Market name (not shown to customers)"),
   handle: z24.string().describe("URL handle"),
   enabled: z24.boolean().describe("Whether the market is enabled"),
-  status: z24.enum(["ACTIVE", "INACTIVE"]).describe("Market status"),
+  status: z24.enum(["ACTIVE", "DRAFT"]).describe("Market status"),
   type: z24.string().describe("Market type (PRIMARY, SINGLE_COUNTRY, MULTI_COUNTRY, CONTINENT)"),
   regions: z24.array(
     z24.object({
@@ -9831,7 +9831,7 @@ var outputSchema30 = z32.object({
       name: z32.string().describe("Market name (not shown to customers)"),
       handle: z32.string().describe("URL handle"),
       enabled: z32.boolean().describe("Whether the market is enabled"),
-      status: z32.enum(["ACTIVE", "INACTIVE"]).describe("Market status"),
+      status: z32.enum(["ACTIVE", "DRAFT"]).describe("Market status"),
       type: z32.string().describe("Market type (PRIMARY, SINGLE_COUNTRY, MULTI_COUNTRY, CONTINENT)"),
       regions: z32.array(
         z32.object({
@@ -14691,11 +14691,17 @@ function showHelp() {
 
 Usage:
   shopify-mcp-admin [options]
+  shopify-mcp-admin init     Interactive setup wizard
 
 Options:
   --help, -h       Show this help message
   --version, -v    Show version number
 
+Commands:
+  init, setup      Run the interactive setup wizard
+                   Configures credentials and generates config files
+                   for Claude Desktop, Cursor, LibreChat, etc.
+
 Environment Variables:
   SHOPIFY_STORE_URL       (required) Your Shopify store domain
   SHOPIFY_ACCESS_TOKEN    (required) Admin API access token
@@ -14704,7 +14710,8 @@ Environment Variables:
   DEBUG                   Enable debug logging (1 or true)
 
 Examples:
-  npx shopify-mcp-admin
+  npx shopify-mcp-admin init              # Setup wizard
+  npx shopify-mcp-admin                   # Start server (requires env vars)
   TRANSPORT=http PORT=3000 shopify-mcp-admin`);
   process.exit(0);
 }
@@ -14712,6 +14719,11 @@ function showVersion() {
   console.log(getPackageVersion());
   process.exit(0);
 }
+async function runSetup() {
+  const { runSetupWizard } = await import("./setup-wizard-PVLOC3DU.js");
+  await runSetupWizard();
+  process.exit(0);
+}
 var args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
   showHelp();
@@ -14719,6 +14731,12 @@ if (args.includes("--help") || args.includes("-h")) {
 if (args.includes("--version") || args.includes("-v")) {
   showVersion();
 }
+if (args.includes("init") || args.includes("setup") || args.includes("--setup")) {
+  runSetup().catch((error) => {
+    console.error("Setup failed:", error);
+    process.exit(1);
+  });
+}
 async function main() {
   try {
     const config = getConfig();

package/dist/setup-wizard-PVLOC3DU.js

@@ -0,0 +1,697 @@
+#!/usr/bin/env node
+
+// src/cli/setup-wizard.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { confirm, input, password, select } from "@inquirer/prompts";
+var colors = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  // Shopify-inspired colors
+  green: "\x1B[38;5;82m",
+  // Shopify green
+  darkGreen: "\x1B[38;5;34m",
+  cyan: "\x1B[38;5;87m",
+  yellow: "\x1B[38;5;226m",
+  red: "\x1B[38;5;196m",
+  magenta: "\x1B[38;5;207m",
+  blue: "\x1B[38;5;75m",
+  white: "\x1B[38;5;255m",
+  gray: "\x1B[38;5;245m"
+};
+var c = {
+  green: (s) => `${colors.green}${s}${colors.reset}`,
+  darkGreen: (s) => `${colors.darkGreen}${s}${colors.reset}`,
+  cyan: (s) => `${colors.cyan}${s}${colors.reset}`,
+  yellow: (s) => `${colors.yellow}${s}${colors.reset}`,
+  red: (s) => `${colors.red}${s}${colors.reset}`,
+  magenta: (s) => `${colors.magenta}${s}${colors.reset}`,
+  blue: (s) => `${colors.blue}${s}${colors.reset}`,
+  white: (s) => `${colors.white}${s}${colors.reset}`,
+  gray: (s) => `${colors.gray}${s}${colors.reset}`,
+  bold: (s) => `${colors.bold}${s}${colors.reset}`,
+  dim: (s) => `${colors.dim}${s}${colors.reset}`
+};
+function gradientLine(line) {
+  const gradientColors = [
+    "\x1B[38;5;82m",
+    // green
+    "\x1B[38;5;83m",
+    "\x1B[38;5;84m",
+    "\x1B[38;5;85m",
+    "\x1B[38;5;86m",
+    "\x1B[38;5;87m"
+    // cyan
+  ];
+  let result = "";
+  const chars = [...line];
+  for (let i = 0; i < chars.length; i++) {
+    const colorIndex = Math.floor(i / chars.length * gradientColors.length);
+    result += `${gradientColors[colorIndex]}${chars[i]}`;
+  }
+  return result + colors.reset;
+}
+var BANNER = `
+${c.green("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557   \u255A\u2588\u2588\u2588\u2588\u2554\u255D ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D    \u255A\u2588\u2588\u2554\u255D  ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551        \u2588\u2588\u2551   ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D        \u255A\u2550\u255D   ")}           ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}                    ${c.bold("MCP ADMIN SERVER")}                                ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}        ${c.cyan("\u{1F6CD}\uFE0F  Connect AI Agents to Your Shopify Store")}                  ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F")}
+`;
+function validateStoreUrl(value) {
+  const trimmed = value.trim().toLowerCase();
+  const cleaned = trimmed.replace(/^https?:\/\//, "");
+  if (!cleaned) {
+    return "Store URL is required";
+  }
+  if (!cleaned.endsWith(".myshopify.com")) {
+    return "Must be a valid myshopify.com domain (e.g., your-store.myshopify.com)";
+  }
+  return true;
+}
+function validateAccessToken(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return "Access token is required";
+  }
+  if (!trimmed.startsWith("shpat_")) {
+    return 'Access token should start with "shpat_"';
+  }
+  if (trimmed.length < 20) {
+    return "Access token seems too short";
+  }
+  return true;
+}
+function cleanStoreUrl(url) {
+  return url.trim().toLowerCase().replace(/^https?:\/\//, "");
+}
+var Spinner = class {
+  frames = ["\u25D0", "\u25D3", "\u25D1", "\u25D2"];
+  frameIndex = 0;
+  intervalId = null;
+  message;
+  constructor(message) {
+    this.message = message;
+  }
+  start() {
+    process.stdout.write("\x1B[?25l");
+    this.intervalId = setInterval(() => {
+      const frame = this.frames[this.frameIndex];
+      process.stdout.write(`\r${c.cyan(frame)} ${this.message}`);
+      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+    }, 100);
+  }
+  succeed(message) {
+    this.stop();
+    console.log(`\r${c.green("\u2714")} ${message}`);
+  }
+  fail(message) {
+    this.stop();
+    console.log(`\r${c.red("\u2716")} ${message}`);
+  }
+  stop() {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+      this.intervalId = null;
+    }
+    process.stdout.write("\x1B[?25h");
+    process.stdout.write("\r\x1B[K");
+  }
+};
+async function testConnection(config) {
+  const spinner = new Spinner(`Verifying connection to ${config.storeUrl}...`);
+  spinner.start();
+  try {
+    const query = `{
+      shop {
+        name
+        plan { displayName }
+        email
+      }
+    }`;
+    let accessToken = config.accessToken;
+    if (config.authMethod === "oauth" && config.clientId && config.clientSecret) {
+      const tokenResponse = await fetch(`https://${config.storeUrl}/admin/oauth/access_token`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          grant_type: "client_credentials",
+          client_id: config.clientId,
+          client_secret: config.clientSecret
+        })
+      });
+      if (!tokenResponse.ok) {
+        spinner.fail("Failed to authenticate with OAuth credentials");
+        return null;
+      }
+      const tokenData = await tokenResponse.json();
+      accessToken = tokenData.access_token;
+    }
+    const response = await fetch(`https://${config.storeUrl}/admin/api/2025-01/graphql.json`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Shopify-Access-Token": accessToken || ""
+      },
+      body: JSON.stringify({ query })
+    });
+    if (!response.ok) {
+      if (response.status === 401) {
+        spinner.fail("Authentication failed - check your access token");
+      } else if (response.status === 403) {
+        spinner.fail("Access denied - check API scopes");
+      } else {
+        spinner.fail(`Connection failed (HTTP ${response.status})`);
+      }
+      return null;
+    }
+    const data = await response.json();
+    if (data.errors) {
+      spinner.fail(`API error: ${data.errors[0]?.message || "Unknown error"}`);
+      return null;
+    }
+    if (!data.data) {
+      spinner.fail("Invalid response from Shopify API");
+      return null;
+    }
+    const storeInfo = {
+      name: data.data.shop.name,
+      plan: data.data.shop.plan.displayName,
+      email: data.data.shop.email
+    };
+    spinner.succeed(`Connected! Store: "${storeInfo.name}" (${storeInfo.plan})`);
+    return storeInfo;
+  } catch (error) {
+    spinner.fail(`Connection error: ${error instanceof Error ? error.message : "Unknown error"}`);
+    return null;
+  }
+}
+function buildEnvVars(config) {
+  const env = {
+    SHOPIFY_STORE_URL: config.storeUrl
+  };
+  if (config.authMethod === "token" && config.accessToken) {
+    env.SHOPIFY_ACCESS_TOKEN = config.accessToken;
+  } else {
+    env.SHOPIFY_CLIENT_ID = config.clientId || "";
+    env.SHOPIFY_CLIENT_SECRET = config.clientSecret || "";
+  }
+  if (config.lazyLoading) {
+    env.SHOPIFY_MCP_LAZY_LOADING = "true";
+  } else if (config.role) {
+    env.SHOPIFY_MCP_ROLE = config.role;
+  }
+  if (config.transport === "http") {
+    env.TRANSPORT = "http";
+    env.PORT = String(config.port || 3e3);
+  }
+  return env;
+}
+function generateJsonConfig(config) {
+  const env = buildEnvVars(config);
+  const mcpConfig = {
+    mcpServers: {
+      shopify: {
+        command: "npx",
+        args: ["-y", "@anton.andrusenko/shopify-mcp-admin"],
+        env
+      }
+    }
+  };
+  return JSON.stringify(mcpConfig, null, 2);
+}
+function generateLibreChatConfig(config) {
+  const env = buildEnvVars(config);
+  const envLines = Object.entries(env).map(([key, value]) => `      ${key}: "${value}"`).join("\n");
+  return `# LibreChat Configuration for Shopify MCP Admin
+# Generated by shopify-mcp-admin setup wizard
+# Docs: https://github.com/AntonAndrusenko/shopify-mcp-admin
+
+version: 1.2.1
+cache: true
+
+interface:
+  customWelcome: 'Welcome to LibreChat with Shopify MCP! \u{1F6CD}\uFE0F'
+
+mcpServers:
+  shopify:
+    type: ${config.transport === "http" ? "sse" : "stdio"}
+    ${config.transport === "http" ? `url: http://localhost:${config.port || 3e3}/sse` : `command: npx
+    args:
+      - -y
+      - "@anton.andrusenko/shopify-mcp-admin"`}
+    env:
+${envLines}
+      LOG_LEVEL: "info"
+    serverInstructions: true
+    timeout: 30000
+    initTimeout: 15000
+`;
+}
+function generateEnvFile(config) {
+  const env = buildEnvVars(config);
+  let content = `# Shopify MCP Admin Configuration
+# Generated by shopify-mcp-admin setup wizard
+# Docs: https://github.com/AntonAndrusenko/shopify-mcp-admin
+
+`;
+  for (const [key, value] of Object.entries(env)) {
+    content += `${key}=${value}
+`;
+  }
+  return content;
+}
+function generateShellExport(config) {
+  const env = buildEnvVars(config);
+  let content = `# Shopify MCP Admin - Shell Environment
+# Add to your ~/.bashrc, ~/.zshrc, or run: source <filename>
+
+`;
+  for (const [key, value] of Object.entries(env)) {
+    content += `export ${key}="${value}"
+`;
+  }
+  content += `
+# Run the server with:
+# npx @anton.andrusenko/shopify-mcp-admin
+`;
+  return content;
+}
+function getClaudeDesktopConfigPath() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return join(
+      homedir(),
+      "Library",
+      "Application Support",
+      "Claude",
+      "claude_desktop_config.json"
+    );
+  }
+  if (platform === "win32") {
+    return join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
+  }
+  return join(homedir(), ".config", "claude", "claude_desktop_config.json");
+}
+function getCursorConfigPath() {
+  return join(process.cwd(), ".cursor", "mcp.json");
+}
+function getWindsurfConfigPath() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+  }
+  if (platform === "win32") {
+    return join(process.env.APPDATA || "", "Codeium", "windsurf", "mcp_config.json");
+  }
+  return join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+}
+function getVSCodeConfigPath() {
+  return join(process.cwd(), ".vscode", "mcp.json");
+}
+function ensureDirectoryExists(filePath) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function mergeJsonConfig(existingPath, newConfig) {
+  if (!existsSync(existingPath)) {
+    return newConfig;
+  }
+  try {
+    const existing = JSON.parse(readFileSync(existingPath, "utf-8"));
+    const toMerge = JSON.parse(newConfig);
+    existing.mcpServers = {
+      ...existing.mcpServers,
+      ...toMerge.mcpServers
+    };
+    return JSON.stringify(existing, null, 2);
+  } catch {
+    return newConfig;
+  }
+}
+function printSuccessBox(client, configPath) {
+  const lines = ["", `   ${c.green("\u2728")} ${c.bold("You're all set!")}`, ""];
+  lines.push(`   ${c.cyan("Next steps:")}`);
+  switch (client) {
+    case "claude-desktop":
+      lines.push("   1. Restart Claude Desktop");
+      lines.push(`   2. Look for "shopify" in the MCP servers list`);
+      lines.push(`   3. Try: "List all products in my store"`);
+      break;
+    case "cursor":
+      lines.push("   1. Restart Cursor");
+      lines.push("   2. The Shopify MCP server will be available");
+      lines.push(`   3. Try: "List all products in my Shopify store"`);
+      break;
+    case "windsurf":
+      lines.push("   1. Restart Windsurf");
+      lines.push(`   2. Look for "shopify" in the Cascade MCP list`);
+      lines.push(`   3. Try: "List all products in my store"`);
+      break;
+    case "vscode-copilot":
+      lines.push("   1. Restart VS Code");
+      lines.push(`   2. Use Copilot Chat with "shopify" MCP`);
+      lines.push("   3. Try: @shopify list products");
+      break;
+    case "librechat":
+      lines.push("   1. Copy librechat.yaml to your LibreChat directory");
+      lines.push("   2. Restart LibreChat: docker compose restart");
+      lines.push(`   3. Select "shopify" in the MCP servers dropdown`);
+      break;
+    case "openai-http":
+      lines.push("   1. Start the server: npx @anton.andrusenko/shopify-mcp-admin");
+      lines.push("   2. Server will listen on the configured port");
+      lines.push("   3. Connect your OpenAI integration via HTTP");
+      break;
+    case "other":
+      lines.push(`   1. Source the env file: source ${configPath}`);
+      lines.push("   2. Or copy variables to your shell profile");
+      lines.push("   3. Run: npx @anton.andrusenko/shopify-mcp-admin");
+      break;
+  }
+  lines.push("");
+  lines.push(
+    `   ${c.gray("\u{1F4DA} Docs:")} ${c.cyan("https://github.com/AntonAndrusenko/shopify-mcp-admin")}`
+  );
+  lines.push("");
+  const maxLength = 65;
+  const boxTop = c.green(`\u256D${"\u2500".repeat(maxLength)}\u256E`);
+  const boxBottom = c.green(`\u2570${"\u2500".repeat(maxLength)}\u256F`);
+  console.log("");
+  console.log(boxTop);
+  const ansiRegex = /\x1b\[[0-9;]*m/g;
+  for (const line of lines) {
+    const visibleLength = line.replace(ansiRegex, "").length;
+    const padding = maxLength - visibleLength;
+    console.log(`${c.green("\u2502")}${line}${" ".repeat(Math.max(0, padding))}${c.green("\u2502")}`);
+  }
+  console.log(boxBottom);
+  console.log("");
+}
+async function runSetupWizard() {
+  console.clear();
+  console.log(BANNER);
+  const config = {
+    storeUrl: "",
+    authMethod: "token",
+    transport: "stdio",
+    lazyLoading: false,
+    client: "claude-desktop"
+  };
+  try {
+    console.log("");
+    const storeUrlInput = await input({
+      message: "What is your Shopify store URL?",
+      default: "your-store.myshopify.com",
+      validate: validateStoreUrl,
+      transformer: (value) => cleanStoreUrl(value)
+    });
+    config.storeUrl = cleanStoreUrl(storeUrlInput);
+    console.log("");
+    config.authMethod = await select({
+      message: "How would you like to authenticate?",
+      choices: [
+        {
+          name: "Access Token (Legacy Custom App)",
+          value: "token",
+          description: "I have a shpat_xxx token from a Custom App"
+        },
+        {
+          name: "OAuth 2.0 (Dev Dashboard)",
+          value: "oauth",
+          description: "I have a Client ID and Client Secret"
+        }
+      ]
+    });
+    console.log("");
+    if (config.authMethod === "token") {
+      config.accessToken = await password({
+        message: "Paste your access token (shpat_xxx)",
+        mask: "\u2022",
+        validate: validateAccessToken
+      });
+    } else {
+      config.clientId = await input({
+        message: "Enter your Client ID",
+        validate: (v) => v.trim().length > 0 || "Client ID is required"
+      });
+      config.clientSecret = await password({
+        message: "Enter your Client Secret",
+        mask: "\u2022",
+        validate: (v) => v.trim().length > 0 || "Client Secret is required"
+      });
+    }
+    console.log("");
+    const storeInfo = await testConnection(config);
+    if (!storeInfo) {
+      const retry = await confirm({
+        message: "Connection failed. Would you like to try different credentials?",
+        default: true
+      });
+      if (retry) {
+        return runSetupWizard();
+      }
+      console.log(c.yellow("\nSetup cancelled. Please check your credentials and try again."));
+      process.exit(1);
+    }
+    console.log("");
+    config.client = await select({
+      message: "Which AI client will you use?",
+      choices: [
+        {
+          name: "Claude Desktop",
+          value: "claude-desktop",
+          description: "Anthropic's official Claude app"
+        },
+        {
+          name: "Cursor",
+          value: "cursor",
+          description: "AI-powered code editor"
+        },
+        {
+          name: "Windsurf",
+          value: "windsurf",
+          description: "Codeium AI IDE with Cascade"
+        },
+        {
+          name: "VS Code (Copilot)",
+          value: "vscode-copilot",
+          description: "VS Code with GitHub Copilot MCP"
+        },
+        {
+          name: "LibreChat",
+          value: "librechat",
+          description: "Open-source chat UI (Docker)"
+        },
+        {
+          name: "OpenAI / HTTP Integration",
+          value: "openai-http",
+          description: "HTTP server for OpenAI function calling"
+        },
+        {
+          name: "Other / Manual Setup",
+          value: "other",
+          description: "Generate shell exports for manual configuration"
+        }
+      ]
+    });
+    console.log("");
+    const loadingStrategy = await select({
+      message: "How would you like to load tools?",
+      choices: [
+        {
+          name: `Load all tools at startup ${c.dim("(recommended)")}`,
+          value: "all",
+          description: "All 79 tools immediately available - best for most users"
+        },
+        {
+          name: `Load by role preset ${c.dim("(optimized)")}`,
+          value: "role",
+          description: "Load tools based on your workflow - reduces AI token usage"
+        },
+        {
+          name: `Lazy loading ${c.dim("(on-demand)")}`,
+          value: "lazy",
+          description: '15 core tools at start, load more with "load-module" command'
+        }
+      ]
+    });
+    if (loadingStrategy === "lazy") {
+      config.lazyLoading = true;
+      console.log(
+        c.gray('  \u2139\uFE0F  Lazy loading: Use "list-modules" and "load-module" tools to add more tools')
+      );
+    } else if (loadingStrategy === "role") {
+      console.log("");
+      const roleChoice = await select({
+        message: "Select your role preset:",
+        choices: [
+          {
+            name: `Product Manager ${c.dim("(41 tools)")}`,
+            value: "product-manager",
+            description: "Products, inventory, collections, and metafields"
+          },
+          {
+            name: `Content Manager ${c.dim("(37 tools)")}`,
+            value: "content-manager",
+            description: "Pages, blogs, articles, and SEO content"
+          },
+          {
+            name: `International Manager ${c.dim("(46 tools)")}`,
+            value: "international-manager",
+            description: "Markets, locales, and translations"
+          },
+          {
+            name: `SEO Specialist ${c.dim("(38 tools)")}`,
+            value: "seo-specialist",
+            description: "SEO optimization, redirects, and URL management"
+          },
+          {
+            name: `Inventory Manager ${c.dim("(15 tools)")}`,
+            value: "inventory-manager",
+            description: "Core product and inventory tools only"
+          }
+        ]
+      });
+      config.role = roleChoice;
+    }
+    if (config.client === "librechat" || config.client === "openai-http" || config.client === "other") {
+      console.log("");
+      config.transport = await select({
+        message: "Which transport mode?",
+        default: config.client === "openai-http" ? "http" : "stdio",
+        choices: [
+          {
+            name: `STDIO ${c.dim("(recommended for most clients)")}`,
+            value: "stdio",
+            description: "Standard input/output communication"
+          },
+          {
+            name: `HTTP ${c.dim("(for web integrations)")}`,
+            value: "http",
+            description: "HTTP server with SSE support"
+          }
+        ]
+      });
+      if (config.transport === "http") {
+        const portInput = await input({
+          message: "HTTP server port",
+          default: "3000",
+          validate: (v) => {
+            const n = Number.parseInt(v, 10);
+            return n > 0 && n < 65536 || "Must be a valid port number";
+          }
+        });
+        config.port = Number.parseInt(portInput, 10);
+      }
+    }
+    if (config.client === "openai-http") {
+      config.transport = "http";
+      config.port = config.port || 3e3;
+    }
+    console.log("");
+    let configContent;
+    let configPath;
+    let configDescription;
+    switch (config.client) {
+      case "claude-desktop": {
+        configPath = getClaudeDesktopConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Claude Desktop config";
+        break;
+      }
+      case "cursor": {
+        configPath = getCursorConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Cursor MCP config";
+        break;
+      }
+      case "windsurf": {
+        configPath = getWindsurfConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Windsurf MCP config";
+        break;
+      }
+      case "vscode-copilot": {
+        configPath = getVSCodeConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "VS Code MCP config";
+        break;
+      }
+      case "librechat": {
+        configPath = join(process.cwd(), "librechat.yaml");
+        configContent = generateLibreChatConfig(config);
+        configDescription = "LibreChat config";
+        break;
+      }
+      case "openai-http": {
+        configPath = join(process.cwd(), ".env.shopify-mcp");
+        configContent = generateEnvFile(config);
+        configDescription = "Environment file (HTTP mode)";
+        break;
+      }
+      default: {
+        configPath = join(process.cwd(), ".shopify-mcp.env");
+        configContent = generateShellExport(config);
+        configDescription = "Shell environment exports";
+        break;
+      }
+    }
+    console.log(c.cyan(`
+\u{1F4C4} ${configDescription} preview:
+`));
+    console.log(c.gray("\u2500".repeat(60)));
+    console.log(c.dim(configContent));
+    console.log(c.gray("\u2500".repeat(60)));
+    const shouldSave = await confirm({
+      message: `Save to ${configPath}?`,
+      default: true
+    });
+    if (shouldSave) {
+      ensureDirectoryExists(configPath);
+      writeFileSync(configPath, configContent, "utf-8");
+      console.log(`
+${c.green("\u2714")} Configuration saved to: ${c.cyan(configPath)}`);
+    } else {
+      console.log(`
+${c.yellow("\u2139")} Configuration not saved. You can copy the preview above.`);
+    }
+    printSuccessBox(config.client, configPath);
+  } catch (error) {
+    if (error instanceof Error && error.name === "ExitPromptError") {
+      console.log(c.yellow("\n\nSetup cancelled."));
+      process.exit(0);
+    }
+    throw error;
+  }
+}
+function isSetupCommand(args) {
+  return args.includes("init") || args.includes("setup") || args.includes("--setup");
+}
+if (process.argv[1]?.includes("setup-wizard")) {
+  runSetupWizard().catch((error) => {
+    console.error(c.red("Setup failed:"), error);
+    process.exit(1);
+  });
+}
+export {
+  isSetupCommand,
+  runSetupWizard
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anton.andrusenko/shopify-mcp-admin",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "MCP server for Shopify Admin API - enables AI agents to manage Shopify stores with 79 tools for products, inventory, collections, content, SEO, metafields, markets & translations",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,7 +11,7 @@
   "sideEffects": false,
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsup src/index.ts --format esm --dts",
+    "build": "tsup src/index.ts --format esm --dts --clean",
     "start": "node dist/index.js",
     "lint": "biome check src/",
     "lint:fix": "biome check --fix src/",
@@ -24,16 +24,14 @@
     "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
     "inspect:dev": "npx @modelcontextprotocol/inspector npx tsx src/index.ts",
     "inspect:config": "npx @modelcontextprotocol/inspector --config mcp-inspector.json",
-    "fast-agent": "fast-agent",
-    "fast-agent:check": "fast-agent check",
-    "fast-agent:chat": "fast-agent go --servers shopify-mcp-admin",
-    "fast-agent:dev": "fast-agent go --servers shopify-mcp-admin-dev",
+    "wizard": "npx tsx src/index.ts init",
+    "wizard:build": "node dist/index.js init",
+    "librechat:setup": "./scripts/setup-librechat.sh",
+    "librechat:setup:local": "./scripts/setup-librechat.sh --use-local",
     "ci": "npm run lint && npm run typecheck && npm run test && npm run build",
     "version:patch": "npm version patch --no-git-tag-version",
     "version:minor": "npm version minor --no-git-tag-version",
-    "version:major": "npm version major --no-git-tag-version",
-    "release": "npm run ci && npm publish --access public",
-    "prepublishOnly": "npm run ci"
+    "version:major": "npm version major --no-git-tag-version"
   },
   "keywords": [
     "shopify",
@@ -66,6 +64,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^7.5.1",
     "@modelcontextprotocol/sdk": "^1.22.0",
     "@shopify/shopify-api": "^11.14.1",
     "express": "^5.1.0",