omni_direct_mail_catalog_roi
Calculates direct mail postcard, flyer, and catalog campaign ROI: total cost, attributed revenue, net ROI, CPA, and breakeven response rate from volume, cost, AOV, margin, and response inputs.
Instructions
Direct Mail Postcard & Catalog Campaign ROI Calculator. Calculate Customer Acquisition Cost (CPA), breakeven response rate, and net ROI for direct mail postcard, flyer, and retail catalog campaigns. Discipline: ECOMMERCE. Governing mathematical model / formula: Breakeven Response Rate % = [Cost Per Piece / (AOV × Gross Margin %)] × 100 | ROI = [(Revenue - Cost) / Cost] × 100.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_campaign_cost (Total Campaign Investment), total_attributed_revenue (Total Generated Revenue), net_campaign_roi_pct (Net Campaign ROI (%)), cost_per_acquired_customer (Cost Per Acquired Customer (CPA)) using total_pieces_mailed (Total Mailers Sent in pieces), cost_per_piece_all_in (Cost Per Piece (Print + Postage + List) in $), average_order_value_aov (Average Order Value (AOV) in $), campaign_response_rate_pct (Mail Response Rate (%) in %), product_gross_margin_pct (Product Gross 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 'Direct Mail Postcard & Catalog 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): "direct-mail-catalog-roi"
category (string): "ecommerce"
name (string): "Direct Mail Postcard & Catalog 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_cost (Total Campaign Investment): Formatted display string (e.g. '$21,250')
metrics.total_attributed_revenue (Total Generated Revenue): Formatted display string (e.g. '$51,750')
metrics.net_campaign_roi_pct (Net Campaign ROI (%)): Formatted display string (e.g. '143.5%')
metrics.cost_per_acquired_customer (Cost Per Acquired Customer (CPA)): Formatted display string (e.g. '$47.22 / customer')
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_direct_mail_catalog_roi"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total_pieces_mailed | No | Total Mailers Sent (pieces). Total postcards or catalogs mailed via USPS EDDM or targeted list. Default: 25000. Min: 500. Max: 1000000. | |
| cost_per_piece_all_in | No | Cost Per Piece (Print + Postage + List) ($). Printing, addressing, list rental, and USPS postage per mailer. Default: 0.85. Min: 0.25. Max: 5. | |
| average_order_value_aov | No | Average Order Value (AOV) ($). Average checkout value generated from mail response. Default: 115. Min: 10. Max: 1000. | |
| product_gross_margin_pct | No | Product Gross Margin (%) (%). Gross margin after merchandise COGS. Default: 65. Min: 15. Max: 95. | |
| campaign_response_rate_pct | No | Mail Response Rate (%) (%). Percentage of recipients who make a purchase using promo code/QR. Default: 1.8. Min: 0.1. Max: 10. |