Required Return
required-returnAnnual return needed to grow a starting value to a target over a number of years, optionally with a fixed annual contribution. With no contribution this equals CAGR. Returns a percent, or null when unreachable.
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": {
"begin": "<begin>",
"end": "<end>",
"years": "<years>"
},
"name": "required-return"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Target ending value. | |
| begin | Yes | Starting value. | |
| years | Yes | Number of years. | |
| annualContribution | No | Optional. Amount added each year (default 0). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ratePct | No | Annual rate, percent (null if unreachable). |