calculate_profit_margin
Calculate profit margin for art supplies using cost and selling price to determine product profitability and inform pricing decisions.
Instructions
Calculate profit margin for a product or category based on cost and selling price.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| costPrice | Yes | Cost price per unit | |
| sku | Yes | Product SKU |
Implementation Reference
- src/index.ts:791-809 (handler)Handler implementation for calculate_profit_margin tool. Looks up product by SKU from mock inventory data, calculates profit per unit and profit margin percentage, and formats a detailed analysis response including potential revenue from current stock.
case 'calculate_profit_margin': { const sku = String(args?.sku || ''); const costPrice = Number(args?.costPrice || 0); const item = storeData.inventory.find(i => i.id === sku); if (!item) { return { content: [{ type: 'text', text: `❌ Product ${sku} not found` }] }; } const profit = item.price - costPrice; const margin = (profit / item.price) * 100; return { content: [{ type: 'text', text: `💰 Profit Analysis: ${item.name}\n\n- Selling Price: $${item.price}\n- Cost Price: $${costPrice.toFixed(2)}\n- Profit per Unit: $${profit.toFixed(2)}\n- Profit Margin: ${margin.toFixed(1)}%\n- Potential Revenue (current stock): $${(item.quantity * profit).toFixed(2)}` }] }; } - src/index.ts:199-210 (schema)Tool schema definition including name, description, and input schema requiring 'sku' (string) and 'costPrice' (number). This is part of the tools array returned by ListToolsRequestHandler.
{ name: 'calculate_profit_margin', description: 'Calculate profit margin for a product or category based on cost and selling price.', inputSchema: { type: 'object', properties: { sku: { type: 'string', description: 'Product SKU' }, costPrice: { type: 'number', description: 'Cost price per unit' }, }, required: ['sku', 'costPrice'], }, }, - src/index.ts:516-518 (registration)Registration of all tools (including calculate_profit_margin via the 'tools' array) for the ListTools MCP request.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; }); - src/dashboard.ts:50-50 (registration)Mock tool listing/registration for dashboard display purposes.
{ name: 'calculate_profit_margin', description: 'Calculate profitability', category: 'Sales & Analytics' },