promotion
Manage and inspect store discounts, coupons, active offers, and combo bundles by listing, searching, or retrieving full details and attached products.
Instructions
Promotions and combos. Pick the operation with action and pass that action's arguments (help:true returns its full documentation and schema).
list_promotions: List ALL promotions/discounts of the site (every page is fetched for you).
search_promotions: Search/filter ALL promotions (every page): by keyword, type, time status (coming_soon/in_progress/finished), active flag.
get_promotion: Get full promotion details by ID: name, type, schedule, discount rules, coupon settings, items, bonus products, etc.
get_promotion_items: Get products/variations/categories attached to a promotion.
get_active_promotions: Get all currently active promotions (is_activated=true and within start_time/end_time range)
list_combos: List all combo/bundle products of the site.
get_combo_items: Get items (products/variations) and bonus products that compose a combo.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "promotion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Promotion ID [get_promotion, get_promotion_items] | |
| help | No | Return the action's full documentation and argument schema instead of running it | |
| page | No | Page number [get_promotion_items, list_combos] | |
| term | No | Search by promotion name [search_promotions, list_combos] | |
| type | No | Filter by type: normal, same_price, coupon, coupon_id_multiple_times, discount_by_coupon_id, prom… [search_promotions] | |
| limit | No | Items per page [get_promotion_items, list_combos] | |
| action | Yes | Which operation to run | |
| status | No | Filter by time status: 1=coming_soon, 2=in_progress, 3=finished [search_promotions] | |
| is_activated | No | Filter by active status [search_promotions] | |
| include_guide | No | Include promotion type reference guide [list_promotions, list_combos] | |
| combo_product_id | No | Combo product ID [get_combo_items] | |
| is_variation_bonus | No | Whether bonus items are variation-based [get_combo_items] |