Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_roas

Calculate ROAS, breakeven ROAS, net ad profit, and campaign profitability from ad spend, attributed revenue, and profit margin, replacing LLM arithmetic with deterministic finance results.

Instructions

Return on Ad Spend (ROAS) & Breakeven Calculator. Calculate ROAS, Breakeven ROAS from product profit margin, net advertising profit, and target ad budget scale. Discipline: FINANCE. Governing mathematical model / formula: ROAS = Ad Revenue Generated / Total Ad Spend | Breakeven ROAS = 1 / Profit Margin %.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of current_roas (Achieved ROAS), breakeven_roas (Mandatory Breakeven ROAS), net_ad_profit (Net Profit After Ad Spend), campaign_status (Campaign Profitability) using ad_spend (Total Advertising Spend), revenue_generated (Attributed Revenue Generated), profit_margin_pct (Gross Product Profit Margin 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 'Return on Ad Spend (ROAS) & Breakeven 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): "roas"

    • category (string): "finance"

    • name (string): "Return on Ad Spend (ROAS) & Breakeven Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.current_roas (Achieved ROAS): Formatted display string (e.g. '3.50× (350%)')

      • metrics.breakeven_roas (Mandatory Breakeven ROAS): Formatted display string (e.g. '2.50× (250%)')

      • metrics.net_ad_profit (Net Profit After Ad Spend): Formatted display string (e.g. '$4,000.00')

      • metrics.campaign_status (Campaign Profitability): Formatted display string (e.g. 'Profitable (Surpassing Breakeven)')

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

Input Schema

NameRequiredDescriptionDefault
ad_spendNoTotal Advertising Spend. Paid Google, Meta, TikTok ad spend. Default: 10000. Min: 100. Max: 10000000.
profit_margin_pctNoGross Product Profit Margin (%). Margin before advertising expenses. Default: 40. Min: 5. Max: 95.
revenue_generatedNoAttributed Revenue Generated. Total gross sales driven by ads. Default: 35000. Min: 100. Max: 50000000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools