@respira/wordpress-mcp-server 7.2.18 → 7.3.0

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAoUzE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAS;IACpC,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAU;IAE9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEhE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAsVvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;;;;;;;;;;OAkBG;YACW,uBAAuB;IA0GrC;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IAgDxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IAyIhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAuRP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IA6zFtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAElD;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAQ7C;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAQ3C;IAEF,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAY;IAEnE,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,SAAS;YAWV,oBAAoB;YAqFpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;IAwT3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IAqG5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IA24B9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkXzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAoUzE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAS;IACpC,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAU;IAE9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEhE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAsVvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;;;;;;;;;;OAkBG;YACW,uBAAuB;IA0GrC;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IAgDxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IAyIhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAuRP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IA6zFtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAElD;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAQ7C;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAQ3C;IAEF,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAY;IAEnE,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,SAAS;YAWV,oBAAoB;YAqFpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;IAw0B3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IAqG5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAwgC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkXzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}

package/dist/server.js

@@ -4992,6 +4992,525 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 },
                 readOnlyHint: true,
             },
+            // --- Brands (addon v3.0) ---
+            {
+                name: 'woocommerce_list_brands',
+                description: 'List product brands (WooCommerce 9.4+ product_brand taxonomy).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string', description: 'Search brands by name' },
+                        per_page: { type: 'number', description: 'Brands per page (1-100)' },
+                        page: { type: 'number', description: 'Page number' },
+                        hide_empty: { type: 'boolean', description: 'Only brands with products' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_brand',
+                description: 'Get a single product brand.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Brand (term) ID' },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_brand',
+                description: 'Create a product brand.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Brand name' },
+                        slug: { type: 'string', description: 'Optional slug' },
+                        description: { type: 'string', description: 'Optional description' },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'woocommerce_update_brand',
+                description: 'Update a product brand.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Brand (term) ID' },
+                        name: { type: 'string' },
+                        slug: { type: 'string' },
+                        description: { type: 'string' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_delete_brand',
+                description: 'Delete a product brand.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Brand (term) ID' },
+                    },
+                    required: ['id'],
+                },
+                destructiveHint: true,
+            },
+            // --- Catalog operations (addon v3.0 exposes existing REST tools) ---
+            {
+                name: 'woocommerce_list_products_advanced',
+                description: 'List products with advanced filters: category, tag, stock status, on-sale, featured, price range.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        status: { type: 'string', description: 'publish, draft, pending, any' },
+                        category: { type: 'string', description: 'Category slug' },
+                        tag: { type: 'string', description: 'Tag slug' },
+                        stock_status: { type: 'string', description: 'instock, outofstock, onbackorder' },
+                        on_sale: { type: 'boolean' },
+                        featured: { type: 'boolean' },
+                        min_price: { type: 'number' },
+                        max_price: { type: 'number' },
+                        orderby: { type: 'string' },
+                        order: { type: 'string', description: 'ASC or DESC' },
+                        per_page: { type: 'number' },
+                        page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_find_product',
+                description: 'Find products by natural-language query across titles, descriptions, SKUs, and categories, ranked by relevance.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Natural-language product description' },
+                        limit: { type: 'number', description: 'Max results (1-20, default 5)' },
+                    },
+                    required: ['query'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_catalog_health',
+                description: 'Audit the catalog: missing images, thin descriptions, uncategorized products, missing prices, stock inconsistencies. Returns a 0-100 health score.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_bulk_update_products',
+                description: 'Update up to 100 products in one call (name, descriptions, status, featured, visibility). Snapshots before/after; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        updates: {
+                            type: 'array',
+                            items: { type: 'object' },
+                            description: 'Each: {id, name?, description?, short_description?, status?, featured?, catalog_visibility?}',
+                        },
+                        dry_run: { type: 'boolean', description: 'Preview without writing' },
+                    },
+                    required: ['updates'],
+                },
+            },
+            // --- Pricing (addon v3.0 exposes existing REST tools) ---
+            {
+                name: 'woocommerce_bulk_update_prices',
+                description: 'Bulk-change prices (percentage, absolute delta, or set value) for up to 100 products by IDs or category. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        product_ids: { type: 'array', items: { type: 'number' } },
+                        category: { type: 'string', description: 'Category slug (alternative to product_ids)' },
+                        change_type: { type: 'string', description: 'percentage, absolute, or set_value' },
+                        change_value: { type: 'number', description: 'e.g. -10 for a 10% cut with change_type percentage' },
+                        apply_to: { type: 'string', description: 'regular_price, sale_price, or both' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['change_value'],
+                },
+            },
+            {
+                name: 'woocommerce_schedule_sale',
+                description: 'Schedule sale prices with start/end dates for up to 100 products. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        product_ids: { type: 'array', items: { type: 'number' } },
+                        sale_price: { type: 'number' },
+                        start_date: { type: 'string', description: 'ISO 8601 date' },
+                        end_date: { type: 'string', description: 'ISO 8601 date' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['product_ids'],
+                },
+            },
+            {
+                name: 'woocommerce_revert_pricing',
+                description: 'Revert a product\'s pricing to a Respira snapshot taken before a commerce edit.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        product_id: { type: 'number' },
+                        snapshot_id: { type: 'number' },
+                    },
+                    required: ['product_id', 'snapshot_id'],
+                },
+                idempotentHint: true,
+            },
+            // --- Inventory (addon v3.0 exposes existing REST tools) ---
+            {
+                name: 'woocommerce_bulk_update_stock',
+                description: 'Set, increase, or decrease stock for up to 100 products in one call. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        updates: {
+                            type: 'array',
+                            items: { type: 'object' },
+                            description: 'Each: {id, quantity, operation: "set"|"increase"|"decrease"}',
+                        },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['updates'],
+                },
+            },
+            {
+                name: 'woocommerce_find_low_stock',
+                description: 'List products at or below a stock threshold (defaults to the WooCommerce low-stock setting), sorted by urgency.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        threshold: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            // --- Storefront intelligence (addon v3.0 exposes existing REST tools) ---
+            {
+                name: 'woocommerce_analyze_shop_page',
+                description: 'Analyze the shop page through the page-builder layer: product grids, hierarchy score, issues, recommendations.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        page_id: { type: 'number', description: 'Defaults to the WooCommerce shop page' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_analyze_product_page',
+                description: 'Quality-score a single product page: images, gallery, description depth, price, category.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        product_id: { type: 'number' },
+                    },
+                    required: ['product_id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_update_product_card_layout',
+                description: 'Change product grid layout (columns, rows, ordering) on archive pages through the page-builder layer. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        page_id: { type: 'number', description: 'Defaults to the shop page' },
+                        changes: { type: 'object', description: 'e.g. {columns: 4, rows: 3, orderby: "popularity"}' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['changes'],
+                },
+            },
+            {
+                name: 'woocommerce_add_low_stock_badge',
+                description: 'Find products under a stock threshold and produce badge data (e.g. "Only 3 left") for product cards.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        page_id: { type: 'number' },
+                        threshold: { type: 'number', description: 'Default 5' },
+                        badge_text: { type: 'string', description: 'Default "Only {qty} left"' },
+                        badge_style: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_add_sale_badge',
+                description: 'List on-sale products with computed discount percentages and badge data for product cards.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        page_id: { type: 'number' },
+                        dry_run: { type: 'boolean' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_update_checkout_layout',
+                description: 'Apply layout changes to the checkout page through the page-builder layer. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        page_id: { type: 'number', description: 'Defaults to the checkout page' },
+                        changes: { type: 'object' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['changes'],
+                },
+            },
+            // --- Variations and attributes (addon v3.0) ---
+            {
+                name: 'woocommerce_set_product_attributes',
+                description: 'Set global (taxonomy) or custom attributes on a product; missing terms are created. Mark variation: true to use for variations. Snapshots.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID' },
+                        attributes: {
+                            type: 'array',
+                            items: { type: 'object' },
+                            description: 'Each: {name, options: [..], visible?, variation?, position?}',
+                        },
+                        replace: { type: 'boolean', description: 'false merges with existing attributes (default true)' },
+                    },
+                    required: ['id', 'attributes'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_generate_variations',
+                description: 'Create all missing variations from the product\'s variation attributes (cartesian product), up to 100 per call. Snapshots; dry_run supported.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Variable product ID' },
+                        limit: { type: 'number', description: 'Max variations to create this call (default 50, max 100)' },
+                        defaults: { type: 'object', description: 'Applied to each created variation: {regular_price?, stock_quantity?}' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'woocommerce_create_variation',
+                description: 'Create one variation with explicit attribute values, price, SKU, stock, and image. Snapshots.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Variable product ID' },
+                        attributes: { type: 'object', description: 'e.g. {"pa_color": "red", "size": "M"}' },
+                        regular_price: { type: 'string' },
+                        sale_price: { type: 'string' },
+                        sku: { type: 'string' },
+                        stock_quantity: { type: 'number' },
+                        image_id: { type: 'number' },
+                        description: { type: 'string' },
+                        status: { type: 'string', description: 'Default publish' },
+                    },
+                    required: ['id', 'attributes'],
+                },
+            },
+            {
+                name: 'woocommerce_create_global_attribute',
+                description: 'Create a global product attribute with terms. Supports the WooCommerce 10.9 wc-visual type for per-term color/image swatches.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string' },
+                        slug: { type: 'string' },
+                        type: { type: 'string', description: 'select (default) or wc-visual (WooCommerce 10.9+ with the Color swatches feature enabled)' },
+                        terms: {
+                            type: 'array',
+                            items: { type: 'object' },
+                            description: 'Each: {name, slug?, color? (hex, wc-visual), image_id? (wc-visual)}',
+                        },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'woocommerce_set_variation_gallery',
+                description: 'Set a variation\'s image (first ID) and, when a variation-gallery plugin is active, its gallery (remaining IDs). Snapshots.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Variation ID' },
+                        image_ids: { type: 'array', items: { type: 'number' }, description: 'Attachment IDs; first becomes the variation image' },
+                    },
+                    required: ['id', 'image_ids'],
+                },
+                idempotentHint: true,
+            },
+            // --- Coupons and customers (addon v3.0) ---
+            {
+                name: 'woocommerce_list_coupons',
+                description: 'List coupons with optional search.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string' },
+                        per_page: { type: 'number' },
+                        page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_coupon',
+                description: 'Create a coupon: percent or fixed discount, expiry, usage limits, product and email restrictions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        code: { type: 'string' },
+                        discount_type: { type: 'string', description: 'percent, fixed_cart, or fixed_product' },
+                        amount: { type: 'number' },
+                        description: { type: 'string' },
+                        date_expires: { type: 'string', description: 'ISO 8601 date' },
+                        free_shipping: { type: 'boolean' },
+                        individual_use: { type: 'boolean' },
+                        exclude_sale_items: { type: 'boolean' },
+                        minimum_amount: { type: 'number' },
+                        maximum_amount: { type: 'number' },
+                        usage_limit: { type: 'number' },
+                        usage_limit_per_user: { type: 'number' },
+                        product_ids: { type: 'array', items: { type: 'number' } },
+                        excluded_product_ids: { type: 'array', items: { type: 'number' } },
+                        email_restrictions: { type: 'array', items: { type: 'string' } },
+                    },
+                    required: ['code'],
+                },
+            },
+            {
+                name: 'woocommerce_update_coupon',
+                description: 'Update any coupon field by coupon ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Coupon ID' },
+                        code: { type: 'string' },
+                        discount_type: { type: 'string' },
+                        amount: { type: 'number' },
+                        date_expires: { type: 'string' },
+                        usage_limit: { type: 'number' },
+                        free_shipping: { type: 'boolean' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_create_customer',
+                description: 'Create a WooCommerce customer with optional billing/shipping addresses. Passwords auto-generate when omitted and are never returned.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        email: { type: 'string' },
+                        username: { type: 'string' },
+                        first_name: { type: 'string' },
+                        last_name: { type: 'string' },
+                        billing: { type: 'object', description: 'Address fields: first_name, last_name, company, address_1, address_2, city, state, postcode, country, phone, email' },
+                        shipping: { type: 'object' },
+                    },
+                    required: ['email'],
+                },
+            },
+            {
+                name: 'woocommerce_update_customer',
+                description: 'Update a customer\'s name, email, billing, or shipping details by user ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Customer (user) ID' },
+                        email: { type: 'string' },
+                        first_name: { type: 'string' },
+                        last_name: { type: 'string' },
+                        billing: { type: 'object' },
+                        shipping: { type: 'object' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            // --- Order notes and refunds (addon v3.0) ---
+            {
+                name: 'woocommerce_add_order_note',
+                description: 'Add a note to an order. Private by default; customer_note: true emails the customer.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Order ID' },
+                        note: { type: 'string' },
+                        customer_note: { type: 'boolean', description: 'Default false (private note)' },
+                    },
+                    required: ['id', 'note'],
+                },
+            },
+            {
+                name: 'woocommerce_get_order_refunds',
+                description: 'List refunds on an order with total refunded and remaining refundable amounts.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Order ID' },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_order_refund',
+                description: 'Refund an order. DRY-RUN BY DEFAULT: pass dry_run: false to execute. Gateway money movement is opt-in via refund_payment: true.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Order ID' },
+                        amount: { type: 'number', description: 'Defaults to the full remaining refundable amount' },
+                        reason: { type: 'string' },
+                        line_items: { type: 'array', items: { type: 'object' }, description: 'Each: {item_id, quantity?, total?}' },
+                        refund_payment: { type: 'boolean', description: 'true asks the payment gateway to return the money (default false)' },
+                        restock_items: { type: 'boolean', description: 'Default true' },
+                        dry_run: { type: 'boolean', description: 'Default TRUE: preview only' },
+                    },
+                    required: ['id'],
+                },
+                destructiveHint: true,
+            },
+            // --- AI readiness (addon v3.0) ---
+            {
+                name: 'woocommerce_product_ai_readiness',
+                description: 'Score how well one product is described for AI shopping assistants: description depth, images/alt text, price, SKU, GTIN, brand, attributes, availability.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID' },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_catalog_ai_readiness',
+                description: 'Score the whole catalog for AI shopping readiness: average score, distribution, top issues, weakest products.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        limit: { type: 'number', description: 'Products to scan (default 200, max 500)' },
+                    },
+                },
+                readOnlyHint: true,
+            },
         ];
     }
     /**
@@ -5770,6 +6289,95 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             }
             case 'woocommerce_sales_report':
                 return await client.woocommerceSalesReport(args);
+            // --- WooCommerce Add-on v3.0 ---
+            case 'woocommerce_list_brands':
+                return await client.woocommerceListBrands(args);
+            case 'woocommerce_get_brand':
+                return await client.woocommerceGetBrand(args.id);
+            case 'woocommerce_create_brand':
+                return await client.woocommerceCreateBrand(args);
+            case 'woocommerce_update_brand': {
+                const { id, ...payload } = args;
+                return await client.woocommerceUpdateBrand(id, payload);
+            }
+            case 'woocommerce_delete_brand':
+                return await client.woocommerceDeleteBrand(args.id);
+            case 'woocommerce_list_products_advanced':
+                return await client.woocommerceListProductsAdvanced(args);
+            case 'woocommerce_find_product':
+                return await client.woocommerceFindProduct(args);
+            case 'woocommerce_catalog_health':
+                return await client.woocommerceCatalogHealth();
+            case 'woocommerce_bulk_update_products':
+                return await client.woocommerceBulkUpdateProducts(args);
+            case 'woocommerce_bulk_update_prices':
+                return await client.woocommerceBulkUpdatePrices(args);
+            case 'woocommerce_schedule_sale':
+                return await client.woocommerceScheduleSale(args);
+            case 'woocommerce_revert_pricing':
+                return await client.woocommerceRevertPricing(args);
+            case 'woocommerce_bulk_update_stock':
+                return await client.woocommerceBulkUpdateStock(args);
+            case 'woocommerce_find_low_stock':
+                return await client.woocommerceFindLowStock(args);
+            case 'woocommerce_analyze_shop_page':
+                return await client.woocommerceAnalyzeShopPage(args);
+            case 'woocommerce_analyze_product_page':
+                return await client.woocommerceAnalyzeProductPage(args);
+            case 'woocommerce_update_product_card_layout':
+                return await client.woocommerceUpdateProductCardLayout(args);
+            case 'woocommerce_add_low_stock_badge':
+                return await client.woocommerceAddLowStockBadge(args);
+            case 'woocommerce_add_sale_badge':
+                return await client.woocommerceAddSaleBadge(args);
+            case 'woocommerce_update_checkout_layout':
+                return await client.woocommerceUpdateCheckoutLayout(args);
+            case 'woocommerce_set_product_attributes': {
+                const { id, ...payload } = args;
+                return await client.woocommerceSetProductAttributes(id, payload);
+            }
+            case 'woocommerce_generate_variations': {
+                const { id, ...payload } = args;
+                return await client.woocommerceGenerateVariations(id, payload);
+            }
+            case 'woocommerce_create_variation': {
+                const { id, ...payload } = args;
+                return await client.woocommerceCreateVariation(id, payload);
+            }
+            case 'woocommerce_create_global_attribute':
+                return await client.woocommerceCreateGlobalAttribute(args);
+            case 'woocommerce_set_variation_gallery': {
+                const { id, ...payload } = args;
+                return await client.woocommerceSetVariationGallery(id, payload);
+            }
+            case 'woocommerce_list_coupons':
+                return await client.woocommerceListCoupons(args);
+            case 'woocommerce_create_coupon':
+                return await client.woocommerceCreateCoupon(args);
+            case 'woocommerce_update_coupon': {
+                const { id, ...payload } = args;
+                return await client.woocommerceUpdateCoupon(id, payload);
+            }
+            case 'woocommerce_create_customer':
+                return await client.woocommerceCreateCustomer(args);
+            case 'woocommerce_update_customer': {
+                const { id, ...payload } = args;
+                return await client.woocommerceUpdateCustomer(id, payload);
+            }
+            case 'woocommerce_add_order_note': {
+                const { id, ...payload } = args;
+                return await client.woocommerceAddOrderNote(id, payload);
+            }
+            case 'woocommerce_get_order_refunds':
+                return await client.woocommerceGetOrderRefunds(args.id);
+            case 'woocommerce_create_order_refund': {
+                const { id, ...payload } = args;
+                return await client.woocommerceCreateOrderRefund(id, payload);
+            }
+            case 'woocommerce_product_ai_readiness':
+                return await client.woocommerceProductAiReadiness(args.id);
+            case 'woocommerce_catalog_ai_readiness':
+                return await client.woocommerceCatalogAiReadiness(args);
             // --- v5.2.0 Elemental tools ---
             case 'wordpress_find_element': {
                 const { post_id, ...rest } = args;