Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_cagr

Calculate Compound Annual Growth Rate (CAGR) and annualized return from beginning value, ending value, and years to get exact investment growth metrics.

Instructions

Compound Annual Growth Rate (CAGR) Calculator. Calculate exact Compound Annual Growth Rate (CAGR) and annualized return across multi-year investment periods. Discipline: FINANCE. Governing mathematical model / formula: CAGR = (Ending Value / Beginning Value)^(1 / Years) - 1.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of cagr_percentage (Compound Annual Growth Rate (CAGR)), total_absolute_growth_pct (Total Absolute Growth), wealth_multiplier (Total Wealth Multiplier) using beginning_value (Beginning Investment Value ($) in $), ending_value (Ending Investment Value ($) in $), years (Investment Duration (Years) in years). 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.

DISAMBIGUATION & BOUNDARIES:

  • Use this dedicated specialist tool for 'Compound Annual Growth Rate (CAGR) Calculator' rather than generic dispatchers like omni_universal_query.

  • For multi-calculation chained jobs, use 'omni_batch_calculate'.

  • To inspect schema fields, see 'omni_describe_solver'.

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): "cagr"

    • category (string): "finance"

    • name (string): "Compound Annual Growth Rate (CAGR) Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.cagr_percentage (Compound Annual Growth Rate (CAGR)): Formatted display string (e.g. '19.60%')

      • metrics.total_absolute_growth_pct (Total Absolute Growth): Formatted display string (e.g. '+250.00%')

      • metrics.wealth_multiplier (Total Wealth Multiplier): Formatted display string (e.g. '3.50×')

    • 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_cagr"
  }
}

Input Schema

NameRequiredDescriptionDefault
yearsNoInvestment Duration (Years) (years). Elapsed years. Default: 7. Min: 0.25. Max: 60.
ending_valueNoEnding Investment Value ($) ($). Value at end of period. Default: 175000. Min: 100. Max: 1000000000.
beginning_valueNoBeginning Investment Value ($) ($). Initial value at start of period. Default: 50000. Min: 100. Max: 100000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools