Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_gap_insurance_need

Calculate auto loan negative equity and GAP insurance need by comparing payoff balance with vehicle actual cash value, then return net gap exposure, LTV status, recommendation, and payout shortfall.

Instructions

Auto GAP Insurance Need & Negative Equity Calculator. Calculate negative equity exposure ('underwater loan') comparing outstanding auto loan balance against actual cash value (ACV) after depreciation. Discipline: FINANCE. Governing mathematical model / formula: GAP Exposure = Outstanding Loan Balance - Vehicle Actual Cash Value (ACV).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of net_gap_exposure (Out-of-Pocket GAP Risk if Totaled), equity_status (Loan-to-Value (LTV) Ratio), gap_recommendation (GAP Insurance Recommendation), insurance_shortfall (Primary Insurance Payout Shortfall) using current_loan_payoff (Outstanding Auto Loan Payoff), market_value_acv (Vehicle Actual Cash Value (ACV / KBB)), insurance_deductible (Insurance Comprehensive/Collision Deductible). 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 'Auto GAP Insurance Need & Negative Equity 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): "gap-insurance-need"

    • category (string): "finance"

    • name (string): "Auto GAP Insurance Need & Negative Equity Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.net_gap_exposure (Out-of-Pocket GAP Risk if Totaled): Formatted display string (e.g. '$7,000.00')

      • metrics.equity_status (Loan-to-Value (LTV) Ratio): Formatted display string (e.g. '125.5% (Underwater / Negative Equity)')

      • metrics.gap_recommendation (GAP Insurance Recommendation): Formatted display string (e.g. 'CRITICAL: Purchase GAP Insurance')

      • metrics.insurance_shortfall (Primary Insurance Payout Shortfall): Formatted display string (e.g. '$6,500.00')

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

Input Schema

NameRequiredDescriptionDefault
market_value_acvNoVehicle Actual Cash Value (ACV / KBB). Insurance total loss payout value. Default: 25500. Min: 1000. Max: 150000.
current_loan_payoffNoOutstanding Auto Loan Payoff. Current balance owed to bank or lender. Default: 32000. Min: 2000. Max: 150000.
insurance_deductibleNoInsurance Comprehensive/Collision Deductible. Deductible owed on total loss claim. Default: 500. Min: 0. Max: 2500.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools