@anton.andrusenko/shopify-mcp-admin 1.1.0 → 1.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @anton.andrusenko/shopify-mcp-admin
 
-> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 81 powerful tools
+> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 79 powerful tools
 
 [![npm version](https://badge.fury.io/js/@anton.andrusenko%2Fshopify-mcp-admin.svg)](https://www.npmjs.com/package/@anton.andrusenko/shopify-mcp-admin)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -11,8 +11,8 @@
 
 ## ✨ Features
 
-- 🛠️ **81 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, markets, locales & translations
-- 📦 **Modular Architecture** — 7 modules with lazy loading for optimal AI performance (see [Tool Modules](#-tool-modules))
+- 🛠️ **79 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, markets, locales & translations
+- 📦 **Modular Architecture** — 7 modules with optional lazy loading for optimal AI performance (see [Tool Modules](#-tool-modules))
 - 🤖 **AI-Optimized** — Tool descriptions and error messages designed for LLM comprehension
 - 🔌 **Dual Transport** — STDIO for Claude Desktop, HTTP for ChatGPT/OpenAI
 - ⚡ **Rate Limiting** — Automatic retry with exponential backoff for Shopify API limits
@@ -191,6 +191,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.
@@ -264,7 +456,7 @@ Role presets automatically load appropriate tool modules at startup, optimizing
 | `content-manager` | core, content | 37 | Pages, blogs, and content marketing |
 | `seo-specialist` | core, collections, product-extensions, advanced-redirects | 38 | SEO optimization and URL management |
 | `international-manager` | core, store-context, international, collections | 46 | Multi-market and translation management |
-| `full-access` | All 7 modules | 81 | Full store administration |
+| `full-access` | All 7 modules | 81 | Full store administration (includes meta-tools) |
 
 ### Using Role Presets
 
@@ -293,19 +485,21 @@ Or in Claude Desktop config:
 }
 ```
 
-### Module Discovery
+### Module Discovery (Lazy Loading Mode)
 
-If no role is set, the server starts with core tools only (15 tools). AI agents can discover and load additional modules dynamically:
+When lazy loading is enabled (`SHOPIFY_MCP_LAZY_LOADING=true`) and no role is set, the server starts with core tools only (15 tools). AI agents can discover and load additional modules dynamically:
 
 1. **Discover modules**: Use `list-modules` to see available modules
 2. **Load modules**: Use `load-module` with the module name to enable tools
 3. **Suggestions**: Tool responses include suggestions for relevant modules to load
 
+> **Note:** When lazy loading is disabled (default), all 79 tools are available immediately and module discovery is not needed.
+
 ---
 
 ## 🛠️ Available Tools
 
-@anton.andrusenko/shopify-mcp-admin provides **81 tools** (79 domain tools + 2 meta-tools) organized into 16 categories:
+@anton.andrusenko/shopify-mcp-admin provides **79 domain tools** organized into 16 categories (plus 2 meta-tools when lazy loading is enabled):
 
 <details>
 <summary><strong>🏪 Store Info (9 tools)</strong></summary>
@@ -556,13 +750,15 @@ If no role is set, the server starts with core tools only (15 tools). AI agents
 
 ## 📦 Tool Modules
 
-shopify-mcp-admin uses a modular architecture to optimize AI agent performance. Instead of loading all 81 tools at startup (which can degrade AI performance by up to 85%), tools are organized into 7 modules that can be loaded on demand.
+shopify-mcp-admin uses a modular architecture to optimize AI agent performance. Instead of loading all 79 tools at startup (which can degrade AI performance by up to 85%), tools can be organized into 7 modules that load on demand when lazy loading is enabled.
 
-### How Module Loading Works
+### How Module Loading Works (when `SHOPIFY_MCP_LAZY_LOADING=true`)
 
-1. **At startup:** Only the **Core Module** (15 tools) is loaded by default
+1. **At startup:** Only the **Core Module** (15 tools including meta-tools) is loaded
 2. **Discovery:** AI agents use `list-modules` to see available modules
 3. **Loading:** AI agents use `load-module` to enable additional tools
+
+> **Default behavior:** When lazy loading is disabled (default), all 79 domain tools are available immediately without module loading.
 4. **Suggestions:** Tool responses include hints about which modules to load next
 
 ### Module Dependency Diagram
@@ -570,9 +766,10 @@ shopify-mcp-admin uses a modular architecture to optimize AI agent performance.
 ```
 ┌─────────────────────────────────────────────────────────────────┐
 │                         CORE MODULE                              │
-│            (Always Loaded - 15 tools)                           │
-│   Products (7) • Inventory (4) • Store Info (2) • Meta (2)      │
+│        (Always Loaded - 13 domain + 2 meta* tools)              │
+│   Products (7) • Inventory (4) • Store Info (2) • Meta* (2)     │
 └─────────────────────────────────────────────────────────────────┘
+*Meta tools only available when lazy loading is enabled
         │
         ├──────────────────────────────────────────────────────────┐
         │                                                          │
@@ -593,7 +790,7 @@ shopify-mcp-admin uses a modular architecture to optimize AI agent performance.
 └───────────────────┘  └───────────────────┘  └───────────────────┘
 ```
 
-### Module: Core (15 tools) — Always Loaded
+### Module: Core (13-15 tools) — Always Loaded
 
 **Description:** Essential product and inventory management tools that form the foundation for most Shopify operations. Always loaded at startup.
 
@@ -606,7 +803,9 @@ shopify-mcp-admin uses a modular architecture to optimize AI agent performance.
 | Products (7) | `create-product`, `get-product`, `update-product`, `delete-product`, `list-products`, `update-product-variant`, `add-product-image` |
 | Inventory (4) | `get-inventory`, `update-inventory`, `list-low-inventory`, `get-bulk-inventory` |
 | Store Info (2) | `get-store-info`, `get-store-limits` |
-| Meta Tools (2) | `list-modules`, `load-module` |
+| Meta Tools (2)* | `list-modules`, `load-module` |
+
+> *Meta tools are only included when lazy loading is enabled (`SHOPIFY_MCP_LAZY_LOADING=true`). When disabled (default), core has 13 domain tools.
 
 **Use Case:** Basic product catalog management, inventory tracking, and store information queries.
 
@@ -750,31 +949,32 @@ shopify-mcp-admin uses a modular architecture to optimize AI agent performance.
 
 ### What's New in v0.8.0+: Modular Tool Loading
 
-Starting with v0.8.0, shopify-mcp-admin uses **lazy loading** to optimize AI agent performance. Research shows that presenting more than 30 tools to an AI agent can degrade performance by up to 85%.
+Starting with v0.8.0, shopify-mcp-admin supports **modular lazy loading** to optimize AI agent performance. Research shows that presenting more than 30 tools to an AI agent can degrade performance by up to 85%.
 
-**Default Behavior (Lazy Loading Enabled):**
-- Only 15 core tools are loaded at startup
+**Default Behavior (All Tools Loaded):**
+- All 79 domain tools are loaded at startup for maximum compatibility
+- Works with Claude Desktop and all MCP clients
+- Server instructions describe all tools as immediately available
+- Module meta-tools (`list-modules`, `load-module`) are NOT registered (not needed)
+
+**Optional: Enable Lazy Loading:**
+- Only 15 core tools are loaded at startup (13 domain + 2 meta-tools)
 - Additional tools are loaded on-demand via `load-module`
 - AI agents discover available modules using `list-modules`
 - Token usage reduced by up to 81% compared to loading all tools
+- Server instructions explain module discovery and loading
 
-### Breaking Changes
-
-| Previous Behavior | New Behavior (v0.8.0+) |
-|-------------------|------------------------|
-| All 79+ tools loaded at startup | 15 core tools loaded at startup |
-| No module concept | 7 modules with lazy loading |
-| N/A | `list-modules` and `load-module` meta-tools added |
+> **Note:** Claude Desktop doesn't support dynamic tool list refresh, so lazy loading is disabled by default. Enable it for MCP clients that support `notifications/tools/list_changed`.
 
-### Legacy Mode: Restore Previous Behavior
+### Enabling Lazy Loading
 
-If you prefer all tools loaded at startup (not recommended for optimal AI performance):
+For MCP clients that support dynamic tool refresh:
 
 ```bash
 # Option 1: Environment variable
-export SHOPIFY_MCP_LAZY_LOADING=false
+export SHOPIFY_MCP_LAZY_LOADING=true
 
-# Option 2: In Claude Desktop config
+# Option 2: In MCP client config
 {
   "mcpServers": {
     "shopify": {
@@ -783,54 +983,54 @@ export SHOPIFY_MCP_LAZY_LOADING=false
       "env": {
         "SHOPIFY_STORE_URL": "your-store.myshopify.com",
         "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx",
-        "SHOPIFY_MCP_LAZY_LOADING": "false"
+        "SHOPIFY_MCP_LAZY_LOADING": "true"
       }
     }
   }
 }
 ```
 
-### Migration Steps
+### Configuration Options
 
-1. **Review your use case** — Do you need all 81 tools? Most workflows only need a subset.
+1. **Default (all tools)** — All 79 domain tools available immediately. Best for Claude Desktop and MCP clients without dynamic tool refresh.
 
-2. **Choose a role preset** (recommended) — Set `SHOPIFY_MCP_ROLE` for pre-configured modules:
+2. **Role Preset** — Pre-configured module sets for specific workflows:
    ```bash
    export SHOPIFY_MCP_ROLE=product-manager
    ```
 
-3. **Or use on-demand loading** — Let AI agents discover and load modules as needed:
+3. **Lazy Loading** — Enable for MCP clients that support `notifications/tools/list_changed`:
+   ```bash
+   export SHOPIFY_MCP_LAZY_LOADING=true
+   ```
    - AI uses `list-modules` to see available modules
    - AI uses `load-module` with module name to enable tools
    - Tool responses suggest relevant modules automatically
 
-4. **Or disable lazy loading** — Set `SHOPIFY_MCP_LAZY_LOADING=false` for legacy behavior
-
 ### When to Use Each Mode
 
 | Mode | Tools | Best For |
 |------|-------|----------|
-| **Lazy Loading (default)** | 15 at startup | New projects, optimal AI performance |
+| **Default (all tools)** | 79 | Claude Desktop, maximum compatibility |
 | **Role Preset** | 15-81 based on role | Specific workflows (e.g., content manager) |
-| **Legacy Mode** | All 81 | Backward compatibility, full store admin |
+| **Lazy Loading** | 15 at startup | MCP clients with dynamic tool refresh |
 
 ### Performance Comparison
 
 | Mode | Tools at Startup | Est. Token Usage | AI Performance |
 |------|------------------|------------------|----------------|
-| Lazy Loading (default) | 15 | ~4,500 | ⭐⭐⭐ Optimal |
+| Lazy Loading | 15 | ~4,500 | ⭐⭐⭐ Optimal |
 | inventory-manager | 15 | ~4,500 | ⭐⭐⭐ Optimal |
 | content-manager | 37 | ~11,100 | ⭐⭐ Good |
 | product-manager | 41 | ~12,300 | ⭐⭐ Good |
 | international-manager | 46 | ~13,800 | ⭐⭐ Good |
-| full-access | 81 | ~24,000 | ⭐ May degrade |
-| Legacy Mode | 81 | ~24,000 | ⭐ May degrade |
+| full-access / Default | 79-81 | ~24,000 | ⭐ May degrade |
 
 ### Troubleshooting Module Loading
 
 | Issue | Solution |
 |-------|----------|
-| Tool not found after upgrade | Load the appropriate module: `load-module(module: "collections")` |
+| Tool not found with lazy loading | Load the appropriate module: `load-module(module: "collections")` |
 | "Module not found" error | Use `list-modules` to see valid module names |
 | Want modular lazy loading | Set `SHOPIFY_MCP_LAZY_LOADING=true` (requires MCP client that supports tool list refresh) |
 | AI agent loading too many modules | Use a role preset instead of on-demand loading |
@@ -881,8 +1081,8 @@ npm run inspect:config
 
 MCP Inspector opens a web UI at `http://localhost:6274` where you can:
 
-- 📋 Browse registered tools with schemas (15 core tools by default, up to 81 with modules)
-- 📦 Test module loading via `list-modules` and `load-module`
+- 📋 Browse registered tools with schemas (79 tools by default, or 15 core tools with lazy loading)
+- 📦 Test module loading via `list-modules` and `load-module` (when lazy loading is enabled)
 - 📊 Access 9 MCP resources for store context
 - ▶️ Execute tools interactively and view results
 - 🔍 Inspect JSON-RPC protocol messages

package/dist/index.js

@@ -1326,38 +1326,7 @@ async function getStoreInfo() {
 var require2 = createRequire(import.meta.url);
 var packageJson = require2("../package.json");
 var SERVER_NAME = "shopify-mcp-admin";
-var SERVER_INSTRUCTIONS = `This MCP server provides access to a Shopify store's Admin API.
-
-## TOOL MODULES (Modular Architecture)
-
-Tools are organized into modules for optimal AI performance. Start with core tools and load additional modules as needed.
-
-**Discovery & Loading:**
-- Use "list-modules" to see all available modules and their loading status
-- Use "load-module" with module name to enable additional tools
-- Tool responses may include suggestions for relevant modules to load
-
-**Available Modules:**
-| Module | Description | Tools |
-|--------|-------------|-------|
-| core | Products, inventory, store info (always loaded) | 15 |
-| store-context | Extended store configuration (features, currencies, shipping) | 7 |
-| collections | Collection management and metafields | 10 |
-| product-extensions | Product metafields, images, and URL redirects | 9 |
-| content | Pages, blogs, and articles management | 22 |
-| international | Markets, web presence, and translations | 14 |
-| advanced-redirects | Bulk redirect operations | 4 |
-
-**Role Presets (SHOPIFY_MCP_ROLE):**
-Pre-configured module sets for common workflows:
-- inventory-manager: Core only (15 tools) - stock management
-- product-manager: Core + store-context + collections + product-extensions (41 tools)
-- content-manager: Core + content (37 tools) - pages and blogs
-- seo-specialist: Core + collections + product-extensions + advanced-redirects (38 tools)
-- international-manager: Core + store-context + international + collections (46 tools)
-- full-access: All modules (81 tools) - full store administration
-
-## KEY CONCEPTS
+var COMMON_INSTRUCTIONS = `## KEY CONCEPTS
 
 - **Products & Variants**: Products contain variants; each variant has its own price, SKU, and inventory
 - **Multi-location Inventory**: Inventory is tracked per variant AND per location
@@ -1395,12 +1364,82 @@ Pre-configured module sets for common workflows:
 ## WORKFLOW HINTS
 
 - Tool descriptions include **Prerequisites:** and **Follow-ups:** for multi-step operations
-- Check tool category and relationships for semantic grouping
+- Check tool category and relationships for semantic grouping`;
+var LAZY_LOADING_INSTRUCTIONS = `This MCP server provides access to a Shopify store's Admin API.
+
+## TOOL MODULES (Modular Architecture)
+
+Tools are organized into modules for optimal AI performance. Start with core tools and load additional modules as needed.
+
+**Discovery & Loading:**
+- Use "list-modules" to see all available modules and their loading status
+- Use "load-module" with module name to enable additional tools
+- Tool responses may include suggestions for relevant modules to load
+
+**Available Modules:**
+| Module | Description | Tools |
+|--------|-------------|-------|
+| core | Products, inventory, store info (always loaded) | 15 |
+| store-context | Extended store configuration (features, currencies, shipping) | 7 |
+| collections | Collection management and metafields | 10 |
+| product-extensions | Product metafields, images, and URL redirects | 9 |
+| content | Pages, blogs, and articles management | 22 |
+| international | Markets, web presence, and translations | 14 |
+| advanced-redirects | Bulk redirect operations | 4 |
+
+**Role Presets (SHOPIFY_MCP_ROLE):**
+Pre-configured module sets for common workflows:
+- inventory-manager: Core only (15 tools) - stock management
+- product-manager: Core + store-context + collections + product-extensions (41 tools)
+- content-manager: Core + content (37 tools) - pages and blogs
+- seo-specialist: Core + collections + product-extensions + advanced-redirects (38 tools)
+- international-manager: Core + store-context + international + collections (46 tools)
+- full-access: All modules (81 tools) - full store administration
+
+${COMMON_INSTRUCTIONS}
 - After successful operations, note any module suggestions in the response`;
+var FULL_ACCESS_INSTRUCTIONS = `This MCP server provides access to a Shopify store's Admin API.
+
+## AVAILABLE TOOLS
+
+All tools are available immediately. This server provides comprehensive Shopify Admin API coverage:
+
+**Core Operations:**
+- Products: list, get, create, update, delete products and variants
+- Inventory: multi-location stock management, bulk queries, low inventory alerts
+- Store Info: basic info, limits, features, currencies, shipping, taxes, policies
+
+**Content Management:**
+- Pages: create, update, delete store pages
+- Blogs & Articles: manage blog content with SEO optimization
+
+**Collections:**
+- Create, update, delete collections
+- Manage product-collection relationships
+- Collection metafields for custom data
+
+**SEO & Redirects:**
+- URL redirects for SEO preservation
+- Bulk redirect operations for migrations
+- Product metafields for SEO data
+
+**International:**
+- Markets: manage selling regions
+- Translations: localize product content
+- Web presence configuration
+
+${COMMON_INSTRUCTIONS}`;
+function getServerInstructions(config) {
+  if (config && isLazyLoadingEnabled(config)) {
+    return LAZY_LOADING_INSTRUCTIONS;
+  }
+  return FULL_ACCESS_INSTRUCTIONS;
+}
 function getServerVersion() {
   return packageJson.version;
 }
-function createServer() {
+function createServer(config) {
+  const instructions = getServerInstructions(config);
   const server = new McpServer(
     // Server info (sent to clients in initialize response)
     {
@@ -1417,8 +1456,8 @@ function createServer() {
         logging: {}
         // Enable logging capability (AC-9.5.1.2)
       },
-      instructions: SERVER_INSTRUCTIONS,
-      // Provide Shopify context to AI agents (AC-9.5.1.1)
+      instructions,
+      // Provide mode-aware Shopify context to AI agents (AC-9.5.1.1)
       // Epic 12: Notification debouncing for module loading (AC-12.1.6)
       // When multiple tools are enabled in rapid succession (e.g., loading a module),
       // coalesce into a single notifications/tools/list_changed notification
@@ -14409,11 +14448,14 @@ function registerAllTools(server) {
   registerGetStoreTaxesTool();
   registerGetStorePoliciesTool();
   registerGetStoreAlertsTool();
-  registerListModulesTool();
-  registerLoadModuleTool();
-  const totalToolCount = getToolNames().length;
   const config = getConfig();
-  if (isLazyLoadingEnabled(config)) {
+  const lazyLoadingEnabled = isLazyLoadingEnabled(config);
+  if (lazyLoadingEnabled) {
+    registerListModulesTool();
+    registerLoadModuleTool();
+  }
+  const totalToolCount = getToolNames().length;
+  if (lazyLoadingEnabled) {
     applyLazyLoading();
     const roleResult = applyRolePreset(config);
     const enabledCount = getRegisteredTools().length;
@@ -14430,7 +14472,7 @@ function registerAllTools(server) {
       `Enabled tools: ${getRegisteredTools().map((t) => t.name).join(", ")}`
     );
   } else {
-    log.info(`Lazy loading disabled (legacy mode): ${totalToolCount} tools registered`);
+    log.info(`Lazy loading disabled: ${totalToolCount} tools registered (all tools available)`);
     log.debug(`All tools: ${getToolNames().join(", ")}`);
   }
 }
@@ -14680,7 +14722,7 @@ if (args.includes("--version") || args.includes("-v")) {
 async function main() {
   try {
     const config = getConfig();
-    const server = createServer();
+    const server = createServer(config);
     registerResources(server);
     registerAllTools(server);
     const transportType = config.TRANSPORT;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@anton.andrusenko/shopify-mcp-admin",
-  "version": "1.1.0",
-  "description": "MCP server for Shopify Admin API - enables AI agents to manage Shopify stores with 71 tools for products, inventory, collections, content, SEO, metafields, markets & translations",
+  "version": "1.1.2",
+  "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",
   "types": "./dist/index.d.ts",
@@ -24,10 +24,8 @@
     "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",
+    "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",