webcake-storefront-mcp 1.29.0 → 1.30.0

package/dist/api.js

@@ -505,6 +505,11 @@ export class WebcakeCmsApi {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/combo_product/items`, { query: { combo_product_id: comboProductId, ...query } });
     }
     // ── Customers ──
+    /** List/search customers. Real shape: { customers: { data:[…], total_entries } }. Accepts
+     *  page/limit and a `term` keyword (name/phone/email). Endpoint is /customer/all (singular). */
+    listCustomers(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/customer/all`, { query });
+    }
     findCustomerById(id) {
         return this.request("GET", `/api/v1/cms_function/${this.siteId}/customer/identity/${id}`);
     }

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.30.0",
+    "d": "26/06/2026",
+    "type": "Added",
+    "en": "New list_customers tool browses or searches the site's customer list; accepts page, limit, and term (name/phone/email keyword) and returns a compact…",
+    "vi": "Tool mới list_customers duyệt hoặc tìm kiếm danh sách khách hàng của site; nhận các tham số page, limit và term (từ khóa tên/điện thoại/email) và…"
+  },
   {
     "v": "1.29.0",
     "d": "26/06/2026",
@@ -33,12 +40,5 @@
     "type": "Fixed",
     "en": "create_product now accepts a short_description parameter and sends it to the backend as [{description}] — the array shape the real product schema…",
     "vi": "create_product nay nhận thêm tham số short_description và gửi lên backend dưới dạng [{description}] — đúng kiểu mảng mà schema sản phẩm thực tế yêu…"
-  },
-  {
-    "v": "1.25.0",
-    "d": "26/06/2026",
-    "type": "Changed",
-    "en": "list_elements now documents 16 previously-uncovered element types, completing curated attribute coverage across all 132 factory types: popup…",
-    "vi": "list_elements nay tài liệu hóa 16 kiểu phần tử trước đây chưa được ghi lại, hoàn thiện độ phủ thuộc tính curated cho toàn bộ 132 kiểu factory: popup…"
   }
 ]

package/dist/tools/customers.js

@@ -1,5 +1,35 @@
 import { z } from "zod";
 export function registerCustomerTools(server, api, handle) {
+    server.tool("list_customers", "List/search the site's customers (browse or segment). Pass `term` to search by name/phone/email. Returns name, phone, email, order_count, purchased_amount, reward_point, tags, last_order_at. Use find_customer for an exact id/phone/email lookup.", {
+        page: z.number().optional().describe("Page number (default 1)"),
+        limit: z.number().optional().describe("Items per page (default 50)"),
+        term: z.string().optional().describe("Keyword — searches name / phone / email"),
+    }, ({ page, limit, term }) => handle(async () => {
+        const query = { page: page ?? 1, limit: limit ?? 50 };
+        if (term && term.trim())
+            query.term = term.trim();
+        const res = await api.listCustomers(query);
+        // Real shape: { customers: { data:[…], total_entries } }.
+        const box = (res && res.customers) || res || {};
+        const list = (Array.isArray(box) ? box : box.data) || [];
+        if (!Array.isArray(list))
+            return res;
+        return {
+            data: list.map((c) => ({
+                id: c.id,
+                name: c.name,
+                phone_number: c.phone_number || c.recent_phone_number || undefined,
+                email: c.email || undefined,
+                order_count: c.order_count ?? undefined,
+                succeed_order_count: c.succeed_order_count ?? undefined,
+                purchased_amount: c.purchased_amount ?? undefined,
+                reward_point: c.reward_point ?? undefined,
+                tags: c.tags && c.tags.length ? c.tags : undefined,
+                last_order_at: c.last_order_at || undefined,
+            })),
+            total: (box.total_entries ?? res.total) || list.length,
+        };
+    }));
     server.tool("find_customer", "Find a customer by ID, phone number, or email", {
         by: z.enum(["id", "phone", "email"]).describe("Search field"),
         value: z.string().describe("Search value"),

package/package.json

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