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
| Name | Required | Description | Default |
|---|---|---|---|
| annual_salary_payroll | No | Annual Salary. Base salary. Default: 120000. Min: 25000. Max: 1000000. | |
| espp_contribution_pct | No | Salary Contribution Percentage (%) (%). IRS statutory limit: $25,000/yr. Default: 10. Min: 1. Max: 15. | |
| espp_purchase_date_price | No | Stock Price on Purchase Date. Share price at end of offering period. Default: 120. Min: 1. Max: 2500. | |
| espp_offering_start_price | No | Stock Price at Offering Start. Share price on day 1 of 6-month offering period. Default: 100. Min: 1. Max: 2500. |