Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_espp_discount

Calculate employee stock purchase plan returns, including discounted purchase price, instant profit, ROI, and annualized IRR from salary contributions and stock prices.

Instructions

Employee Stock Purchase Plan (ESPP) Calculator. Calculate Employee Stock Purchase Plan (ESPP) returns with 15% discount and lookback provision, annualized IRR, and qualifying vs disqualifying dispositions. Discipline: FINANCE. Governing mathematical model / formula: Purchase Price = min(Start Price, End Price) × 85% | Instant Gain = (End Price - Purchase Price) / Purchase Price.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of espp_instant_profit (Net Profit on Purchase Date), purchase_price_per_share (Discounted Purchase Price per Share), instant_roi_percentage (Immediate Risk-Free ROI), annualized_espp_irr (Annualized Return (IRR)) using espp_offering_start_price (Stock Price at Offering Start), espp_purchase_date_price (Stock Price on Purchase Date), annual_salary_payroll (Annual Salary), espp_contribution_pct (Salary Contribution Percentage (%) 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 'Employee Stock Purchase Plan (ESPP) 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): "espp-discount"

    • category (string): "finance"

    • name (string): "Employee Stock Purchase Plan (ESPP) Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.espp_instant_profit (Net Profit on Purchase Date): Formatted display string (e.g. '+$2,470.59')

      • metrics.purchase_price_per_share (Discounted Purchase Price per Share): Formatted display string (e.g. '$85.00 (15% Lookback Discount)')

      • metrics.instant_roi_percentage (Immediate Risk-Free ROI): Formatted display string (e.g. '41.18% Instant Gain')

      • metrics.annualized_espp_irr (Annualized Return (IRR)): Formatted display string (e.g. '~85.0% - 95.0% Annualized')

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

Input Schema

NameRequiredDescriptionDefault
annual_salary_payrollNoAnnual Salary. Base salary. Default: 120000. Min: 25000. Max: 1000000.
espp_contribution_pctNoSalary Contribution Percentage (%) (%). IRS statutory limit: $25,000/yr. Default: 10. Min: 1. Max: 15.
espp_purchase_date_priceNoStock Price on Purchase Date. Share price at end of offering period. Default: 120. Min: 1. Max: 2500.
espp_offering_start_priceNoStock Price at Offering Start. Share price on day 1 of 6-month offering period. Default: 100. Min: 1. Max: 2500.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools