Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_tiered_affiliate_commission

Calculate tiered affiliate commission payouts, platform tracking overrides, and net return from sales volume, base/elevated rates, thresholds, and network fees.

Instructions

Tiered Affiliate Marketing Commission & Payout Calculator. Calculate blended affiliate commission payouts, network platform tracking overrides, and net affiliate return across tiered sales performance brackets. Discipline: ECOMMERCE. Governing mathematical model / formula: Total Payout = Tier 1 Payout + Tier 2 Payout + Network Override Fee.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of total_affiliate_payout (Total Affiliate Partner Commission), platform_tracking_fee_total (Network Platform Override Fees), effective_blended_commission_pct (Effective Blended Partner Rate), total_partner_acquisition_cost (Total Program Acquisition Cost) using affiliate_generated_sales (Affiliate Driven Sales Volume in $), tier_1_base_commission_pct (Tier 1 Base Commission (%) in %), tier_2_volume_threshold (Tier 2 Performance Threshold in $), tier_2_elevated_commission_pct (Tier 2 Elevated Commission (%) in %), network_platform_override_pct (SaaS Platform Network Fee (%) in %). 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 'Tiered Affiliate Marketing Commission & Payout 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): "tiered-affiliate-commission"

    • category (string): "ecommerce"

    • name (string): "Tiered Affiliate Marketing Commission & Payout Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.total_affiliate_payout (Total Affiliate Partner Commission): Formatted display string (e.g. '$8,250')

      • metrics.platform_tracking_fee_total (Network Platform Override Fees): Formatted display string (e.g. '$1,625')

      • metrics.effective_blended_commission_pct (Effective Blended Partner Rate): Formatted display string (e.g. '12.69%')

      • metrics.total_partner_acquisition_cost (Total Program Acquisition Cost): Formatted display string (e.g. '$9,875 (15.19% of Sales)')

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

Input Schema

NameRequiredDescriptionDefault
tier_2_volume_thresholdNoTier 2 Performance Threshold ($). Sales threshold where higher commission tier unlocks. Default: 30000. Min: 5000. Max: 200000.
affiliate_generated_salesNoAffiliate Driven Sales Volume ($). Total verified sales generated by affiliate partner. Default: 65000. Min: 1000. Max: 1000000.
tier_1_base_commission_pctNoTier 1 Base Commission (%) (%). Base commission rate up to threshold volume. Default: 10. Min: 2. Max: 35.
network_platform_override_pctNoSaaS Platform Network Fee (%) (%). Impact.com, ShareASale, or CJ Affiliate tracking fee. Default: 2.5. Min: 0. Max: 10.
tier_2_elevated_commission_pctNoTier 2 Elevated Commission (%) (%). Higher rate applied to sales above the tier 2 threshold. Default: 15. Min: 5. Max: 50.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools