webcake-storefront-mcp 1.11.0 → 1.12.0

package/dist/api.js

@@ -76,11 +76,12 @@ export class WebcakeCmsApi {
     createSite(params) {
         return this.request("POST", `/api/v1/dashboard/site/create`, { body: params, timeout: 60000 });
     }
-    /** Duplicate an existing site (its settings AND all pages/page-sources) into a NEW site
-     *  owned by the current account. Used to spin up a site FROM a marketplace template
-     *  (pass the template's source site id). Body: { site_id (source), name, slug? }. */
-    duplicateSite(params) {
-        return this.request("POST", `/api/v1/dashboard/site/duplicate`, { body: params, timeout: 90000 });
+    /** Create a NEW site from a marketplace TEMPLATE by its theme id — the dedicated
+     *  "use this template" API. Clones the template's pages, global sections, cart, popups,
+     *  styles and fonts into a fresh account-owned site. Body: { id: <theme_id>, name, slug }.
+     *  Returns { data: { site: { id, ... } } }. (403 if the free 4-site quota is reached, prod.) */
+    importStoreToTheme(params) {
+        return this.request("POST", `/api/v1/dashboard/site/import_store_to_theme`, { body: params, timeout: 120000 });
     }
     getSiteInfo() {
         return this.request("GET", `/api/v1/site/${this.siteId}/`);
@@ -333,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) {
@@ -341,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,18 @@
 [
+  {
+    "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",
+    "type": "Fixed",
+    "en": "create_site_from_template now calls the dedicated import_store_to_theme API instead of the generic site-duplicate endpoint, correctly cloning the…",
+    "vi": "create_site_from_template nay gọi đúng API import_store_to_theme thay vì endpoint nhân bản site thông thường, giúp clone đầy đủ các trang, global…"
+  },
   {
     "v": "1.11.0",
     "d": "24/06/2026",
@@ -26,19 +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…"
-  },
-  {
-    "v": "1.6.0",
-    "d": "23/06/2026",
-    "type": "Added",
-    "en": "get_element now returns an attributes field with a curated per-element reference covering the meaningful specials, config, events, and bindings keys…",
-    "vi": "get_element nay trả về trường attributes chứa tài liệu tham chiếu theo từng loại element, bao gồm các key có ý nghĩa của specials, config, events và…"
   }
 ]

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/dist/tools/site-style.js

@@ -52,7 +52,6 @@ async function getThemeCatalog(force = false) {
                 preview_url: t.preview_url || "",
                 thumbnail: t.thumbnail || "",
                 categories: (t.categories || []).map((c) => c.name).filter(Boolean),
-                site_id: (t.site && t.site.id) || undefined,
             });
         }
         if (themes.length < limit)
@@ -146,7 +145,6 @@ export function registerSiteStyleTools(server, api, handle) {
             const desc = parseThemeDescription(te && te.description);
             return {
                 theme_id: themeId,
-                template_site_id: info.site_id || null, // pass to create_site_from_template
                 score: typeof score === "number" ? Number(score.toFixed(4)) : null,
                 name: info.name || null,
                 preview_url: info.preview_url || null,
@@ -163,50 +161,31 @@ export function registerSiteStyleTools(server, api, handle) {
             hint: "Pick one and call create_site_from_template with its theme_id (or template_site_id) to clone it into a new editable site.",
         };
     }));
-    server.tool("create_site_from_template", `Create a NEW site by CLONING a marketplace template (all its pages + settings), so the
-customer starts from a finished design and then edits it. Resolve a template with
-semantic_search_themes / list_template_themes first, then pass its theme_id (or
-template_site_id). After cloning, switch to the new site and edit layout/content with
-update_page_element(s), colours/typography with the site-style tools, and republish.`, {
+    server.tool("create_site_from_template", `Create a NEW site from a marketplace TEMPLATE (the dedicated "use this template" API).
+Clones the template's pages, global sections, cart, popups, styles and fonts into a fresh
+site. Pick a template with semantic_search_themes / list_template_themes, then pass its
+theme_id here. Switches to the new site so you can immediately edit layout/content with
+update_page_element(s), colours/fonts via the site-style tools, then publish_site.`, {
         name: z.string().describe("Name for the new site"),
-        theme_id: z.string().optional().describe("Marketplace theme id (from semantic_search_themes / list_template_themes)"),
-        template_site_id: z.string().optional().describe("The template's source site id (alternative to theme_id; semantic_search_themes returns it as template_site_id)"),
+        theme_id: z.string().describe("Marketplace theme id (from semantic_search_themes / list_template_themes)"),
         slug: z.string().optional().describe("URL-safe slug for the new site (auto-generated if omitted)"),
-        switch_to: z.boolean().default(true).describe("Switch the session to the new site after cloning (saved for next session)"),
-    }, ({ name, theme_id, template_site_id, slug, switch_to }) => handle(async () => {
-        // Resolve the template's source site id.
-        let sourceSiteId = template_site_id;
-        if (!sourceSiteId && theme_id) {
-            const catalog = await getThemeCatalog().catch(() => new Map());
-            sourceSiteId = catalog.get(theme_id)?.site_id;
-        }
-        if (!sourceSiteId) {
-            throw new Error("Could not resolve the template's source site. Pass template_site_id, or a theme_id that exists in the marketplace (list_template_themes / semantic_search_themes).");
-        }
-        // The duplicate endpoint returns success-only (no id), so snapshot the site list
-        // first, clone, then resolve the new site by diff.
-        const listIds = async () => {
-            const r = await api.listMySites({ page: 1, limit: 100 }).catch(() => null);
-            const arr = r?.data?.sites || r?.data || [];
-            return Array.isArray(arr) ? arr : [];
-        };
-        const before = await listIds();
-        const beforeIds = new Set(before.map((s) => s.id));
+        switch_to: z.boolean().default(true).describe("Switch the session to the new site after creating it (saved for next session)"),
+    }, ({ name, theme_id, slug, switch_to }) => handle(async () => {
+        let res;
         try {
-            await api.duplicateSite({ site_id: sourceSiteId, name, ...(slug ? { slug } : {}) });
+            res = await api.importStoreToTheme({ id: theme_id, name, ...(slug ? { slug } : {}) });
         }
         catch (e) {
             const msg = e instanceof Error ? e.message : String(e);
             if (msg.includes("403"))
                 throw new Error("Cannot create site: account site quota reached (free plan allows up to 4 sites).");
-            throw new Error(`Cloning the template failed: ${msg}`);
+            throw new Error(`Creating the site from the template failed: ${msg}. Check the theme_id exists (list_template_themes / semantic_search_themes).`);
         }
-        const after = await listIds();
-        const fresh = after.filter((s) => !beforeIds.has(s.id));
-        const newSite = fresh.find((s) => s.name === name) || fresh[0];
+        const data = res?.data || res;
+        const newSite = data?.site || data?.new_site || data;
         const newId = newSite?.id;
         if (!newId)
-            throw new Error("Template was cloned but the new site could not be located in your site list — check list_my_sites.");
+            throw new Error("Site created from template but no id was returned.");
         let switched = false;
         let previewUrl = null;
         const previousSiteId = api.siteId;
@@ -221,11 +200,11 @@ update_page_element(s), colours/typography with the site-style tools, and republ
             success: true,
             site_id: newId,
             name: newSite?.name || name,
-            from_template: { theme_id: theme_id || null, source_site_id: sourceSiteId },
+            from_template: theme_id,
             switched,
             ...(switched ? { current_site_id: api.siteId, previous_site_id: previousSiteId } : {}),
             preview_url: previewUrl,
-            next_step: "Site cloned with all template pages. Edit content with search_page_elements + update_page_element(s), change colours/fonts via list_themes/site-style, then publish_site.",
+            next_step: "Site created from the template (pages, sections, popups, styles, fonts). Edit content with search_page_elements + update_page_element(s), colours/fonts via list_themes/site-style, then publish_site.",
         };
     }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.11.0",
+  "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",