omni_viral_coefficient
Calculates viral coefficient (K-factor), growth multiplier, and new users from invites sent, conversion rate, and cohort size to quantify referral-driven expansion and classify virality.
Instructions
Viral Coefficient (K-Factor) & Growth Calculator. Calculate K-factor viral expansion, viral cycle time, customer compounding multiplier, and organic user generation. Discipline: FINANCE. Governing mathematical model / formula: K = Number of Invites per User × Referral Conversion Rate %.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of k_factor_score (Viral Coefficient (K-Factor)), virality_status (Virality Classification), viral_multiplier (Total Growth Multiplier), cycle1_growth (Cycle 1 New Viral Users) using invites_sent (Invites Sent per Customer in invites), conversion_rate_pct (Invite Acceptance / Conversion Rate in %), initial_cohort (Initial Cohort Size). 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 'Viral Coefficient (K-Factor) & Growth 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): "viral-coefficient"
category (string): "finance"
name (string): "Viral Coefficient (K-Factor) & Growth Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.k_factor_score (Viral Coefficient (K-Factor)): Formatted display string (e.g. '1.13')
metrics.virality_status (Virality Classification): Formatted display string (e.g. 'True Exponential Virality (K > 1.0)')
metrics.viral_multiplier (Total Growth Multiplier): Formatted display string (e.g. 'Infinite (Self-Sustaining Exponential)')
metrics.cycle1_growth (Cycle 1 New Viral Users): Formatted display string (e.g. '1,125 users')
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_viral_coefficient"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| invites_sent | No | Invites Sent per Customer (invites). Average referral invitations sent by each user. Default: 4.5. Min: 0.1. Max: 50. | |
| initial_cohort | No | Initial Cohort Size. Starting seed user population. Default: 1000. Min: 10. Max: 1000000. | |
| conversion_rate_pct | No | Invite Acceptance / Conversion Rate (%). Percentage of invited users who register. Default: 25. Min: 1. Max: 100. |