Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_staking_rewards_apr_apy

Calculate net staking APR/APY, validator commission, and compounded annual token or USD rewards for proof-of-stake networks from staked amount, token price, base APR, fee, and compounding frequency.

Instructions

Proof-of-Stake Validator Staking Yield (APR vs APY) Calculator. Calculate annual staking returns, validator commission deduction, and compound APY for Ethereum, Solana, Cosmos, and Avalanche proof-of-stake networks. Discipline: CRYPTO. Governing mathematical model / formula: APY = (1 + [APR · (1 - Commission)] / n)ⁿ - 1 | Terminal Value = Principal × (1 + APY)ᵗ.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of net_annual_apy_pct (Net Effective APY), annual_dollar_earnings (Annual Staking Yield ($ USD)), annual_token_rewards (Tokens Earned Per Year), commission_paid_usd (Validator Fee Paid) using staked_token_amount (Staked Token Quantity in Tokens (e.g. ETH)), token_price_usd (Token Market Price ($)), network_base_apr_pct (Network Gross Staking APR (%) in %), validator_commission_pct (Validator / Pool Fee (%) in %), compounding_frequency (Reward Compounding (1=Annual, 12=Monthly, 365=Daily)). 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 'Proof-of-Stake Validator Staking Yield (APR vs APY) 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): "staking-rewards-apr-apy"

    • category (string): "crypto"

    • name (string): "Proof-of-Stake Validator Staking Yield (APR vs APY) Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.net_annual_apy_pct (Net Effective APY): Formatted display string (e.g. '4.07%')

      • metrics.annual_dollar_earnings (Annual Staking Yield ($ USD)): Formatted display string (e.g. '$4,168.00 / yr')

      • metrics.annual_token_rewards (Tokens Earned Per Year): Formatted display string (e.g. '1.30 Tokens')

      • metrics.commission_paid_usd (Validator Fee Paid): Formatted display string (e.g. '$219.00 / yr')

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

Input Schema

NameRequiredDescriptionDefault
token_price_usdNoToken Market Price ($). Current spot exchange price. Default: 3200. Min: 0.1. Max: 100000.
staked_token_amountNoStaked Token Quantity (Tokens (e.g. ETH)). Number of native tokens staked. Default: 32. Min: 0.1. Max: 100000.
network_base_apr_pctNoNetwork Gross Staking APR (%) (%). Protocol emission rate plus MEV tips. Default: 4.2. Min: 1. Max: 50.
compounding_frequencyNoReward Compounding (1=Annual, 12=Monthly, 365=Daily). Compounding frequency of restaked rewards. Default: 365. Min: 1. Max: 365.
validator_commission_pctNoValidator / Pool Fee (%) (%). Staking pool fee (e.g. Lido = 10%, Rocket Pool = 8%). Default: 5. Min: 0. Max: 25.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools