Fees and take-home at a price
fees_breakdownFees a platform takes from one sale at a given price, split into platform, listing and card processor parts, plus net after fees and, with an optional cost, profit and margin (a fraction). buyer_tax_rate is a FRACTION (0.07 = 7%). US sellers only. Read-only.
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": {
"platform": "<platform>",
"price": "<price>"
},
"name": "fees_breakdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | Optional cost per item in USD, so the answer includes profit and margin. Default 0. | |
| price | Yes | Sale price in USD before buyer sales tax, in whole cents, at least 0.01, e.g. 17. | |
| region | No | Buyer location relative to a US seller. "us" (default) = domestic. "international" is only modelled with processor "paypal" (adds PayPal's 1.50% international fee, so 4.99% + $0.49); other combinations return an error rather than a guess. | |
| platform | Yes | Platform and plan id from list_platforms, e.g. "etsy", "payhip-free", "gumroad-direct", "ko-fi-shop". | |
| processor | No | Card processor for platforms where the seller adds their own (Payhip plans, Ko-fi Shop). "stripe" = 2.9% + $0.30 (default). "paypal" = PayPal Checkout or Guest Checkout, 3.49% + $0.49. Ignored, with a note, for platforms that charge their own processing (Etsy, Shopify, Gumroad, Notion, Square). | |
| buyer_tax_rate | No | Buyer's sales tax as a FRACTION, e.g. 0.07 for 7%. Default 0. Tax is never profit; it only raises card processing on platforms that charge processing on the tax-inclusive total (see each platform's tax_base). | |
| processor_rate | No | Advanced override: your own card processor percentage as a FRACTION (0.029 = 2.9%). Only for platforms where the seller adds their own processor. Replaces the preset's rate. | |
| processor_fixed_usd | No | Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee. |