Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

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

NameRequiredDescriptionDefault
holding_yearsNoInvestment Horizon (Years) (yrs). Years of compounding. Default: 20. Min: 1. Max: 40.
dividend_yieldNoAnnual Dividend Yield (%) (%). Starting annual dividend yield. Default: 4.2. Min: 0.5. Max: 15.
dividend_growthNoAnnual Dividend Growth Rate (%) (%). Annual rate at which dividends increase. Default: 6.5. Min: 0. Max: 20.
starting_principalNoInitial Investment ($). Starting portfolio balance. Default: 25000. Min: 1000. Max: 1000000.
share_price_appreciationNoAnnual Capital Appreciation (%) (%). Stock price annual appreciation. Default: 5. Min: 0. Max: 20.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools