omni_drip
Calculate dividend reinvestment compounding to project final portfolio value, annual dividend income, and yield on cost from initial investment, yield, dividend growth, price appreciation, and holding period.
Instructions
Dividend Reinvestment (DRIP) Calculator. Simulate exponential compounding through automatic dividend reinvestment (DRIP), dividend growth rates, and recurring cash contributions. Discipline: FINANCE. Governing mathematical model / formula: Total Shares(t+1) = Shares(t) + [Dividends Paid / Share Price].
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of final_portfolio_value (Final Portfolio Balance), annual_dividend_income (Final Annual Passive Income), yield_on_cost (Yield on Cost (YoC)) using starting_principal (Initial Investment ($)), dividend_yield (Annual Dividend Yield (%) in %), dividend_growth (Annual Dividend Growth Rate (%) in %), share_price_appreciation (Annual Capital Appreciation (%) in %), holding_years (Investment Horizon (Years) in yrs). 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 'Dividend Reinvestment (DRIP) 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): "drip"
category (string): "finance"
name (string): "Dividend Reinvestment (DRIP) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.final_portfolio_value (Final Portfolio Balance): Formatted display string (e.g. '$182,450.00')
metrics.annual_dividend_income (Final Annual Passive Income): Formatted display string (e.g. '$9,840.00')
metrics.yield_on_cost (Yield on Cost (YoC)): Formatted display string (e.g. '39.4%')
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_drip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holding_years | No | Investment Horizon (Years) (yrs). Years of compounding. Default: 20. Min: 1. Max: 40. | |
| dividend_yield | No | Annual Dividend Yield (%) (%). Starting annual dividend yield. Default: 4.2. Min: 0.5. Max: 15. | |
| dividend_growth | No | Annual Dividend Growth Rate (%) (%). Annual rate at which dividends increase. Default: 6.5. Min: 0. Max: 20. | |
| starting_principal | No | Initial Investment ($). Starting portfolio balance. Default: 25000. Min: 1000. Max: 1000000. | |
| share_price_appreciation | No | Annual Capital Appreciation (%) (%). Stock price annual appreciation. Default: 5. Min: 0. Max: 20. |