Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_free_shipping_threshold_aov

Calculates the optimal free shipping threshold from baseline AOV, shipping cost, and margin, then returns recommended cart add and net margin to lift AOV while protecting profitability.

Instructions

Free Shipping Threshold & AOV Optimization Calculator. Calculate the mathematically optimal free shipping threshold to lift Average Order Value (AOV) while protecting gross contribution margins. Discipline: ECOMMERCE. Governing mathematical model / formula: Optimal Threshold ≈ Baseline AOV × 1.25 to 1.30 | Margin Contribution = Uplift Gross Margin - Shipping Absorption.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of recommended_threshold (Recommended Free Shipping Minimum), incremental_cart_addition (Required Shopper Cart Add), net_margin_after_shipping (Net Profit on Incremental Addition), break_even_minimum (Absolute Break-Even Add-On) using baseline_aov (Current Average Order Value (AOV) in $), merchant_shipping_cost (Merchant Outbound Shipping Cost in $), product_gross_margin_pct (Average Gross Profit Margin (%) in %), threshold_multiplier (Target Threshold Stretch Multiplier in × AOV). 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 'Free Shipping Threshold & AOV Optimization 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): "free-shipping-threshold-aov"

    • category (string): "ecommerce"

    • name (string): "Free Shipping Threshold & AOV Optimization Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.recommended_threshold (Recommended Free Shipping Minimum): Formatted display string (e.g. '$75.00 (Rounded)')

      • metrics.incremental_cart_addition (Required Shopper Cart Add): Formatted display string (e.g. '+$20.00 / order')

      • metrics.net_margin_after_shipping (Net Profit on Incremental Addition): Formatted display string (e.g. '+$6.20 Net Gain')

      • metrics.break_even_minimum (Absolute Break-Even Add-On): Formatted display string (e.g. '$10.46 in Cart')

    • 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_free_shipping_threshold_aov"
  }
}

Input Schema

NameRequiredDescriptionDefault
baseline_aovNoCurrent Average Order Value (AOV) ($). Current average checkout cart size. Default: 55. Min: 10. Max: 500.
threshold_multiplierNoTarget Threshold Stretch Multiplier (× AOV). Industry best practice is 120% to 135% of current AOV. Default: 1.25. Min: 1.1. Max: 1.6.
merchant_shipping_costNoMerchant Outbound Shipping Cost ($). Average postage paid by store per package. Default: 6.8. Min: 2. Max: 50.
product_gross_margin_pctNoAverage Gross Profit Margin (%) (%). Gross margin on incremental cart additions. Default: 65. Min: 15. Max: 90.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools