omni_margin_markup
Converts between gross profit margin and markup percentage, calculates target selling prices, and eliminates pricing confusion for accurate financial analysis.
Instructions
Margin vs Markup Multiplier Calculator. Convert between Gross Profit Margin and Markup percentage, calculate target selling prices, and eliminate pricing confusion. Discipline: FINANCE. Governing mathematical model / formula: Margin % = Markup / (1 + Markup) vs Markup % = Margin / (1 - Margin).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of gross_margin_pct (Gross Profit Margin), markup_pct (Markup on Cost), gross_profit_dollars (Gross Profit ($)) using item_cost (Cost of Goods Sold (COGS)), selling_price (Selling Price to Customer). 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.
SIBLING ROUTING: Use this dedicated specialist tool for 'Margin vs Markup Multiplier Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
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): "margin-markup"
category (string): "finance"
name (string): "Margin vs Markup Multiplier Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.gross_margin_pct (Gross Profit Margin): Formatted display string (e.g. '36.00%')
metrics.markup_pct (Markup on Cost): Formatted display string (e.g. '56.25%')
metrics.gross_profit_dollars (Gross Profit ($)): Formatted display string (e.g. '$45.00')
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_margin_markup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_cost | No | Cost of Goods Sold (COGS). Wholesale or manufacturing cost. Default: 80. Min: 1. Max: 50000. | |
| selling_price | No | Selling Price to Customer. Retail sales price. Default: 125. Min: 1. Max: 100000. |