webcake-storefront-mcp 1.11.1 → 1.12.0

package/dist/api.js

@@ -334,6 +334,27 @@ export class WebcakeCmsApi {
             timeout: 60000,
         });
     }
+    /** Update a product. Body wraps fields in `product_params` and identifies the product by
+     *  product_params.product_id. */
+    updateProduct(productParams) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/update`, {
+            body: { site_id: this.siteId, product_params: productParams },
+            timeout: 60000,
+        });
+    }
+    /** Delete products by id. Body: { site_id, ids }. */
+    removeProducts(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/remove`, {
+            body: { site_id: this.siteId, ids },
+            timeout: 60000,
+        });
+    }
+    /** Publish/unpublish products. Body: { site_id, data: [{ product_id, is_published }] }. */
+    setProductsPublished(data) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/published`, {
+            body: { site_id: this.siteId, data },
+        });
+    }
     /** Create a product category. Command-based: pass a `commands` array whose entries each
      *  carry a caller-generated `data.id` (the new category id). Response is generic. */
     createProductCategory(commands) {
@@ -342,6 +363,21 @@ export class WebcakeCmsApi {
             timeout: 60000,
         });
     }
+    /** Update a product category — command-based (name_category / image_category /
+     *  multi_description / set_category_visible), each command's data.id = the category id. */
+    updateProductCategory(commands) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/categories/update`, {
+            body: { site_id: this.siteId, commands },
+            timeout: 60000,
+        });
+    }
+    /** Delete product categories — command bulk_delete_category with data.ids. */
+    deleteProductCategory(commands) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/categories/delete`, {
+            body: { site_id: this.siteId, commands },
+            timeout: 60000,
+        });
+    }
     // ── Orders ──
     listOrders(query) {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/orders/all`, { query });

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.12.0",
+    "d": "24/06/2026",
+    "type": "Added",
+    "en": "New update_product tool updates an existing product's name, description, images, category_ids, is_published flag, or variations (price/stock/SKU per…",
+    "vi": "Tool mới update_product cập nhật name, description, images, category_ids, cờ is_published hoặc variations (giá/tồn kho/SKU theo từng biến thể) của…"
+  },
   {
     "v": "1.11.1",
     "d": "24/06/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "New list_automations tool returns each automation's id, name, status, and trigger info so agents can find the automation_id required by send_mail or…",
     "vi": "Tool mới list_automations trả về id, name, status và thông tin trigger của từng automation, giúp agent tìm được automation_id cần truyền vào…"
-  },
-  {
-    "v": "1.7.0",
-    "d": "23/06/2026",
-    "type": "Changed",
-    "en": "The web guide landing page (served via the serve command) is reframed to lead on full-storefront creation: the hero, meta description, \"What you…",
-    "vi": "Trang web guide (phục vụ qua lệnh serve) được viết lại để làm nổi bật việc xây dựng toàn bộ cửa hàng: hero, meta description, thư viện \"Bạn dựng…"
   }
 ]

package/dist/tools/catalog-write.js

@@ -126,4 +126,84 @@ Returns the new category id — pass it to create_product's category_ids. Image
         await api.createBlogCategory(commands);
         return { success: true, category_id: id, name };
     }));
+    // ── Edits: products & product categories ─────────────────────────────────────
+    server.tool("update_product", `Update an existing product. Pass product_id + only the fields to change. To change
+price/stock, pass variations (get_product first to see the existing variation shape).
+Images must be hosted CDN urls (search_images cdn_url / upload_images).`, {
+        product_id: z.string().describe("Product id to update"),
+        name: z.string().optional().describe("New name"),
+        description: z.string().optional().describe("New description (HTML allowed)"),
+        images: z.array(z.string()).optional().describe("New hosted image URLs; first becomes the thumbnail"),
+        category_ids: z.array(z.string()).optional().describe("Replace the product's categories"),
+        is_published: z.boolean().optional().describe("Publish/unpublish the product"),
+        variations: z.array(variationSpec).optional().describe("Replace variations (price/stock/SKU per variant). Reuse existing custom_ids from get_product to edit in place."),
+    }, ({ product_id, name, description, images, category_ids, is_published, variations }) => handle(async () => {
+        const productParams = { product_id };
+        if (name != null)
+            productParams.name = name;
+        if (description != null)
+            productParams.description = description;
+        if (images)
+            productParams.image = images[0];
+        if (category_ids) {
+            productParams.categories = category_ids;
+            productParams.ribbons = [];
+        }
+        if (is_published != null)
+            productParams.is_published = is_published;
+        if (variations) {
+            productParams.variations = variations.map((v) => ({
+                custom_id: v.custom_id || `SKU-${randomUUID().slice(0, 8)}`,
+                retail_price: v.retail_price,
+                original_price: v.original_price ?? v.retail_price,
+                remain_quantity: v.remain_quantity ?? 100,
+                images: v.images || (images ? images : []),
+                weight: v.weight ?? 0,
+                fields: v.fields || [],
+                is_hidden: false,
+            }));
+        }
+        await api.updateProduct(productParams);
+        return { success: true, product_id, updated: Object.keys(productParams).filter((k) => k !== "product_id") };
+    }));
+    server.tool("set_product_published", "Publish or unpublish one or more products quickly (without a full update).", {
+        product_ids: z.array(z.string()).describe("Product ids"),
+        is_published: z.boolean().describe("true = publish (visible), false = hide"),
+    }, ({ product_ids, is_published }) => handle(async () => {
+        await api.setProductsPublished(product_ids.map((product_id) => ({ product_id, is_published })));
+        return { success: true, product_ids, is_published };
+    }));
+    server.tool("delete_product", "Delete one or more products by id.", {
+        product_ids: z.array(z.string()).describe("Product ids to delete"),
+    }, ({ product_ids }) => handle(async () => {
+        await api.removeProducts(product_ids);
+        return { success: true, deleted: product_ids };
+    }));
+    server.tool("update_product_category", "Update a product category (name, image, description, or visibility). Pass id + fields to change.", {
+        id: z.string().describe("Category id"),
+        name: z.string().optional().describe("New name"),
+        image: z.string().optional().describe("New hosted image URL"),
+        description: z.string().optional().describe("New description"),
+        hidden: z.boolean().optional().describe("Hide (true) or show (false) the category"),
+    }, ({ id, name, image, description, hidden }) => handle(async () => {
+        const commands = [];
+        if (name != null)
+            commands.push({ name: "name_category", data: { id, name } });
+        if (image != null)
+            commands.push({ name: "image_category", data: { id, image } });
+        if (description != null)
+            commands.push({ name: "multi_description", data: { id, multi_description: [{ id: randomUUID(), title: name || "", description }] } });
+        if (hidden != null)
+            commands.push({ name: "set_category_visible", data: { id, is_hidden: hidden } });
+        if (!commands.length)
+            throw new Error("Nothing to update — pass at least one of name/image/description/hidden.");
+        await api.updateProductCategory(commands);
+        return { success: true, category_id: id, updated: commands.map((c) => c.name) };
+    }));
+    server.tool("delete_product_category", "Delete one or more product categories by id.", {
+        ids: z.array(z.string()).describe("Category ids to delete"),
+    }, ({ ids }) => handle(async () => {
+        await api.deleteProductCategory([{ name: "bulk_delete_category", data: { ids } }]);
+        return { success: true, deleted: ids };
+    }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "MCP server for the WebCake/StoreCake storefront builder — page CRUD, page authoring, products, orders, and more",
   "mcpName": "io.github.vuluu2k/webcake-storefront-mcp",
   "license": "MIT",