Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_dim_weight_calculator

Calculates dimensional and billable parcel weight from box dimensions, actual weight, and DIM divisor to determine carrier charges and volumetric weight penalties.

Instructions

Dimensional Weight (DIM Factor 139 / 166) Calculator. Calculate volumetric dimensional weight, billable weight, and carrier rate adjustments for FedEx, UPS, DHL, and USPS domestic and international parcels. Discipline: LOGISTICS. Governing mathematical model / formula: DIM Weight (lbs) = (Length × Width × Height in inches) / DIM Divisor (139 or 166).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of billable_weight_lbs (Carrier Billable Weight), dimensional_weight_lbs (Calculated DIM Weight), package_volume_cuft (Total Package Volume), dim_premium_pct (Volumetric Weight Penalty) using box_length_in (Box Length (Inches) in in), box_width_in (Box Width (Inches) in in), box_height_in (Box Height (Inches) in in), actual_weight_lbs (Actual Scale Weight (lbs) in lbs), dim_divisor (Carrier DIM Factor (139 = FedEx/UPS Daily, 166 = USPS/Retail)). 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 'Dimensional Weight (DIM Factor 139 / 166) 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): "dim-weight-calculator"

    • category (string): "logistics"

    • name (string): "Dimensional Weight (DIM Factor 139 / 166) Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.billable_weight_lbs (Carrier Billable Weight): Formatted display string (e.g. '50.0 lbs')

      • metrics.dimensional_weight_lbs (Calculated DIM Weight): Formatted display string (e.g. '49.8 lbs (Billed as 50 lbs)')

      • metrics.package_volume_cuft (Total Package Volume): Formatted display string (e.g. '4.00 cu ft')

      • metrics.dim_premium_pct (Volumetric Weight Penalty): Formatted display string (e.g. '+127% Above Scale Weight')

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

Input Schema

NameRequiredDescriptionDefault
dim_divisorNoCarrier DIM Factor (139 = FedEx/UPS Daily, 166 = USPS/Retail). Standard commercial divisor is 139, retail is 166. Default: 139. Min: 115. Max: 250.
box_width_inNoBox Width (Inches) (in). Second package dimension. Default: 18. Min: 1. Max: 72.
box_height_inNoBox Height (Inches) (in). Third package dimension. Default: 16. Min: 1. Max: 72.
box_length_inNoBox Length (Inches) (in). Longest package dimension. Default: 24. Min: 1. Max: 108.
actual_weight_lbsNoActual Scale Weight (lbs) (lbs). Physical weight measured on postal scale. Default: 22. Min: 0.5. Max: 150.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools