omni_aov_expansion_elasticity
Calculates AOV expansion and cross-sell uplift, including expanded average order value, AOV lift, and incremental monthly and annual revenue from attach rates and order bumps.
Instructions
Average Order Value (AOV) Expansion & Cross-Sell Uplift Calculator. Calculate incremental top-line and annual revenue generated by increasing post-purchase cross-sell attach rates and order bumping. Discipline: ECOMMERCE. Governing mathematical model / formula: New AOV = Baseline AOV + (Attach Rate % × Add-On Price) | Monthly Uplift = Monthly Orders × (New AOV - Baseline AOV).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of expanded_store_aov (Expanded Average Order Value), aov_dollar_increase (Average AOV Lift Per Order), monthly_incremental_revenue (Monthly Incremental Revenue), annual_revenue_expansion (Annualized Top-Line Gain) using monthly_order_volume (Monthly Order Volume in orders), baseline_store_aov (Current Baseline AOV in $), cross_sell_attach_rate_pct (Cross-Sell / Order Bump Attach Rate (%) in %), cross_sell_item_price (Add-On Cross-Sell Retail Price in $). 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 'Average Order Value (AOV) Expansion & Cross-Sell Uplift 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): "aov-expansion-elasticity"
category (string): "ecommerce"
name (string): "Average Order Value (AOV) Expansion & Cross-Sell Uplift Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.expanded_store_aov (Expanded Average Order Value): Formatted display string (e.g. '$65.96 / order')
metrics.aov_dollar_increase (Average AOV Lift Per Order): Formatted display string (e.g. '+$3.96 / order')
metrics.monthly_incremental_revenue (Monthly Incremental Revenue): Formatted display string (e.g. '$15,840 / mo')
metrics.annual_revenue_expansion (Annualized Top-Line Gain): Formatted display string (e.g. '$190,080 / year')
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_aov_expansion_elasticity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| baseline_store_aov | No | Current Baseline AOV ($). Average ticket price before cross-sell optimization. Default: 62. Min: 10. Max: 1000. | |
| monthly_order_volume | No | Monthly Order Volume (orders). Total orders transacted each month. Default: 4000. Min: 100. Max: 500000. | |
| cross_sell_item_price | No | Add-On Cross-Sell Retail Price ($). Selling price of the recommended complementary product. Default: 22. Min: 3. Max: 200. | |
| cross_sell_attach_rate_pct | No | Cross-Sell / Order Bump Attach Rate (%) (%). Percentage of buyers who accept the checkout add-on. Default: 18. Min: 2. Max: 60. |