run_retirement_stress_test
Runs a deterministic projection plus Monte Carlo simulation of a retirement savings plan. Seeded market and medical paths use independent random streams. Age-keyed returnOverrides replace returns in both calculation modes; nonDepletionProbability always reports basic no-shortfall success, while successProbability also applies supplied successCriteria. Use for a retirement savings sustainability or portfolio-longevity projection. Reuse the user's ages, savings, contributions and planned monthly spending; ask for each missing essential input and never use example personal values. Values are EUR, contributions/drawdown are monthly, and ages are years. Supply pensionStreams to include Cyprus or foreign pension income; concurrent streams are aggregated before applying personal tax allowances and the shared €180,000 GESY ceiling. Foreign pensions use the 2026 flat 5% rate above €5,000 unless a net override is supplied. Omitted state pension means pension income is excluded. accumulationVolatility and distributionVolatility set annual return volatility; medicalShocks optionally models acute and long-term-care costs. returnOverrides replaces age-specific returns in both calculation paths. Market and medical random streams are independent, so changing medical assumptions does not shift seeded market paths. successCriteria optionally sets nominal retirement and terminal thresholds. nonDepletionProbability reports basic no-shortfall success separately. Runs without seed are stochastic; a supplied seed makes identical inputs repeatable for the same implementation version.
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": {
"currentAge": "<currentAge>",
"retirementAge": "<retirementAge>",
"currentSavings": "<currentSavings>",
"monthlyContribution": "<monthlyContribution>",
"monthlyDrawdown": "<monthlyDrawdown>"
},
"name": "run_retirement_stress_test"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Optional unsigned 32-bit seed for repeatable runs with identical inputs and implementation versions. Omit to keep the run stochastic. | |
| endAge | No | Planning horizon age (default 90). | |
| currentAge | Yes | Age today. | |
| simulations | No | Monte Carlo runs (default 1000). | |
| statePension | No | Expected monthly state pension in EUR. | |
| inflationRate | No | Annual percentage value (e.g. 2.5 for 2.5%). Supply the actual rate unless the user accepts a stated modelling default. | |
| medicalShocks | No | Optional acute-medical and long-term-care sampling assumptions. Medical and market paths are seeded independently. | |
| retirementAge | Yes | Planned retirement age. | |
| currentSavings | Yes | Current investable savings balance in EUR. | |
| pensionStreams | No | Optional annual pension streams that offset retirement drawdown. Concurrent streams are aggregated before applying progressive tax, the single 2026 foreign-pension €5,000 allowance, and the shared personal GESY ceiling. A supplied netAnnualOverride is treated as already net and is used as-is. | |
| monthlyDrawdown | Yes | Planned monthly withdrawal in retirement in EUR. | |
| returnOverrides | No | Optional age-keyed replacement annual nominal return percentages. Each listed age replaces its simulated and deterministic return; the market draw is still consumed so later seeded years remain aligned. | |
| successCriteria | No | Optional nominal thresholds that make success stricter than basic non-depletion. | |
| monthlyContribution | Yes | Monthly contribution until retirement in EUR. | |
| expectedAnnualReturn | No | Annual percentage value (e.g. 2.5 for 2.5%). Supply the actual rate unless the user accepts a stated modelling default. | |
| accumulationVolatility | No | Annual accumulation return volatility in percentage points. | |
| distributionVolatility | No | Annual retirement return volatility in percentage points. | |
| expectedAnnualReturnRetirement | No | Annual percentage value (e.g. 2.5 for 2.5%). Supply the actual rate unless the user accepts a stated modelling default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series | No | ||
| ltcRunRate | Yes | ||
| assumptions | Yes | ||
| acuteRunRate | Yes | ||
| shockRunRate | Yes | ||
| medianDepletionAge | Yes | ||
| successProbability | Yes | ||
| averageDepletionAge | Yes | ||
| medianTerminalWealth | Yes | ||
| nonDepletionProbability | Yes | ||
| deterministicFinalBalance | Yes | ||
| worstCase10thPercentileBalance | Yes |