webcake-storefront-mcp 1.26.0 → 1.27.0

package/dist/api.js

@@ -491,8 +491,11 @@ export class WebcakeCmsApi {
     getActivePromotions() {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/promotion_advance/get_promotions_actived`);
     }
+    /** Search/list promotions. The dedicated get_promotions_advance endpoint 404s on prod, so
+     *  this uses the same /all list endpoint (which accepts a query); the tool filters the
+     *  returned page client-side for type/status/keyword. */
     searchPromotions(query) {
-        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/promotion_advance/get_promotions_advance`, { query });
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/promotion_advance/all`, { query });
     }
     // ── Combos ──
     listCombos(query) {

package/dist/builder/factory.js

@@ -1080,11 +1080,28 @@ export const createCoupon = (opts = {}) => {
     }
     return coupon;
 };
+// Real popups (mined from templates) keep TRIGGER/animation in specials (effect, timeAnim,
+// openPopupAction, timeOpenPopup, page_ids) and GEOMETRY in the per-breakpoint keys: config
+// holds popupHorizontalPosition/popupVerticalPosition, style holds width/height/background.
+// Seed sensible runtime defaults (a centred modal) so finalizeForRender expands them into bpN —
+// otherwise the popup renders with no size/position/background.
 export const createPopup = (opts = {}) => {
     const popup = cloneDeep(SKELETON);
     popup.id = 'POPUP-' + randomString(8);
     popup.type = 'popup';
     popup.specials = opts.specials || {};
+    popup.runtime.config = {
+        popupHorizontalPosition: 'center',
+        popupVerticalPosition: 'center',
+        heightUnit: 'auto',
+        ...(opts.config || {})
+    };
+    popup.runtime.style = {
+        width: 480,
+        background: '#ffffff',
+        borderRadius: '12px',
+        ...(opts.style || {})
+    };
     popup.children = opts.children || [];
     return popup;
 };

package/dist/builder/guide.js

@@ -69,8 +69,11 @@ already in this shape — see the \`responsive\` field on get_page_element/updat
 - \`runtime.style\` holds CSS-ish props: width/height (numbers = px), color, background,
   fontSize ("16px"), fontWeight, textAlign, border*, boxShadow, etc.
 - \`runtime.config.heightUnit\`: "auto" lets content set height (default for text/image).
-- Colours: prefer the site THEME variables \`var(--color_00)\`, \`var(--color_01)\`, …
-  (the published site themes them); plain hex or rgba() also work.
+- Colours: use the site THEME matrix vars \`var(--color_RC)\` (R=row 0-4, C=col 0-4). Row 0 is
+  greyscale: \`var(--color_00)\`=WHITE … \`var(--color_04)\`=BLACK. Row 2 is the BRAND row:
+  \`var(--color_20)\` is the brand primary. So TEXT = \`var(--color_04)\` (NOT color_00, that's white →
+  invisible), ACCENT/buttons/prices = \`var(--color_20)\` (darker shade \`var(--color_24)\` if you need
+  white-on-accent contrast), page background = \`var(--color_00)\`. Plain hex/rgba() also work.
 
 ## Make it look DESIGNED (not plain) — do this, every page
 A bare stack of default elements looks unfinished. Apply real styling:
@@ -82,8 +85,8 @@ A bare stack of default elements looks unfinished. Apply real styling:
 - TYPOGRAPHY hierarchy: h1 40–56px / fontWeight 700, h2 28–34px / 600, body 16–18px with
   lineHeight "1.6", muted color for sub-text. Center hero text (textAlign:"center").
 - BUTTONS HAVE NO DEFAULT COLOUR — you MUST style them or they look like plain text:
-  \`{ type:"button", opts:{ text:"Mua ngay", style:{ background:"var(--color_02)", color:"#fff",
-  borderRadius:"8px", fontWeight:"600", height:48 } } }\`.
+  \`{ type:"button", opts:{ text:"Mua ngay", style:{ background:"var(--color_20)", color:"var(--color_00)",
+  borderRadius:"8px", fontWeight:"600", height:48 } } }\` (brand background, white label).
 - HERO: prefer a section with a background image + an overlay heading/sub/button on top
   (set section_opts.style.background or a full-width image, then text centered), rather than a
   small image stacked above text.
@@ -96,8 +99,9 @@ A bare stack of default elements looks unfinished. Apply real styling:
   and \`opts.specials\`: { products_per_load:8-36, on_hover:"zoom"|"swap", show_rating, show_ribbon }.
   (There are NO cardBorderRadius/cardBoxShadow keys.) For variations use \`attr\` elements
   (attrName:"auto"); steppers are \`quantity-input\` (defaults spinner:"hide-spin").
-- BRAND COLOURS: reuse var(--color_00) (text), and an accent (var(--color_02)/var(--color_03))
-  for buttons, prices, highlights — consistent accent = looks intentional.
+- BRAND COLOURS: text = var(--color_04) (black), accent = var(--color_20) (brand) for buttons,
+  prices, highlights — consistent accent = looks intentional. (var(--color_00) is WHITE — only
+  for backgrounds / labels on the accent, never for text on a white surface.)
 - IMAGES: must be WebCake-CDN urls (search_images cdn_url / upload_images), else they won't show.
 
 ## Responsive breakpoints

package/dist/builder/templates.js

@@ -16,18 +16,55 @@
 import { buildSection, walk } from "./page.js";
 import { buildElement } from "./catalog.js";
 import { normalizeEvents } from "./events.js";
+// Slots map onto the site theme's 5×5 colour matrix, surfaced as CSS vars var(--color_RC)
+// (R=row, C=col). Row 0 is greyscale (00=white … 04=black); row 2 is the BRAND row. Using
+// var(--color_00) for text was a bug — that's WHITE (invisible on the white surface).
 const DEFAULT_PALETTE = {
-    accent: "var(--color_02)",
-    onAccent: "#ffffff",
-    text: "var(--color_00)",
-    muted: "#6b7280",
-    surface: "#ffffff",
-    surfaceAlt: "#f7f5f2",
-    border: "#e8e3dc",
+    accent: "var(--color_20)", // brand primary (row 2)
+    onAccent: "var(--color_00)", // white — label on the accent button
+    text: "var(--color_04)", // black — headings + body
+    muted: "var(--color_03)", // dark grey — secondary text
+    surface: "var(--color_00)", // white — page/card background
+    surfaceAlt: "var(--color_01)", // light grey — alternating band
+    border: "var(--color_01)", // hairline borders
 };
 export function resolvePalette(p = {}) {
     return { ...DEFAULT_PALETTE, ...Object.fromEntries(Object.entries(p).filter(([, v]) => v != null)) };
 }
+/** Relative luminance of a #hex colour (0 dark … 1 light). */
+function luminance(hex) {
+    const h = String(hex || "").replace("#", "").slice(0, 6);
+    if (h.length < 6)
+        return 0;
+    const r = parseInt(h.slice(0, 2), 16) / 255;
+    const g = parseInt(h.slice(2, 4), 16) / 255;
+    const b = parseInt(h.slice(4, 6), 16) / 255;
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+/**
+ * Read the site's active theme colour matrix and return a Palette override so generated pages
+ * stay BRAND-CONSISTENT and CONTRAST-SAFE. The default palette uses var(--color_20) (the brand
+ * seed) as the accent — but for a LIGHT brand seed (e.g. a beige store) a white button label on
+ * it is unreadable, so we switch the accent to var(--color_24) (the darkest brand shade). Best
+ * effort: returns {} on any error (the var(--color_NN) defaults still resolve per-site).
+ */
+export async function contrastSafePalette(api) {
+    try {
+        const res = await api.listThemes();
+        const themes = (res && res.data) || res || [];
+        const arr = Array.isArray(themes) ? themes : (themes.themes || []);
+        const th = arr.find((t) => t.is_selected) || arr[0];
+        const m = th && th.colors;
+        if (Array.isArray(m) && Array.isArray(m[2]) && m[2][0]) {
+            if (luminance(m[2][0]) > 0.62)
+                return { accent: "var(--color_24)" };
+        }
+    }
+    catch {
+        /* keep the var()-based defaults */
+    }
+    return {};
+}
 // ---------------------------------------------------------------------------
 // small spec helpers (return element specs for buildSection/buildRow children)
 // ---------------------------------------------------------------------------

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.27.0",
+    "d": "26/06/2026",
+    "type": "Added",
+    "en": "build_page now accepts an seo object (title, description, keyword, favicon, thumbnail) that is written to page.settings.seo with Open Graph…",
+    "vi": "build_page nay nhận thêm đối tượng seo (title, description, keyword, favicon, thumbnail) và ghi vào page.settings.seo kèm mirroring Open Graph; hỗ…"
+  },
+  {
+    "v": "1.26.1",
+    "d": "26/06/2026",
+    "type": "Fixed",
+    "en": "list_products now correctly unwraps the { products, total_product } API response shape, returning a product array and accurate total instead of…",
+    "vi": "list_products nay giải nén đúng kiểu phản hồi { products, total_product } từ API, trả về mảng sản phẩm và tổng chính xác thay vì trả thẳng đối tượng…"
+  },
   {
     "v": "1.26.0",
     "d": "26/06/2026",
@@ -26,19 +40,5 @@
     "type": "Added",
     "en": "get_build_guide now includes a category-page filter recipe explaining how sidebar filter widgets (checkbox-group, color-group, tags,…",
     "vi": "get_build_guide nay bổ sung công thức filter trang danh mục, giải thích cách các widget lọc trong sidebar (checkbox-group, color-group, tags,…"
-  },
-  {
-    "v": "1.22.0",
-    "d": "25/06/2026",
-    "type": "Added",
-    "en": "list_bindings now returns a meta_keys map documenting binding combine-keys mined from 34 production templates — name_style, attr_id, prefix_content,…",
-    "vi": "list_bindings nay trả về map meta_keys tài liệu hóa các combine-key liên kết dữ liệu được khai thác từ 34 template production — name_style, attr_id,…"
-  },
-  {
-    "v": "1.21.0",
-    "d": "25/06/2026",
-    "type": "Changed",
-    "en": "The grid-product factory now ships cross-industry neutral defaults (image_ratio:\"1/1\", gap_column/gap_row 24, products_per_load 12) instead of the…",
-    "vi": "Factory grid-product nay sử dụng các giá trị mặc định trung lập đa ngành (image_ratio:\"1/1\", gap_column/gap_row 24, products_per_load 12) thay vì…"
   }
 ]

package/dist/tools/builder.js

@@ -4,7 +4,7 @@ import { listElements, getElement, buildElement } from "../builder/catalog.js";
 import { describeEventsCatalog } from "../builder/events.js";
 import { describeBindingsCatalog } from "../builder/bindings.js";
 import { buildSection, buildRow, newPageSkeleton, validatePage, finalizeForRender, reassignIds, } from "../builder/page.js";
-import { STORE_PAGE_TEMPLATES, resolvePalette, wireNavigation } from "../builder/templates.js";
+import { STORE_PAGE_TEMPLATES, resolvePalette, contrastSafePalette, wireNavigation } from "../builder/templates.js";
 // Recursive spec for new_section / build_page children.
 const elementSpec = z.object({
     type: z.string().describe("Element type (see list_elements)"),
@@ -28,14 +28,39 @@ function newPageId(res) {
 // builderx_spa); SPECIAL kinds also require a site-level data-source flag enabled on
 // site.settings, otherwise components that bind to store/customer/blog data render
 // with null bindings. build_page sets both for you.
-const PAGE_TYPE_NUM = {
+// Page kind → numeric backend type. Exported so create_page maps the same way (the backend
+// type is numeric 1–7, NOT a string).
+export const PAGE_TYPE_NUM = {
     main: 1, store: 2, member: 3, blog: 4, custom: 5, error: 6, maintain: 7,
 };
 const PAGE_TYPE_FLAG = {
     store: "use_store", member: "use_member", blog: "use_blog",
     error: "use_error", maintain: "use_maintain",
 };
-const PAGE_KINDS = ["main", "store", "member", "blog", "custom", "error", "maintain"];
+export const PAGE_KINDS = ["main", "store", "member", "blog", "custom", "error", "maintain"];
+/** Build the page.settings.seo block from simple inputs (the real shape; tokens like
+ *  {{name_page}} / {{name_site}} are resolved by the storefront). */
+export function buildPageSeo(seo = {}) {
+    const out = {};
+    if (seo.title)
+        out.title = seo.title;
+    if (seo.description)
+        out.description = seo.description;
+    if (seo.keyword)
+        out.keyword = seo.keyword;
+    if (seo.favicon)
+        out.favicon = seo.favicon;
+    if (seo.thumbnail)
+        out.thumbnail = seo.thumbnail;
+    // Open Graph mirrors title/description/thumbnail when not given explicitly.
+    if (seo.title || seo.og_title)
+        out.og_title = seo.og_title || seo.title;
+    if (seo.description || seo.og_description)
+        out.og_description = seo.og_description || seo.description;
+    if (seo.thumbnail)
+        out.og_image = seo.thumbnail;
+    return out;
+}
 export function registerBuilderTools(server, api, handle) {
     server.tool("get_build_guide", "Get the BuilderX page authoring guide: page shape, the grid layout model, styling, breakpoints, forms/data, and the build workflow. Read this before building or heavily editing a page.", {}, () => handle(async () => ({ guide: BUILD_GUIDE })));
     server.tool("list_elements", "List all BuilderX element/component types you can place on a page, grouped by category with a one-line summary and whether each is a container.", {}, () => handle(async () => listElements()));
@@ -90,8 +115,18 @@ The source must be { sections: [...] } — build sections with new_section. Vali
             .optional()
             .describe("Page kind. SPECIAL pages need a site data-source enabled — build_page does this automatically: store→use_store (product/cart bindings), member→use_member (customer/order bindings), blog→use_blog, error→use_error, maintain→use_maintain. 'main'/'custom' need nothing. Omit for a normal content page (defaults to 'main' for the homepage)."),
         is_homepage: z.boolean().default(false).describe("Set as the site homepage"),
+        seo: z
+            .object({
+            title: z.string().optional().describe("SEO/browser title. Tokens allowed: {{name_page}}, {{name_site}}, {{name_product}}, {{name_category}}."),
+            description: z.string().optional().describe("Meta description (~155 chars)."),
+            keyword: z.string().optional().describe("Comma-separated keywords."),
+            favicon: z.string().optional().describe("Favicon URL (hosted)."),
+            thumbnail: z.string().optional().describe("Social/OG share image URL (hosted)."),
+        })
+            .optional()
+            .describe("SEO for this page → settings.seo. Without it the page publishes with an EMPTY title/description. For a store page a good default title is '{{name_product}} | {{name_site}}' (product) or '{{name_category}} | {{name_site}}' (category)."),
         dry_run: z.boolean().default(true).describe("Preview+validate only (true) or create+save (false)"),
-    }, ({ name, slug, source, type, is_homepage, dry_run }) => handle(async () => {
+    }, ({ name, slug, source, type, is_homepage, seo, dry_run }) => handle(async () => {
         const parsed = parseSource(source);
         const validation = validatePage(parsed);
         // Resolve numeric page type + the site data-source flag a special page needs.
@@ -132,10 +167,15 @@ The source must be { sections: [...] } — build sections with new_section. Vali
         if (!pageId) {
             return { error: "Page created but no id was returned.", created };
         }
-        // slug / homepage are not applied at create — set them via update_page.
-        if (slug || is_homepage) {
+        // slug / homepage / SEO are not applied at create — set them via update_page.
+        const seoBlock = seo ? buildPageSeo(seo) : null;
+        if (slug || is_homepage || (seoBlock && Object.keys(seoBlock).length)) {
             await api
-                .updatePage(pageId, { ...(slug ? { slug } : {}), ...(is_homepage ? { is_homepage: true } : {}) })
+                .updatePage(pageId, {
+                ...(slug ? { slug } : {}),
+                ...(is_homepage ? { is_homepage: true } : {}),
+                ...(seoBlock && Object.keys(seoBlock).length ? { settings: { seo: seoBlock } } : {}),
+            })
                 .catch(() => { });
         }
         return {
@@ -207,7 +247,7 @@ form|summary, and a centred thank-you — and navigation between them (cart→ch
 Still add a GLOBAL header/footer with scaffold_global_sections (or create_global_section).
 Pass style:"minimal" for the old bare stubs (heading + binding element only).`, {
         style: z.enum(["rich", "minimal"]).default("rich").describe("'rich' = fully-designed, palette-aware store pages (default). 'minimal' = bare starter stubs you must enrich yourself."),
-        palette: z.record(z.any()).optional().describe("Optional colour overrides for rich pages: { accent, onAccent, text, muted, surface, surfaceAlt, border }. Defaults to the site theme CSS vars (var(--color_02) accent, var(--color_00) text)."),
+        palette: z.record(z.any()).optional().describe("Optional colour overrides for rich pages: { accent, onAccent, text, muted, surface, surfaceAlt, border }. Defaults to the site theme matrix vars (var(--color_20) brand accent, var(--color_04) black text, var(--color_00) white surface)."),
         include_member: z.boolean().default(false).describe("Also create login/register/profile (type member, use_member)"),
         include_blog: z.boolean().default(false).describe("Also create blog list + post pages (type blog, use_blog)"),
         dry_run: z.boolean().default(true).describe("Preview (true) or actually create the missing pages (false)"),
@@ -218,16 +258,18 @@ Pass style:"minimal" for the old bare stubs (heading + binding element only).`,
             target: `${name}::${field}`,
         });
         const h1 = (text) => ({ type: "text", opts: { text, specials: { tag: "h1" }, style: { fontSize: "32px", fontWeight: "700" } } });
-        const accentBtn = (text, type = "button") => ({ type, opts: { text, style: { background: "var(--color_02)", color: "#fff", borderRadius: "8px", height: 48, fontWeight: "600" } } });
+        const accentBtn = (text, type = "button") => ({ type, opts: { text, style: { background: "var(--color_20)", color: "var(--color_00)", borderRadius: "8px", height: 48, fontWeight: "600" } } });
         // Rich (default) store pages come from the designed, palette-aware templates;
-        // 'minimal' falls back to the original bare stubs.
-        const pal = resolvePalette(palette || {});
+        // 'minimal' falls back to the original bare stubs. Derive a contrast-safe accent from
+        // the site's active theme (explicit palette overrides win).
+        const themePal = await contrastSafePalette(api);
+        const pal = resolvePalette({ ...themePal, ...(palette || {}) });
         const minimalStore = {
             collections: () => ({ sections: [buildSection([h1("Danh mục sản phẩm"), { type: "grid-product", opts: { config: { columns: 3, image_ratio: "1/1", gap_column: 24, gap_row: 32 } } }])] }),
             products: () => ({ sections: [buildSection([
                         { type: "product-gallery", opts: {} },
                         { type: "text-dataset", opts: { bindings: [bind("product", "product_name")], style: { fontSize: "28px", fontWeight: "700" } } },
-                        { type: "text-dataset", opts: { bindings: [bind("product", "product_price")], style: { fontSize: "22px", fontWeight: "700", color: "var(--color_02)" } } },
+                        { type: "text-dataset", opts: { bindings: [bind("product", "product_price")], style: { fontSize: "22px", fontWeight: "700", color: "var(--color_20)" } } },
                         { type: "quantity-input", opts: {} },
                         accentBtn("Thêm vào giỏ"),
                     ])] }),

package/dist/tools/collections.js

@@ -6,7 +6,9 @@ export function registerCollectionTools(server, api, handle) {
         term: z.string().optional().describe("Search by collection name"),
     }, ({ page, limit, term }) => handle(async () => {
         const res = await api.listCollections({ page, limit, term });
-        const collections = (res && res.data) || res || [];
+        // Real shape: { data: { data:[…], total_entries } }. Accept a flat data[] too.
+        const d = res && res.data;
+        const collections = (d && (Array.isArray(d) ? d : d.data)) || res || [];
         if (!Array.isArray(collections))
             return res;
         return {
@@ -17,7 +19,7 @@ export function registerCollectionTools(server, api, handle) {
                 fields_count: (c.schema || []).length,
                 records_count: c.records_count || undefined,
             })),
-            total: res.total || collections.length,
+            total: (d && !Array.isArray(d) && d.total_entries) ?? res.total ?? collections.length,
         };
     }));
     server.tool("get_collection", "Get a specific collection's details including full schema (field names, types, constraints, references) and records", {

package/dist/tools/orders.js

@@ -6,7 +6,8 @@ export function registerOrderTools(server, api, handle) {
         status: z.number().optional().describe("Filter by status (0=pending, 50=confirmed, 100=shipping, 150=delivered, -1=cancelled)"),
     }, ({ page, limit, status }) => handle(async () => {
         const res = await api.listOrders({ page, limit, status });
-        const orders = (res && res.data) || res || [];
+        // Real shape: { orders: { data:[…], total_entries, count_status } }.
+        const orders = (res && (res.orders?.data || res.data)) || res || [];
         if (!Array.isArray(orders))
             return res;
         return {
@@ -22,7 +23,8 @@ export function registerOrderTools(server, api, handle) {
                 created_at: o.created_at,
                 updated_at: o.updated_at,
             })),
-            total: res.total || orders.length,
+            total: res.orders?.total_entries ?? res.total ?? orders.length,
+            ...(res.orders?.count_status ? { count_status: res.orders.count_status } : {}),
         };
     }));
     server.tool("get_order", "Get full order details by ID: customer info, items, payment, shipping, discounts, etc.", {

package/dist/tools/pages.js

@@ -3,6 +3,7 @@ import { CUSTOM_CODE_GUIDE } from "../guides.js";
 import { getConfirmMode } from "./context.js";
 import { normalizeEvents } from "../builder/events.js";
 import { normalizeBindings } from "../builder/bindings.js";
+import { PAGE_TYPE_NUM, PAGE_KINDS, buildPageSeo } from "./builder.js";
 /**
  * Page source utilities.
  *
@@ -293,15 +294,32 @@ Examples:
         const results = searchElements(source, filters);
         return { page_id, matched: results.length, elements: results };
     }));
-    server.tool("create_page", "Create a new page", {
+    server.tool("create_page", "Create a new (empty) page. For a page with content use build_page instead. type is a KIND (main/store/member/blog/custom/error/maintain) mapped to the numeric backend type; pass seo so it doesn't publish with an empty title.", {
         name: z.string().describe("Page name"),
         slug: z.string().describe("URL slug (e.g. '/about')"),
-        type: z.string().optional().describe("Page type"),
+        type: z.enum(PAGE_KINDS).optional().describe("Page kind (main/store/member/blog/custom/error/maintain). store/member/blog need their data-source flag enabled — prefer build_page which auto-enables it."),
         is_homepage: z.boolean().default(false).describe("Set as homepage"),
-    }, ({ name, slug, type, is_homepage }) => handle(async () => {
-        const res = await api.createPage({ name, slug, type, is_homepage });
+        seo: z
+            .object({ title: z.string().optional(), description: z.string().optional(), keyword: z.string().optional(), favicon: z.string().optional(), thumbnail: z.string().optional() })
+            .optional()
+            .describe("SEO → settings.seo (title/description/keyword/favicon/thumbnail). Tokens {{name_page}}/{{name_site}} allowed."),
+    }, ({ name, slug, type, is_homepage, seo }) => handle(async () => {
+        const typeNum = type ? PAGE_TYPE_NUM[type] : undefined;
+        const created = await api.createPage({ name, ...(typeNum != null ? { type: typeNum } : {}) });
         invalidatePageCache();
-        return res;
+        const pageId = (created && (created.id || created.data?.id || created.page?.id)) || null;
+        const seoBlock = seo ? buildPageSeo(seo) : null;
+        if (pageId && (slug || is_homepage || (seoBlock && Object.keys(seoBlock).length))) {
+            await api
+                .updatePage(pageId, {
+                ...(slug ? { slug } : {}),
+                ...(is_homepage ? { is_homepage: true } : {}),
+                ...(seoBlock && Object.keys(seoBlock).length ? { settings: { seo: seoBlock } } : {}),
+            })
+                .catch(() => { });
+            invalidatePageCache();
+        }
+        return { success: true, page_id: pageId, name, slug, type: type ?? null, raw: pageId ? undefined : created };
     }));
     server.tool("update_page", "Update page properties (name, slug, settings, custom code)", {
         page_id: z.string().describe("Page ID"),

package/dist/tools/products.js

@@ -11,7 +11,8 @@ export function registerProductTools(server, api, handle) {
         if (term && term.trim())
             query.term = term.trim();
         const res = await api.listProducts(query);
-        const products = (res && res.data) || res || [];
+        // Real shape: { products:[…], total_product }. Fall back to data/array for safety.
+        const products = (res && (res.products || res.data)) || res || [];
         if (!Array.isArray(products))
             return res;
         return {
@@ -28,7 +29,7 @@ export function registerProductTools(server, api, handle) {
                 categories: p.categories || undefined,
                 updated_at: p.updated_at,
             })),
-            total: res.total || products.length,
+            total: res.total_product ?? res.total ?? products.length,
         };
     }));
     server.tool("get_product", "Get full product details by ID: name, description, price, variations, images, attributes, SEO, etc.", {

package/dist/tools/promotions.js

@@ -81,7 +81,8 @@ export function registerPromotionTools(server, api, handle) {
     }));
     server.tool("get_active_promotions", "Get all currently active promotions (is_activated=true and within start_time/end_time range)", {}, () => handle(async () => {
         const res = await api.getActivePromotions();
-        const promotions = (res && res.data && res.data.promotions) || (res && res.data) || [];
+        // Real shape: { promotions:[…] } at the top level (not under data).
+        const promotions = (res && (res.promotions || (res.data && res.data.promotions) || res.data)) || [];
         return {
             data: Array.isArray(promotions)
                 ? promotions.map((p) => ({
@@ -124,8 +125,19 @@ export function registerPromotionTools(server, api, handle) {
             query.page = page;
         if (limit)
             query.limit = limit;
-        const res = await api.searchPromotions(query);
-        const data = (res && res.data && res.data.result) || (res && res.data) || res;
-        return data;
+        const res = await api.searchPromotions({ page: page ?? 1, limit: limit ?? 50 });
+        let list = (res && (res.data?.result || res.data)) || [];
+        if (!Array.isArray(list))
+            return res;
+        // The /all endpoint doesn't filter, so apply the requested filters client-side.
+        if (term)
+            list = list.filter((p) => (p.name || "").toLowerCase().includes(term.toLowerCase()));
+        if (type)
+            list = list.filter((p) => p.type === type);
+        if (status != null)
+            list = list.filter((p) => p.time_status === status || p.status === status);
+        if (is_activated != null)
+            list = list.filter((p) => Boolean(p.is_activated) === is_activated);
+        return { data: list, total: list.length, total_unfiltered: res.total_entries };
     }));
 }

package/package.json

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