simulate_life_insurance_flush
Simulates a Cyprus unit-linked life insurance policy and calculates tax and returns from executed withdrawals only. Requests above available funds are capped and flagged; self-funded surrender taxes are included in household cash flows and IRR. Use to model withdrawals from an existing Cyprus life-insurance policy. Require actual policy terms, tax rate, historical policy records and future premium/withdrawal projections; ask for missing items and never generate policy history. Amounts requested above available funds are limited to executed proceeds, and tax/return figures follow those executed cash flows. Forecast returns are assumptions and must be identified as such.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"contractStartYear": "<contractStartYear>",
"age": "<age>",
"gender": "<gender>",
"capitalSumInsured": "<capitalSumInsured>",
"aumFee": "<aumFee>",
"monthlyFee": "<monthlyFee>",
"investmentReturn": "<investmentReturn>",
"taxBracket": "<taxBracket>",
"historicalData": "<historicalData>",
"projections": "<projections>"
},
"name": "simulate_life_insurance_flush"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | Yes | Current age of the policyholder. | |
| aumFee | Yes | Annual management fee as a percent of fund value. | |
| gender | Yes | Used to look up mortality rates. | |
| scenario | No | Which scenario to report as the primary result (default userInput). All three are always returned for comparison. | |
| monthlyFee | Yes | Fixed policy fee charged each month, EUR. | |
| taxBracket | Yes | Marginal income tax rate applied to taxable surrender amounts and to premium relief, percent. | |
| projections | Yes | Future years to simulate. | |
| historicalData | Yes | Actual policy history; the last entry's endingBalance is the simulation's opening balance, and the 3/4-year lookbacks drive the safe limit. | |
| brokerReturnRate | No | Annual return of the broker account, percent (used with useDifferentBrokerReturn). | |
| investmentReturn | Yes | Annual percentage value (e.g. 2.5 for 2.5%). Supply the actual rate unless the user accepts a stated modelling default. Expected annual return inside the policy. | |
| capitalSumInsured | Yes | Death benefit / sum insured, EUR. Mortality cost applies to the amount at risk above the fund value. | |
| contractStartYear | Yes | Calendar year the policy started. Partial surrenders are only tax-free from the 4th policy year. | |
| reinvestWithdrawals | No | When true, net withdrawals are reinvested in a broker account and IRR is computed on combined wealth. | |
| useDifferentBrokerReturn | No | Use brokerReturnRate instead of investmentReturn for the broker account. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| irr | No | ||
| series | No | ||
| scenario | No | ||
| irrWithTax | No | ||
| assumptions | No | ||
| finalBalance | No | ||
| totalTaxPaid | No | ||
| irrWithoutTax | No | ||
| totalFeesPaid | No | ||
| totalTaxSaved | No | ||
| irrPerspective | No | ||
| totalWithdrawn | No | ||
| safeLimitByYear | No | ||
| finalBrokerBalance | No | ||
| finalPolicyBalance | No | ||
| scenarioComparison | No | ||
| totalMortalityCost | No | ||
| totalSelfFundedCost | No | ||
| irrUnavailableReason | No | ||
| irrWithTaxPerspective | No | ||
| netWithdrawalsPaidOut | No | ||
| mortalityDataAvailable | No | ||
| irrWithoutTaxPerspective | No |