webcake-storefront-mcp 1.10.0 → 1.11.1

package/dist/api.js

@@ -76,6 +76,13 @@ export class WebcakeCmsApi {
     createSite(params) {
         return this.request("POST", `/api/v1/dashboard/site/create`, { body: params, timeout: 60000 });
     }
+    /** 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}/`);
     }

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "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",
+    "type": "Added",
+    "en": "New create_site_from_template tool clones a marketplace template (all its pages, page-sources, and settings) into a new account-owned site, switches…",
+    "vi": "Tool mới create_site_from_template nhân bản một template marketplace (toàn bộ trang, page-source và cài đặt) thành một site mới thuộc tài khoản hiện…"
+  },
   {
     "v": "1.10.0",
     "d": "24/06/2026",
@@ -26,19 +40,5 @@
     "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à…"
-  },
-  {
-    "v": "1.5.1",
-    "d": "23/06/2026",
-    "type": "Fixed",
-    "en": "build_page now passes the finalized page source to create_page in the initial create call (required by the backend), then sets slug and is_homepage…",
-    "vi": "build_page nay truyền source trang đã hoàn thiện vào lời gọi create_page ban đầu (bắt buộc bởi backend), sau đó đặt slug và is_homepage qua một lời…"
   }
 ]

package/dist/tools/site-style.js

@@ -1,4 +1,6 @@
 import { z } from "zod";
+import { setConfig } from "../db.js";
+import { resolvePreviewUrl } from "../config.js";
 const TEMPLATE_THEMES_URL = "https://api.storecake.io/api/v1/templates/list_themes";
 const THEME_CATALOG_TTL_MS = 60 * 60 * 1000;
 const FETCH_TIMEOUT_MS = 15000;
@@ -152,6 +154,57 @@ export function registerSiteStyleTools(server, api, handle) {
                 description_en: desc.description_en,
             };
         });
-        return { query: q, count: matches.length, matches };
+        return {
+            query: q,
+            count: matches.length,
+            matches,
+            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 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().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 creating it (saved for next session)"),
+    }, ({ name, theme_id, slug, switch_to }) => handle(async () => {
+        let res;
+        try {
+            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(`Creating the site from the template failed: ${msg}. Check the theme_id exists (list_template_themes / semantic_search_themes).`);
+        }
+        const data = res?.data || res;
+        const newSite = data?.site || data?.new_site || data;
+        const newId = newSite?.id;
+        if (!newId)
+            throw new Error("Site created from template but no id was returned.");
+        let switched = false;
+        let previewUrl = null;
+        const previousSiteId = api.siteId;
+        if (switch_to) {
+            api.switchSite(newId);
+            setConfig("site_id", newId);
+            setConfig("site_name", newSite?.name || name);
+            switched = true;
+            previewUrl = await resolvePreviewUrl(api).catch(() => null);
+        }
+        return {
+            success: true,
+            site_id: newId,
+            name: newSite?.name || name,
+            from_template: theme_id,
+            switched,
+            ...(switched ? { current_site_id: api.siteId, previous_site_id: previousSiteId } : {}),
+            preview_url: previewUrl,
+            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.10.0",
+  "version": "1.11.1",
   "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",