omni_product_bundle_pricing_elasticity
Calculate product bundle discounts and price elasticity to forecast incremental gross margin dollars and sales volume lift from promotional bundles.
Instructions
Product Bundle Pricing & Elasticity Calculator. Model promotional product bundle discounts against single-item sales to forecast incremental gross margin dollars and sales volume lift. Discipline: ECOMMERCE. Governing mathematical model / formula: Bundle Profit = Bundle Price - Combined COGS | Profit Uplift = (Bundle Profit × New Volume) - (Single Profit × Old Volume).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of bundle_discount_pct (Consumer Bundle Discount (%)), gross_profit_per_bundle (Gross Profit Per Bundle Sold), bundle_gross_margin_pct (Bundle Gross Margin (%)), break_even_bundle_volume (Break-Even Sales Volume) using item_a_retail_price (Item A Individual Price in $), item_b_retail_price (Item B Individual Price in $), combined_bundle_cogs (Combined Cost of Goods (COGS) in $), bundled_promotional_price (Bundled Package Price in $), baseline_monthly_hero_sales (Baseline Monthly Units (Item A Alone) in units). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Product Bundle Pricing & Elasticity Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "product-bundle-pricing-elasticity"
category (string): "ecommerce"
name (string): "Product Bundle Pricing & Elasticity Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.bundle_discount_pct (Consumer Bundle Discount (%)): Formatted display string (e.g. '18.8% Off')
metrics.gross_profit_per_bundle (Gross Profit Per Bundle Sold): Formatted display string (e.g. '$45.00 / bundle')
metrics.bundle_gross_margin_pct (Bundle Gross Margin (%)): Formatted display string (e.g. '69.2%')
metrics.break_even_bundle_volume (Break-Even Sales Volume): Formatted display string (e.g. '756 Bundles')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_product_bundle_pricing_elasticity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_a_retail_price | No | Item A Individual Price ($). Primary hero product price. Default: 45. Min: 5. Max: 500. | |
| item_b_retail_price | No | Item B Individual Price ($). Complementary cross-sell product price. Default: 35. Min: 5. Max: 500. | |
| combined_bundle_cogs | No | Combined Cost of Goods (COGS) ($). Total wholesale manufacturing cost for both items. Default: 20. Min: 2. Max: 300. | |
| bundled_promotional_price | No | Bundled Package Price ($). Discounted package price for purchasing both items. Default: 65. Min: 10. Max: 800. | |
| baseline_monthly_hero_sales | No | Baseline Monthly Units (Item A Alone) (units). Units sold prior to bundle promotion. Default: 1000. Min: 50. Max: 50000. |