Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_token_vesting_inflation

Calculate monthly token unlocks, circulating supply inflation, annualized dilution, and market-cap-to-FDV ratio from supply, unlock, and price inputs to assess dilution pressure.

Instructions

Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model. Calculate monthly unlock volume, circulating supply inflation rate, and impending token unlock price pressure for venture-backed Web3 tokens. Discipline: CRYPTO. Governing mathematical model / formula: Monthly Unlock = Total Allocation × (1 - TGE Unlock %) / Vesting Linear Months.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of monthly_supply_inflation_pct (Monthly Supply Inflation Rate), monthly_sell_pressure_usd (Monthly New Dilution Inflow ($)), annualized_inflation_pct (Annualized Supply Dilution), market_cap_to_fdv_ratio (Circulating Mcap / FDV Ratio) using total_token_supply (Total Token Max Supply in Tokens), current_circulating_supply (Current Circulating Supply in Tokens (18%)), monthly_unlock_tokens (Upcoming Monthly Unlock Volume in Tokens/mo), token_price_usd (Current Token Market Price ($)). 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 'Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model' 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): "token-vesting-inflation"

    • category (string): "crypto"

    • name (string): "Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.monthly_supply_inflation_pct (Monthly Supply Inflation Rate): Formatted display string (e.g. '+12.5% / month')

      • metrics.monthly_sell_pressure_usd (Monthly New Dilution Inflow ($)): Formatted display string (e.g. '$28,125,000 / mo')

      • metrics.annualized_inflation_pct (Annualized Supply Dilution): Formatted display string (e.g. '150.0% / year')

      • metrics.market_cap_to_fdv_ratio (Circulating Mcap / FDV Ratio): Formatted display string (e.g. '18.0% (Low Float / High FDV)')

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

Input Schema

NameRequiredDescriptionDefault
token_price_usdNoCurrent Token Market Price ($). Token exchange price. Default: 1.25. Min: 0.01. Max: 500.
total_token_supplyNoTotal Token Max Supply (Tokens). Total supply cap (e.g. 1 Billion tokens). Default: 1000000000. Min: 1000000. Max: 100000000000.
monthly_unlock_tokensNoUpcoming Monthly Unlock Volume (Tokens/mo). Team, investor, and ecosystem unlocks per month. Default: 22500000. Min: 10000. Max: 500000000.
current_circulating_supplyNoCurrent Circulating Supply (Tokens (18%)). Tokens currently liquid and trading. Default: 180000000. Min: 100000. Max: 50000000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools