@anton.andrusenko/shopify-mcp-admin 0.6.0 → 0.7.0

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 70 powerful tools
+> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 71 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,7 +11,7 @@
 
 ## ✨ Features
 
-- 🛠️ **70 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, markets, locales & translations
+- 🛠️ **71 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, markets, locales & translations
 - 🤖 **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
@@ -250,7 +250,16 @@ Each tool can be converted to OpenAI function format:
 
 ## 🛠️ Available Tools
 
-@anton.andrusenko/shopify-mcp-admin provides **70 tools** organized into 15 categories:
+@anton.andrusenko/shopify-mcp-admin provides **71 tools** organized into 16 categories:
+
+<details>
+<summary><strong>🏪 Store Info (1 tool)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get-store-info` | Get basic store information (name, domain, plan, currency, timezone, email) |
+
+</details>
 
 <details>
 <summary><strong>📦 Product Management (7 tools)</strong></summary>
@@ -488,7 +497,7 @@ npm run inspect:config
 
 MCP Inspector opens a web UI at `http://localhost:6274` where you can:
 
-- 📋 Browse all 70 registered tools with schemas
+- 📋 Browse all 71 registered tools with schemas
 - ▶️ Execute tools interactively and view results
 - 🔍 Inspect JSON-RPC protocol messages
 - 📊 Monitor server events in real-time

package/dist/index.js

@@ -2451,7 +2451,7 @@ function wrapToolHandler(toolName, schema, handler) {
   };
 }
 function registerTool(definition, handler, options = {}) {
-  const { name, title, description, inputSchema: inputSchema71, annotations } = definition;
+  const { name, title, description, inputSchema: inputSchema72, annotations } = definition;
   try {
     if (!options.skipNameValidation) {
       validateToolName(name);
@@ -2459,8 +2459,8 @@ function registerTool(definition, handler, options = {}) {
     if (registeredTools.has(name)) {
       throw new Error(`Tool "${name}" is already registered. Tool names must be unique.`);
     }
-    const jsonSchema = convertZodToJsonSchema(inputSchema71);
-    const wrappedHandler = wrapToolHandler(name, inputSchema71, handler);
+    const jsonSchema = convertZodToJsonSchema(inputSchema72);
+    const wrappedHandler = wrapToolHandler(name, inputSchema72, handler);
     const finalAnnotations = {
       ...deriveDefaultAnnotations(name),
       ...annotations,
@@ -2472,7 +2472,7 @@ function registerTool(definition, handler, options = {}) {
       title,
       description,
       inputSchema: jsonSchema,
-      zodSchema: inputSchema71,
+      zodSchema: inputSchema72,
       handler: wrappedHandler,
       annotations: finalAnnotations
     };
@@ -2648,6 +2648,28 @@ var PRODUCT_VARIANTS_BULK_UPDATE_MUTATION = `
     }
   }
 `;
+var PRODUCT_VARIANTS_BULK_CREATE_MUTATION = `
+  mutation ProductVariantsBulkCreate($productId: ID!, $variants: [ProductVariantsBulkInput!]!) {
+    productVariantsBulkCreate(productId: $productId, variants: $variants) {
+      product {
+        id
+      }
+      productVariants {
+        id
+        title
+        price
+        compareAtPrice
+        sku
+        barcode
+        inventoryQuantity
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
 var PRODUCT_SET_MEDIA_MUTATION = `
   mutation ProductSetMedia($input: ProductSetInput!) {
     productSet(input: $input) {
@@ -2781,26 +2803,6 @@ function buildProductCreateVariables(input) {
   if (input.handle !== void 0) {
     productData.handle = input.handle;
   }
-  if (input.variants && input.variants.length > 0) {
-    productData.variants = input.variants.map((variant) => {
-      const variantInput = {
-        price: variant.price
-      };
-      if (variant.compareAtPrice !== void 0) {
-        variantInput.compareAtPrice = variant.compareAtPrice;
-      }
-      if (variant.sku !== void 0) {
-        variantInput.sku = variant.sku;
-      }
-      if (variant.barcode !== void 0) {
-        variantInput.barcode = variant.barcode;
-      }
-      if (variant.options !== void 0 && variant.options.length > 0) {
-        variantInput.options = variant.options;
-      }
-      return variantInput;
-    });
-  }
   let media;
   if (input.images && input.images.length > 0) {
     media = input.images.map((image) => ({
@@ -2811,6 +2813,65 @@ function buildProductCreateVariables(input) {
   }
   return { product: productData, media };
 }
+async function createProductVariants(productId, variants) {
+  const client = await getShopifyClient();
+  const variantInputs = variants.map((variant) => {
+    const variantInput = {
+      price: variant.price
+    };
+    if (variant.compareAtPrice !== void 0) {
+      variantInput.compareAtPrice = variant.compareAtPrice;
+    }
+    if (variant.sku !== void 0) {
+      variantInput.sku = variant.sku;
+    }
+    if (variant.barcode !== void 0) {
+      variantInput.barcode = variant.barcode;
+    }
+    if (variant.options !== void 0 && variant.options.length > 0) {
+      variantInput.optionValues = variant.options.map((optionValue) => ({
+        name: optionValue,
+        optionName: optionValue
+        // Use the option value as the option name for simple cases
+      }));
+    }
+    return variantInput;
+  });
+  log.debug(`Creating ${variants.length} variants for product: ${productId}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(
+      PRODUCT_VARIANTS_BULK_CREATE_MUTATION,
+      {
+        variables: { productId, variants: variantInputs }
+      }
+    ),
+    "create-product-variants"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.productVariantsBulkCreate;
+  if (!result) {
+    throw new Error("No response data from productVariantsBulkCreate mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.productVariants || result.productVariants.length === 0) {
+    throw new Error("No variants were created");
+  }
+  log.debug(`Created ${result.productVariants.length} variants`);
+  return result.productVariants.map((variant) => ({
+    id: variant.id,
+    title: variant.title,
+    price: variant.price,
+    compareAtPrice: variant.compareAtPrice,
+    sku: variant.sku,
+    barcode: variant.barcode,
+    inventoryQuantity: variant.inventoryQuantity
+  }));
+}
 async function createProduct(input) {
   const client = await getShopifyClient();
   const variables = buildProductCreateVariables(input);
@@ -2836,7 +2897,23 @@ async function createProduct(input) {
     throw new Error("Product was not created (no product in response)");
   }
   log.debug(`Created product: ${result.product.id}`);
-  return transformProductToOutput(result.product);
+  let productOutput = transformProductToOutput(result.product);
+  if (input.variants && input.variants.length > 0) {
+    try {
+      const createdVariants = await createProductVariants(result.product.id, input.variants);
+      productOutput = {
+        ...productOutput,
+        variants: createdVariants
+      };
+      log.debug(`Created ${createdVariants.length} variants for product: ${result.product.id}`);
+    } catch (variantError) {
+      log.warn(
+        `Product created but variant creation failed: ${variantError instanceof Error ? variantError.message : "Unknown error"}`
+      );
+      log.warn("Variants can be added using update-product-variant tool");
+    }
+  }
+  return productOutput;
 }
 async function getProduct(id) {
   const client = await getShopifyClient();
@@ -5540,10 +5617,10 @@ var inputSchema8 = z10.object({
   // Variants
   variants: z10.array(
     z10.object({
-      price: z10.string().describe('Variant price as decimal string. Example: "29.99"'),
-      compareAtPrice: z10.string().optional().describe('Original price for sale display. Example: "39.99"'),
+      price: z10.union([z10.string(), z10.number()]).transform((val) => typeof val === "number" ? String(val) : val).describe('Variant price as decimal string. Example: "29.99"'),
+      compareAtPrice: z10.union([z10.string(), z10.number()]).optional().transform((val) => typeof val === "number" ? String(val) : val).describe('Original price for sale display. Example: "39.99"'),
       sku: z10.string().optional().describe('Stock keeping unit. Example: "SHIRT-001-RED-M"'),
-      barcode: z10.string().optional().describe("Barcode (UPC, EAN, etc.)"),
+      barcode: z10.union([z10.string(), z10.number()]).optional().transform((val) => typeof val === "number" ? String(val) : val).describe("Barcode (UPC, EAN, etc.)"),
       inventoryQuantity: z10.number().int().min(0).optional().describe("Initial inventory quantity (note: may require separate inventory API)"),
       options: z10.array(z10.string()).optional().describe('Variant options. Example: ["Red", "Medium"]')
     })
@@ -10300,11 +10377,11 @@ var inputSchema44 = z46.object({
   id: variantIdSchema.describe(
     'Shopify variant GID (e.g., "gid://shopify/ProductVariant/456"). Required. Use get-product to find variant IDs for a product.'
   ),
-  price: z46.string().optional().describe('New variant price as decimal string (e.g., "29.99")'),
-  compareAtPrice: z46.string().nullable().optional().describe(
+  price: z46.union([z46.string(), z46.number()]).optional().transform((val) => typeof val === "number" ? String(val) : val).describe('New variant price as decimal string (e.g., "29.99")'),
+  compareAtPrice: z46.union([z46.string(), z46.number()]).nullable().optional().transform((val) => typeof val === "number" ? String(val) : val).describe(
     'Original price for sale display (e.g., "39.99"). When set higher than price, Shopify shows strikethrough pricing. Set to null to remove the compare at price.'
   ),
-  barcode: z46.string().nullable().optional().describe("Barcode (UPC, EAN, ISBN, etc.). Set to null to remove.")
+  barcode: z46.union([z46.string(), z46.number()]).nullable().optional().transform((val) => typeof val === "number" ? String(val) : val).describe("Barcode (UPC, EAN, ISBN, etc.). Set to null to remove.")
 }).refine(
   (data) => {
     const { productId: _productId, id: _id, ...updateFields } = data;
@@ -12483,6 +12560,49 @@ function registerSubmitRedirectImportTool() {
   );
 }
 
+// src/tools/get-store-info.ts
+import { z as z73 } from "zod";
+var inputSchema71 = z73.object({});
+var outputSchema71 = z73.object({
+  name: z73.string().describe("Store name"),
+  domain: z73.string().describe("Store domain (without .myshopify.com)"),
+  myshopifyDomain: z73.string().describe("Full myshopify.com domain"),
+  plan: z73.object({
+    displayName: z73.string().describe("Current plan name"),
+    partnerDevelopment: z73.boolean().describe("Whether partner development store")
+  }).describe("Store plan details"),
+  currencyCode: z73.string().describe("Store currency code (e.g., USD, EUR)"),
+  timezone: z73.string().describe("Store IANA timezone"),
+  contactEmail: z73.string().describe("Store contact email")
+});
+async function handleGetStoreInfo(context, _params) {
+  log.debug(`Getting store info for shop: ${context.shopDomain}`);
+  return await getStoreInfo();
+}
+function registerGetStoreInfoTool() {
+  registerContextAwareTool(
+    {
+      name: "get-store-info",
+      title: "Get Store Info",
+      description: "Get basic information about the connected Shopify store including name, domain, plan, currency, timezone, and contact email. **Prerequisites:** None. **Use this** to understand store context before performing operations.",
+      inputSchema: inputSchema71,
+      outputSchema: outputSchema71,
+      category: "store",
+      relationships: {
+        relatedTools: [],
+        followUps: ["list-products", "list-collections"]
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    handleGetStoreInfo
+  );
+}
+
 // src/tools/index.ts
 function setupToolHandlers(server) {
   server.server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -12609,6 +12729,7 @@ function registerAllTools(server) {
   registerBulkDeleteRedirectsBySearchTool();
   registerImportRedirectsTool();
   registerSubmitRedirectImportTool();
+  registerGetStoreInfoTool();
   const toolCount = getRegisteredTools().length;
   log.debug(`Tool registration complete: ${toolCount} tools registered`);
 }

package/package.json

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