Profit margin and markup on a sale
business.marginUse this when a trader gives what an item costs them and either what they sell it for, the margin they want, or the markup they want, and asks for the profit, the margin, the markup or what to sell it for (for example "I buy a bag of rice for 800 and want a 20% margin"). It keeps margin (a share of the sale) and markup (a share of the cost) apart, which are often confused. Do not use it for tax on a sale (use a VAT tool), for exchange rates, or to suggest what the market will pay.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cost": "<cost>"
},
"name": "business.margin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | Yes | What one item costs the seller to buy or make. | |
| currency | No | The currency, as its three-letter code (GHS, NGN, KES, ZAR...). Only labels the answer; leave out if unknown. | |
| sale_amount | No | What one item is sold for. Give this, or margin_percent, or markup_percent. | |
| margin_percent | No | The profit wanted as a per cent of the sale amount. | |
| markup_percent | No | The profit wanted as a per cent of the cost. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | Yes | ||
| note | Yes | ||
| profit | Yes | ||
| currency | No | ||
| explore_url | No | ||
| sale_amount | Yes | ||
| margin_percent | Yes | ||
| markup_percent | Yes |