webcake-storefront-mcp 1.10.0 → 1.11.0

package/dist/api.js

@@ -76,6 +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 });
+    }
     getSiteInfo() {
         return this.request("GET", `/api/v1/site/${this.siteId}/`);
     }

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "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",
@@ -33,12 +40,5 @@
     "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;
@@ -50,6 +52,7 @@ 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)
@@ -143,6 +146,7 @@ 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,
@@ -152,6 +156,76 @@ 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 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.`, {
+        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)"),
+        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));
+        try {
+            await api.duplicateSite({ site_id: sourceSiteId, 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}`);
+        }
+        const after = await listIds();
+        const fresh = after.filter((s) => !beforeIds.has(s.id));
+        const newSite = fresh.find((s) => s.name === name) || fresh[0];
+        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.");
+        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: theme_id || null, source_site_id: sourceSiteId },
+            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.",
+        };
     }));
 }

package/package.json

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