Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_email_marketing_roi

Calculate email campaign open rates, click-through rates, conversions, revenue, and net ROI from list size, rates, AOV, and cost to prevent manual arithmetic errors.

Instructions

Email Marketing Campaign ROI Calculator. Calculate open rates, click-through rates (CTR), conversion yields, total campaign revenue, and net ROI percentage. Discipline: FINANCE. Governing mathematical model / formula: ROI % = [(Campaign Revenue - Campaign Cost) / Campaign Cost] × 100.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of total_campaign_revenue (Total Campaign Revenue), campaign_roi_pct (Net Campaign ROI), total_clicks (Total Click-Throughs), total_orders (Total Orders Generated) using list_size (Email List Size (Recipients)), open_rate_pct (Open Rate (%) in %), ctr_pct (Click-Through Rate (CTR %) in %), conversion_pct (Purchase Conversion Rate in %), aov_input (Average Order Value (AOV)), campaign_cost (Total Campaign Cost). 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 'Email Marketing Campaign ROI 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): "email-marketing-roi"

    • category (string): "finance"

    • name (string): "Email Marketing Campaign ROI Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.total_campaign_revenue (Total Campaign Revenue): Formatted display string (e.g. '$4,500.00')

      • metrics.campaign_roi_pct (Net Campaign ROI): Formatted display string (e.g. '500.00%')

      • metrics.total_clicks (Total Click-Throughs): Formatted display string (e.g. '800 clicks')

      • metrics.total_orders (Total Orders Generated): Formatted display string (e.g. '36 orders')

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

Input Schema

NameRequiredDescriptionDefault
ctr_pctNoClick-Through Rate (CTR %) (%). Percentage of total delivered emails clicked. Default: 3.2. Min: 0.1. Max: 30.
aov_inputNoAverage Order Value (AOV). Average dollars spent per checkout. Default: 125. Min: 5. Max: 10000.
list_sizeNoEmail List Size (Recipients). Total emails sent in blast. Default: 25000. Min: 100. Max: 5000000.
campaign_costNoTotal Campaign Cost. Copywriter, ESP fees, design. Default: 750. Min: 10. Max: 50000.
open_rate_pctNoOpen Rate (%) (%). Average B2B/eCommerce open rate: 20-30%. Default: 24. Min: 1. Max: 90.
conversion_pctNoPurchase Conversion Rate (%). Clicks converting into paid orders. Default: 4.5. Min: 0.5. Max: 50.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools