Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_net_promoter_score

Calculates Net Promoter Score from promoter, passive, and detractor counts, returning NPS, respondent totals, and share percentages with deterministic precision.

Instructions

Net Promoter Score (NPS) Calculator. Calculate Net Promoter Score (NPS), Promoters (9-10), Passives (7-8), Detractors (0-6), and statistical standard error margin. Discipline: FINANCE. Governing mathematical model / formula: NPS = % Promoters (9-10) - % Detractors (0-6).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of nps_score (Net Promoter Score (NPS)), total_respondents (Total Survey Respondents), promoter_share (Promoter Share (%)), detractor_share (Detractor Share (%)) using promoters_count (Promoters (Rated 9 or 10)), passives_count (Passives (Rated 7 or 8)), detractors_count (Detractors (Rated 0 through 6)). 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 'Net Promoter Score (NPS) 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): "net-promoter-score"

    • category (string): "finance"

    • name (string): "Net Promoter Score (NPS) Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.nps_score (Net Promoter Score (NPS)): Formatted display string (e.g. '+55.0')

      • metrics.total_respondents (Total Survey Respondents): Formatted display string (e.g. '1,000 responses')

      • metrics.promoter_share (Promoter Share (%)): Formatted display string (e.g. '65.0%')

      • metrics.detractor_share (Detractor Share (%)): Formatted display string (e.g. '10.0%')

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

Input Schema

NameRequiredDescriptionDefault
passives_countNoPassives (Rated 7 or 8). Satisfied but unenthusiastic accounts. Default: 250. Min: 0. Max: 1000000.
promoters_countNoPromoters (Rated 9 or 10). Loyal enthusiasts who refer others. Default: 650. Min: 0. Max: 1000000.
detractors_countNoDetractors (Rated 0 through 6). Unhappy customers prone to churn. Default: 100. Min: 0. Max: 1000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools