webcake-storefront-mcp 1.31.12 → 1.32.0

package/dist/api.js

@@ -485,6 +485,18 @@ export class WebcakeCmsApi {
             timeout: 60000,
         });
     }
+    /** All blog categories (dashboard; includes meta_tags). */
+    listBlogCategories() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/blog/categories/all`);
+    }
+    /** Update blog categories — same command pipeline as create (name_category / description_category /
+     *  image_category / set_category_custom_slug / set_category_seo …), each with data.id. */
+    updateBlogCategory(commands) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/blog/categories/update`, {
+            body: { site_id: this.siteId, commands },
+            timeout: 60000,
+        });
+    }
     /** Create a blog article via the dashboard command pipeline (supports category linkage,
      *  images, summary, content). Caller generates the article id in each command's data.id. */
     createBlogArticle(commands) {

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.32.0",
+    "d": "14/10/2026",
+    "type": "Changed",
+    "en": "The server now serves a raster PNG icon (/favicon.ico, /favicon.png, /icon.png, /apple-touch-icon.png) alongside the existing SVG favicon, and…",
+    "vi": "Server nay phục vụ thêm icon dạng raster PNG (/favicon.ico, /favicon.png, /icon.png, /apple-touch-icon.png) bên cạnh favicon SVG hiện có, và khai…"
+  },
+  {
+    "v": "1.31.13",
+    "d": "09/10/2026",
+    "type": "Added",
+    "en": "create_product, update_product, create_product_category, update_product_category, and create_blog_category accept a new seo object to write…",
+    "vi": "create_product, update_product, create_product_category, update_product_category và create_blog_category nay nhận thêm đối tượng seo để ghi…"
+  },
   {
     "v": "1.31.12",
     "d": "09/10/2026",
@@ -26,19 +40,5 @@
     "type": "Added",
     "en": "Pages created by create_page, build_page, and commit_page_draft are now stamped with by_ai: \"mcp\" (persisted to the backend pages.by_ai column) so…",
     "vi": "Các trang được tạo bởi create_page, build_page và commit_page_draft nay được đánh dấu by_ai: \"mcp\" (lưu vào cột pages.by_ai ở backend) để builder có…"
-  },
-  {
-    "v": "1.31.8",
-    "d": "29/06/2026",
-    "type": "Fixed",
-    "en": "Elements placed by new_section, new_row, and build_page that fill their grid cell (text, image, container, columns, repeaters) now receive…",
-    "vi": "Các phần tử được đặt bởi new_section, new_row và build_page mà lấp đầy ô lưới (text, image, container, columns, repeaters) nay nhận constraintX:…"
-  },
-  {
-    "v": "1.31.7",
-    "d": "26/06/2026",
-    "type": "Fixed",
-    "en": "build_page, create_page, update_page, and commit_page_draft now strip a leading / from slug before saving; a slug like /cart would previously 404 on…",
-    "vi": "build_page, create_page, update_page và commit_page_draft nay tự động loại bỏ dấu / đầu dòng khỏi slug trước khi lưu; các slug kiểu /cart trước đây…"
   }
 ]

package/dist/http.js

@@ -11,7 +11,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import { createServer } from "./server.js";
 import { makeApi, resolveEnv, ENVIRONMENTS, DEFAULT_ENV } from "./config.js";
-import { landingHtml, faviconSvg, ogImageSvg, normalizeLang } from "./web-guide.js";
+import { landingHtml, faviconSvg, ogImageSvg, normalizeLang, ICON_PNG } from "./web-guide.js";
 import { privacyHtml, termsHtml } from "./legal.js";
 import { registerClient, startAuthorize, completeAuthorize, exchangeToken, resolveAccessToken, revokeToken, authServerMetadata, protectedResourceMetadata, } from "./auth/oauth-server.js";
 const MCP_PATH = "/mcp";
@@ -291,7 +291,14 @@ export async function startHttpServer(port) {
     const httpServer = createHttpServer(async (req, res) => {
         const path = (req.url ?? "").split("?")[0];
         // ---- Favicon / brand icon ----
-        if (req.method === "GET" && (path === "/favicon.ico" || path === "/favicon.svg")) {
+        // Google s2 (what the claude.ai connector list uses) skips SVG favicons and shows a
+        // globe, so /favicon.ico and friends serve the raster src/icon.png (→ dist/icon.png).
+        if ((req.method === "GET" || req.method === "HEAD") && ["/favicon.ico", "/favicon.png", "/icon.png", "/apple-touch-icon.png"].includes(path)) {
+            res.writeHead(200, { "content-type": "image/png", "cache-control": "public, max-age=86400" });
+            res.end(ICON_PNG);
+            return;
+        }
+        if (req.method === "GET" && path === "/favicon.svg") {
             res.writeHead(200, { "content-type": "image/svg+xml", "cache-control": "public, max-age=86400" });
             res.end(faviconSvg());
             return;

package/dist/server.js

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { installTools, buildToolGroupIndex } from "./tools/registry.js";
+import { ICON_PNG } from "./web-guide.js";
 /** Server version, read from package.json so it always tracks the published release. */
 export const SERVER_VERSION = (() => {
     try {
@@ -36,7 +37,14 @@ function makeResult(data) {
 /** Build a fully-wired MCP server bound to the given API client. */
 export function createServer(api, opts = {}) {
     const toolsSpec = opts.tools ?? process.env.WEBCAKE_TOOLS;
-    const server = new McpServer({ name: "webcake-storefront", version: SERVER_VERSION }, { instructions: `${INSTRUCTIONS}\n\n${buildToolGroupIndex(toolsSpec)}` });
+    const server = new McpServer({
+        name: "webcake-storefront",
+        version: SERVER_VERSION,
+        // Shown by MCP clients (e.g. claude.ai connectors) instead of a generic globe.
+        title: "WebCake Storefront",
+        websiteUrl: "https://webcake.io",
+        icons: [{ src: `data:image/png;base64,${ICON_PNG.toString("base64")}`, mimeType: "image/png", sizes: ["192x192"] }],
+    }, { instructions: `${INSTRUCTIONS}\n\n${buildToolGroupIndex(toolsSpec)}` });
     const handle = async (fn) => {
         try {
             return makeResult(await fn());

package/dist/tools/articles.js

@@ -79,14 +79,22 @@ export const seoSchema = z
         .array(z.object({ name: z.string().describe("Display name"), json: z.string().describe("JSON-LD object as a string, without <script>") }))
         .optional()
         .describe("Structured data markup (JSON-LD). REPLACES all existing markups; [] removes them."),
+    custom_tags: z
+        .array(z.object({ type: z.enum(["meta", "link"]).default("meta"), props: z.record(z.string()) }))
+        .optional()
+        .describe('Extra tags ("Thẻ bổ sung"), e.g. { "type": "meta", "props": { "name": "author", "content": "Togi" } }. Replaces a tag with the same name/property/rel.'),
+    remove_tags: z.array(z.string()).optional().describe('Remove tags by name/property/rel, e.g. ["author", "og:url"]'),
 })
     .optional()
     .describe("SEO settings (\"Cài đặt SEO\": basic, social share, advanced). Without a meta description the site falls back to the whole body text.");
 /** The SEO save replaces the whole meta_tags array, so merge into the existing tags: passed
  *  fields overwrite their tag, "" removes it, structured_data replaces all JSON-LD scripts,
  *  everything else (custom tags) is kept. */
+const tagKey = (t) => t?.props?.name || t?.props?.property || t?.props?.rel || t?.props?.["http-equiv"];
 export function mergeSeoTags(seo, existing = []) {
     let tags = [...existing];
+    if (seo.remove_tags)
+        tags = tags.filter((t) => !seo.remove_tags.includes(tagKey(t)));
     for (const [key, def] of Object.entries(SEO_TAGS)) {
         const value = seo[key];
         if (value === undefined)
@@ -100,6 +108,10 @@ export function mergeSeoTags(seo, existing = []) {
         for (const m of seo.structured_data)
             tags.push({ type: "script", props: { type: "application/ld+json" }, meta: { displayName: m.name }, children: m.json });
     }
+    for (const t of seo.custom_tags || []) {
+        tags = tags.filter((x) => tagKey(x) !== tagKey(t));
+        tags.push({ type: t.type || "meta", props: t.props });
+    }
     return tags;
 }
 export function registerArticleTools(server, api, handle) {

package/dist/tools/catalog-write.js

@@ -37,6 +37,21 @@ async function applyProductSeo(api, id, seo) {
     const p = res?.data || res?.product || res;
     await api.setProductSeo(id, mergeSeoTags(seo, p?.meta_tags || []), p?.slug ?? null);
 }
+/** Find a category's current meta_tags in a list response (flat or tree-shaped). */
+function findMetaTags(res, id) {
+    const stack = [res];
+    while (stack.length) {
+        const x = stack.pop();
+        if (Array.isArray(x))
+            stack.push(...x);
+        else if (x && typeof x === "object") {
+            if (x.id === id && "meta_tags" in x)
+                return x.meta_tags || [];
+            stack.push(...Object.values(x).filter((v) => v && typeof v === "object"));
+        }
+    }
+    return [];
+}
 export function registerCatalogWriteTools(server, api, handle) {
     server.tool("create_product", `Create a product so the storefront has real merchandise (grid-product / slider-product bindings need this).
 Simple use: pass name + price (+ images, category_ids). One default variation with the price/stock is created for you.
@@ -151,7 +166,8 @@ Returns the new category id — pass it to create_product's category_ids. Image
         image: z.string().optional().describe("Hosted image URL for the category card"),
         description: z.string().optional().describe("Category description"),
         parent_id: z.string().optional().describe("Parent category id for a sub-category"),
-    }, ({ name, image, description, parent_id }) => handle(async () => {
+        seo: seoSchema,
+    }, ({ name, image, description, parent_id, seo }) => handle(async () => {
         const id = randomUUID();
         const commands = [
             { name: "create_category", data: { id, name, ...(parent_id ? { parent_id } : {}) } },
@@ -164,6 +180,8 @@ Returns the new category id — pass it to create_product's category_ids. Image
                 data: { id, multi_description: [{ id: randomUUID(), title: name, description }] },
             });
         }
+        if (seo)
+            commands.push({ name: "set_category_seo", data: { id, meta_tags: mergeSeoTags(seo) } });
         await api.createProductCategory(commands);
         return { success: true, category_id: id, name, ...(parent_id ? { parent_id } : {}) };
     }));
@@ -171,16 +189,44 @@ Returns the new category id — pass it to create_product's category_ids. Image
         name: z.string().describe("Blog category name"),
         image: z.string().optional().describe("Hosted image URL"),
         description: z.string().optional().describe("Category description"),
-    }, ({ name, image, description }) => handle(async () => {
+        seo: seoSchema,
+    }, ({ name, image, description, seo }) => handle(async () => {
         const id = randomUUID();
         const commands = [{ name: "create_category", data: { id, name } }];
         if (description)
             commands.push({ name: "description_category", data: { id, description } });
         if (image)
             commands.push({ name: "image_category", data: { id, image } });
+        if (seo)
+            commands.push({ name: "set_category_seo", data: { id, meta_tags: mergeSeoTags(seo) } });
         await api.createBlogCategory(commands);
         return { success: true, category_id: id, name };
     }));
+    server.tool("update_blog_category", "Update a blog/article category (name, description, image, slug, SEO). Pass id + fields to change.", {
+        id: z.string().describe("Blog category id"),
+        name: z.string().optional().describe("New name"),
+        description: z.string().optional().describe("New description"),
+        image: z.string().optional().describe("New hosted image URL"),
+        slug: z.string().optional().describe("New custom slug"),
+        seo: seoSchema.describe("SEO settings to change; other existing SEO tags are kept. Pass \"\" to clear a field."),
+    }, ({ id, name, description, image, slug, seo }) => handle(async () => {
+        const commands = [];
+        // name_category may rewrite the slug, so the custom slug goes after it.
+        if (name != null)
+            commands.push({ name: "name_category", data: { id, name } });
+        if (slug != null)
+            commands.push({ name: "set_category_custom_slug", data: { id, custom_slug: slug } });
+        if (description != null)
+            commands.push({ name: "description_category", data: { id, description } });
+        if (image != null)
+            commands.push({ name: "image_category", data: { id, image } });
+        if (seo)
+            commands.push({ name: "set_category_seo", data: { id, meta_tags: mergeSeoTags(seo, findMetaTags(await api.listBlogCategories(), id)) } });
+        if (!commands.length)
+            throw new Error("Nothing to update — pass at least one field besides id.");
+        await api.updateBlogCategory(commands);
+        return { success: true, category_id: id, updated: commands.map((c) => c.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).
@@ -243,13 +289,14 @@ Images must be hosted CDN urls (search_images cdn_url / upload_images).`, {
         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.", {
+    server.tool("update_product_category", "Update a product category (name, image, description, visibility, SEO). 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 () => {
+        seo: seoSchema.describe("SEO settings to change; other existing SEO tags are kept. Pass \"\" to clear a field."),
+    }, ({ id, name, image, description, hidden, seo }) => handle(async () => {
         const commands = [];
         if (name != null)
             commands.push({ name: "name_category", data: { id, name } });
@@ -259,8 +306,10 @@ Images must be hosted CDN urls (search_images cdn_url / upload_images).`, {
             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 (seo)
+            commands.push({ name: "set_category_seo", data: { id, meta_tags: mergeSeoTags(seo, findMetaTags(await api.listCategories(), id)) } });
         if (!commands.length)
-            throw new Error("Nothing to update — pass at least one of name/image/description/hidden.");
+            throw new Error("Nothing to update — pass at least one of name/image/description/hidden/seo.");
         await api.updateProductCategory(commands);
         return { success: true, category_id: id, updated: commands.map((c) => c.name) };
     }));

package/dist/tools/multilingual.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { seoSchema, mergeSeoTags } from "./articles.js";
 // Multilingual app (Enum.Application multilingual = 5). Install first via
 // install_app({ app: "multilingual" }), then enable languages. Each resource type
 // (product, category, article, …) has its own translations list + save endpoint.
@@ -60,6 +61,40 @@ For most resources \`items\` is an array of translation rows. For 'site' pass th
             body = { [def.field || `${resource}_translations`]: items, language_code };
         return api.mlSaveTranslations(def.action, body);
     }));
+    server.tool("set_translation_seo", `Set the SEO ("Cài đặt SEO") of ONE item's translation in a target language — product, article,
+product category or blog category. Same fields as the item's own seo param; merged into that
+translation's existing SEO tags (fields you don't pass are kept). Only meta_tags is written, so the
+translated name/slug/content are untouched; the translation row is created if missing.`, {
+        resource: z.enum(["product", "article", "category", "article_category"]).describe("category = product category, article_category = blog category"),
+        id: z.string().describe("Item id (product / article / category id)"),
+        language_code: z.string().describe("Target language code, e.g. 'en'"),
+        seo: seoSchema.unwrap(),
+    }, ({ resource, id, language_code, seo }) => handle(async () => {
+        const path = `${resource}_translations`;
+        // The list API only filters by name (term), so scan pages to find the row by id.
+        // ponytail: up to 50 pages × 100 items; add an id filter on the backend if sites outgrow it.
+        let row;
+        for (let page = 1; page <= 50 && !row; page++) {
+            const box = unwrap(await api.mlGetTranslations(path, { language_code, page, limit: 100 }), path);
+            const rows = box?.data || [];
+            row = rows.find((r) => r.id === id);
+            if (rows.length < 100)
+                break;
+        }
+        const tr = row?.[`${resource}_translation`];
+        const idKey = resource === "article_category" ? "category_id" : `${resource}_id`;
+        const meta_tags = mergeSeoTags(seo, tr?.meta_tags || []);
+        const item = { [idKey]: id, site_id: api.siteId, meta_tags };
+        // Article / category / blog-category saves read `name` unconditionally (and re-derive the
+        // translated slug from it), so resend the current translated name, else the original one.
+        if (resource !== "product") {
+            item.name = tr?.name || row?.name;
+            if (!item.name)
+                throw new Error(`${resource} ${id} not found in the ${language_code} translation list.`);
+        }
+        await api.mlSaveTranslations(SAVE[resource].action, { [path]: [item], language_code });
+        return { success: true, resource, id, language_code, meta_tags };
+    }));
     server.tool("auto_translate", `Machine-translate a JSON blob from one language to another. \`type\` must be a valid translation
 type (e.g. 'product', 'category'). Returns { trans, count }.`, {
         type: z.string().describe("Translation type, e.g. 'product'"),

package/dist/web-guide.js

@@ -564,6 +564,7 @@ export function guideHtml(origin, lang = "vi") {
 <link rel="alternate" hreflang="vi" href="${origin}/">
 <link rel="alternate" hreflang="en" href="${origin}/?lang=en">
 <link rel="alternate" hreflang="x-default" href="${origin}/">
+<link rel="icon" type="image/png" sizes="192x192" href="/favicon.png">
 <link rel="icon" type="image/svg+xml" href="/favicon.svg">
 <meta property="og:type" content="website">
 <meta property="og:site_name" content="WebCake Storefront MCP">
@@ -1032,6 +1033,8 @@ export function ogImageSvg() {
  * Favicon SVG — the branded "S" mark with yellow dot.
  * Served at /favicon.svg and /favicon.ico by http.ts.
  */
+// Raster icon (192px, generated from ICON_SVG) — shared by /favicon.ico and serverInfo.icons.
+export const ICON_PNG = readFileSync(new URL("./icon.png", import.meta.url));
 export function faviconSvg() {
     return ICON_SVG;
 }

package/package.json

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