omni_preferred_return_waterfall
Calculate private equity syndication waterfall distributions, splitting LP preferred returns and GP promote payouts at defined hurdles.
Instructions
Syndication Preferred Return & Waterfall Equity Calculator. Calculate private equity syndication waterfall distributions between General Partners (GP) and Limited Partners (LP) with preferred returns and promote hurdles. Discipline: FINANCE. Governing mathematical model / formula: Hurdle 1: 100% to LP until 8% Pref | Hurdle 2: 80% LP / 20% GP Promote Split.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of lp_total_payout (Limited Partner (LP) Total Distribution), gp_promote_payout (General Partner (GP) Promote Distribution), lp_pref_hurdle_dollar (LP 8.0% Preferred Return Amount), excess_split_cash (Distributable Cash Above Hurdle) using lp_capital_invested (Limited Partner (LP) Capital Invested), lp_preferred_return_pct (LP Preferred Return (Pref Rate %) in %), gp_promote_split_pct (GP Promote Share Above Hurdle in %), total_distributable_cash (Total Cash Available for Distribution). 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.
SIBLING ROUTING: Use this dedicated specialist tool for 'Syndication Preferred Return & Waterfall Equity Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
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): "preferred-return-waterfall"
category (string): "finance"
name (string): "Syndication Preferred Return & Waterfall Equity Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.lp_total_payout (Limited Partner (LP) Total Distribution): Formatted display string (e.g. '$392,000.00 (87.1%)')
metrics.gp_promote_payout (General Partner (GP) Promote Distribution): Formatted display string (e.g. '$58,000.00 (12.9%)')
metrics.lp_pref_hurdle_dollar (LP 8.0% Preferred Return Amount): Formatted display string (e.g. '$160,000.00')
metrics.excess_split_cash (Distributable Cash Above Hurdle): Formatted display string (e.g. '$290,000.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_preferred_return_waterfall"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lp_capital_invested | No | Limited Partner (LP) Capital Invested. Total equity contributed by outside passive investors. Default: 2000000. Min: 50000. Max: 100000000. | |
| gp_promote_split_pct | No | GP Promote Share Above Hurdle (%). Carried interest share to sponsor (e.g. 80/20 split = 20% GP). Default: 20. Min: 5. Max: 50. | |
| lp_preferred_return_pct | No | LP Preferred Return (Pref Rate %) (%). Annual hurdle return before GP receives promote. Default: 8. Min: 4. Max: 15. | |
| total_distributable_cash | No | Total Cash Available for Distribution. Operating cash or refinancing/sale proceeds. Default: 450000. Min: 10000. Max: 20000000. |