@cloudcart/dev-mcp 0.2.8 → 0.2.9

package/data/admin.json

@@ -1760,7 +1760,7 @@
             },
             {
               "name": "bulkOperationStatus",
-              "description": "Look up the status of a bulk operation. Returns null if no operation with that `jobId` exists in the current site. Poll this every ~250 ms while `status` is `PENDING` or `RUNNING`; stop once it reaches `COMPLETED` or `FAILED`.",
+              "description": "Poll the status of an async / queue-backed bulk operation — track progress of a background job dispatched by any `productsBulk*` mutation. Use this to check job state, monitor processedCount/totalCount, and read final affectedCount + skippedIds when the job completes. Returns null if no operation with that `jobId` exists in the current site. Poll every ~250 ms while `status` is `PENDING` or `RUNNING`; stop once it reaches `COMPLETED` or `FAILED`.",
               "args": [
                 {
                   "name": "jobId",
@@ -18004,7 +18004,7 @@
             },
             {
               "name": "productsBulkAdjustPrice",
-              "description": "Apply a `PriceChange` to every variant.price on every product matching the selector. Examples: `change: { op: PERCENT_DELTA, value: 10 }` = +10%, `change: { op: PERCENT_DELTA, value: -25 }` = -25%, `change: { op: ABSOLUTE_DELTA, value: 5 }` = +5 (currency units), `change: { op: SET_TO, value: 99 }` = set every variant to 99. Worker bypasses client paginated fetch when the selector is by categoryId / vendorId / tagName. Refreshes `priceFrom`/`priceTo` + fires ES re-index once at end of batch.",
+              "description": "Bulk increase, decrease, raise, lower, change or set product prices across many products at once. Apply a `PriceChange` to every variant.price on every product matching the selector. Examples: `change: { op: PERCENT_DELTA, value: 10 }` = +10% (raise / increase), `change: { op: PERCENT_DELTA, value: -25 }` = -25% (decrease / lower / discount price), `change: { op: ABSOLUTE_DELTA, value: 5 }` = +5 (currency units), `change: { op: SET_TO, value: 99 }` = set every variant to 99. Worker bypasses client paginated fetch when the selector is by categoryId / vendorId / tagName. Refreshes `priceFrom`/`priceTo` + fires ES re-index once at end of batch. Common phrasings: increase prices, decrease prices, raise prices, lower prices, change prices, adjust prices, set prices, mass update product prices.",
               "args": [
                 {
                   "name": "selector",
@@ -18049,7 +18049,7 @@
             },
             {
               "name": "productsBulkApplyDiscount",
-              "description": "Apply a fixed-price discount to every variant of every product matching the selector. The supplied `discountPrice` is in main currency units (e.g. `79.99`) and is set as the new `Variant.discountPrice` for any variant whose regular price is strictly greater than `discountPrice`. Variants where `regular price <= discountPrice` are skipped per-variant (would be a no-op or invalid). Routes through the canonical `Discount::addFixedDiscount()` engine + `product_to_discount` pivot — same path the admin product-edit form uses. Idempotent: rerunning with the same `discountPrice` leaves a single pivot row, not duplicates.",
+              "description": "Put many products on sale — bulk apply a fixed sale price / discount to every variant of every product matching the selector. The supplied `discountPrice` is in main currency units (e.g. `79.99`) and is set as the new `Variant.discountPrice` for any variant whose regular price is strictly greater than `discountPrice`. Variants where `regular price <= discountPrice` are skipped per-variant (would be a no-op or invalid). Routes through the canonical `Discount::addFixedDiscount()` engine + `product_to_discount` pivot — same path the admin product-edit form uses. Idempotent: rerunning with the same `discountPrice` leaves a single pivot row, not duplicates. Common phrasings: apply discount, set sale price, put products on sale, discount many products, mass discount, sale across products, give a discount, set discount on N products.",
               "args": [
                 {
                   "name": "selector",
@@ -18125,7 +18125,7 @@
             },
             {
               "name": "productsBulkRoundPrices",
-              "description": "Round every variant.price on every product matching the selector to a psychological-pricing endpoint (.99, .49, integer, nearest 5/10). Natural follow-up after a percent-based price increase that produced odd numbers like 170.51.",
+              "description": "Bulk round product prices to psychological-pricing endpoints (.99, .49, integer, nearest 5/10) — the natural follow-up after a percent-based price increase that produced odd numbers like 170.51. Round every variant.price on every product matching the selector. Common phrasings: round prices to .99, psychological pricing, round to nearest 5, charm pricing, fix pricing endings.",
               "args": [
                 {
                   "name": "selector",
@@ -53557,7 +53557,7 @@
         {
           "kind": "INPUT_OBJECT",
           "name": "PriceChange",
-          "description": "Operation + value applied to a price column. Used by `productsBulkAdjustPrice` and `productsBulkApplyDiscount`.",
+          "description": "Operation + value applied to a price column. Used by `productsBulkAdjustPrice` only — `productsBulkApplyDiscount` has its own simpler `discountPrice: Float` argument.",
           "fields": null,
           "inputFields": [
             {