@utilix-tech/mcp 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.24.0
+- Add `calculate_margin_markup` tool: given exactly two of cost, price, margin percent, and markup percent, solve for the other two plus the gross profit.
+
 ## 0.23.0
 - Add `convert_apr_apy` tool: convert between a nominal APR and effective APY for a given compounding frequency, in both directions.
 - Add `convert_iso8601_duration` tool: parse an ISO 8601 duration into components and total seconds, or format seconds into a canonical duration string.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 134 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 135 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
 
 No API key required. All tools run locally. Requires Node.js 18 or later.
 
@@ -152,7 +152,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `convert_timezone` | Convert a date/time between timezones |
 | `convert_iso8601_duration` | Parse an ISO 8601 duration into components and total seconds, or format seconds into a duration string |
 
-### Units (14 tools)
+### Units (15 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -169,6 +169,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `calculate_time_value` | Convert between present and future value (time value of money) in either direction |
 | `calculate_percentage_change` | Compute the percentage change between two numbers, with absolute change, direction, and multiplier |
 | `convert_apr_apy` | Convert between a nominal APR and effective APY for a given compounding frequency, in both directions |
+| `calculate_margin_markup` | Given any two of cost, price, margin percent, and markup percent, solve for the other two plus gross profit |
 
 ### API / Network (10 tools)
 | Tool | Description |

package/dist/index.js

@@ -4058,5 +4058,71 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _MARGIN_FIELDS_MCP = ["cost", "price", "marginPercent", "markupPercent"];
+function _calculateMarginMarkupMcp(input) {
+  const provided = (v) => typeof v === "number" && Number.isFinite(v);
+  const given = _MARGIN_FIELDS_MCP.filter((f) => provided(input[f]));
+  if (given.length !== 2) {
+    return { error: `Provide exactly two of cost, price, marginPercent, markupPercent (got ${given.length})` };
+  }
+  const has = (f) => given.includes(f);
+  const cost0 = input.cost;
+  const price0 = input.price;
+  const margin0 = input.marginPercent;
+  const markup0 = input.markupPercent;
+  if (has("cost") && cost0 <= 0) return { error: "Cost must be greater than zero" };
+  if (has("price") && price0 <= 0) return { error: "Price must be greater than zero" };
+  if (has("marginPercent") && margin0 >= 100) return { error: "Margin percent must be below 100 (a 100% margin implies a zero cost)" };
+  if (has("markupPercent") && markup0 <= -100) return { error: "Markup percent must be greater than -100" };
+  let cost;
+  let price;
+  if (has("cost") && has("price")) {
+    cost = cost0;
+    price = price0;
+  } else if (has("cost") && has("marginPercent")) {
+    cost = cost0;
+    price = cost0 / (1 - margin0 / 100);
+  } else if (has("cost") && has("markupPercent")) {
+    cost = cost0;
+    price = cost0 * (1 + markup0 / 100);
+  } else if (has("price") && has("marginPercent")) {
+    price = price0;
+    cost = price0 * (1 - margin0 / 100);
+  } else if (has("price") && has("markupPercent")) {
+    price = price0;
+    cost = price0 / (1 + markup0 / 100);
+  } else {
+    return { error: "Margin and markup alone cannot be solved: also provide a cost or a price" };
+  }
+  if (!Number.isFinite(cost) || !Number.isFinite(price)) return { error: "Inputs produce a non-finite result" };
+  if (cost <= 0) return { error: "Those inputs imply a cost of zero or less" };
+  if (price <= 0) return { error: "Those inputs imply a price of zero or less" };
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const profit = price - cost;
+  return {
+    cost: round4(cost),
+    price: round4(price),
+    profit: round4(profit),
+    marginPercent: round4(profit / price * 100),
+    markupPercent: round4(profit / cost * 100),
+    given,
+    solvedFor: _MARGIN_FIELDS_MCP.filter((f) => !given.includes(f))
+  };
+}
+server.tool(
+  "calculate_margin_markup",
+  "Solve a pricing triangle: given exactly two of cost, price, gross margin percent, and markup percent, derive the other two plus the gross profit. Margin is profit as a share of the selling price (profit / price) while markup is profit as a share of the cost (profit / cost), so a 20% margin equals a 25% markup. Margin plus markup alone cannot be solved, since neither carries an absolute amount.",
+  {
+    cost: z.number().optional().describe("Unit cost (what you pay). Provide exactly two of the four fields."),
+    price: z.number().optional().describe("Selling price (what the customer pays). Provide exactly two of the four fields."),
+    marginPercent: z.number().optional().describe("Gross margin as a percent of the selling price (must be below 100)"),
+    markupPercent: z.number().optional().describe("Markup as a percent of the cost (must be greater than -100)")
+  },
+  async ({ cost, price, marginPercent, markupPercent }) => {
+    const result = _calculateMarginMarkupMcp({ cost, price, marginPercent, markupPercent });
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "MCP server exposing 125 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",