Fee-accurate prices, fees and payouts for Payhip, Ko-fi, Gumroad, Etsy and more. US sellers. Free.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Dataset version, fees-as-of date per platform and processor, SHA-256 of the embedded fee data and engine, and every source URL. Use it to cite or cache answers.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http pricing https://mcp.marginrule.com/mcp
Dataset version, fees-as-of date per platform and processor, SHA-256 of the embedded fee data and engine, and every source URL. Use it to cite or cache answers.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Effect of a percentage or fixed-dollar discount (a sale or promo code) on one item: discounted price, fees and profit at list and at the discounted price, the profit lost per sale, and how many discounted sales it takes to earn the same profit as 100 sales at list. With an optional target_margin it also returns the deepest discount that still keeps that margin after fees. Rates and margins are FRACTIONS (0.25 = 25% off). US sellers only. Read-only; sells nothing.
| Argument | Type | Description |
|---|---|---|
| cost | number | Optional cost per item in USD, so profit and margin are included. Default 0. |
| region | string | 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* | string | Platform and plan id from list_platforms, e.g. "etsy", "payhip-free", "gumroad-direct", "ko-fi-shop". |
| processor | string | 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). |
| list_price* | number | Regular price in USD before the discount and before buyer sales tax, in whole cents, e.g. 20. |
| discount_usd | number | Fixed dollars off per item, in whole cents, e.g. 5. Send this OR discount_rate, not both. |
| discount_rate | number | Percentage off as a FRACTION: 0.25 means 25% off, used to 6 decimals. Send this OR discount_usd, not both. The dollar amount off is rounded to the cent, half away from zero. |
| target_margin | number | Optional target profit margin as a FRACTION (0.30 = 30%). If sent, the answer also gives the deepest discount off list_price that still keeps it, and whether this discount keeps it. |
| buyer_tax_rate | number | 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 | number | 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 | number | Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"platform",
"list_price"
],
"properties": {
"cost": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional cost per item in USD, so profit and margin are included. Default 0."
},
"region": {
"enum": [
"us",
"international"
],
"type": "string",
"description": "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": {
"enum": [
"etsy",
"shopify-basic",
"payhip-free",
"payhip-plus",
"payhip-pro",
"gumroad-direct",
"gumroad-discover",
"ko-fi-shop",
"notion-marketplace",
"square-online",
"square-in-person"
],
"type": "string",
"description": "Platform and plan id from list_platforms, e.g. \"etsy\", \"payhip-free\", \"gumroad-direct\", \"ko-fi-shop\"."
},
"processor": {
"enum": [
"stripe",
"paypal"
],
"type": "string",
"description": "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)."
},
"list_price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0.01,
"description": "Regular price in USD before the discount and before buyer sales tax, in whole cents, e.g. 20."
},
"discount_usd": {
"type": "number",
"maximum": 1000000000,
"description": "Fixed dollars off per item, in whole cents, e.g. 5. Send this OR discount_rate, not both.",
"exclusiveMinimum": 0
},
"discount_rate": {
"type": "number",
"description": "Percentage off as a FRACTION: 0.25 means 25% off, used to 6 decimals. Send this OR discount_usd, not both. The dollar amount off is rounded to the cent, half away from zero.",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0
},
"target_margin": {
"type": "number",
"minimum": 0,
"description": "Optional target profit margin as a FRACTION (0.30 = 30%). If sent, the answer also gives the deepest discount off list_price that still keeps it, and whether this discount keeps it.",
"exclusiveMaximum": 1
},
"buyer_tax_rate": {
"type": "number",
"minimum": 0,
"description": "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).",
"exclusiveMaximum": 1
},
"processor_rate": {
"type": "number",
"maximum": 0.2,
"minimum": 0,
"description": "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": {
"type": "number",
"maximum": 5,
"minimum": 0,
"description": "Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee."
}
},
"additionalProperties": false
}Fees 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.
| Argument | Type | Description |
|---|---|---|
| cost | number | Optional cost per item in USD, so the answer includes profit and margin. Default 0. |
| price* | number | Sale price in USD before buyer sales tax, in whole cents, at least 0.01, e.g. 17. |
| region | string | 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* | string | Platform and plan id from list_platforms, e.g. "etsy", "payhip-free", "gumroad-direct", "ko-fi-shop". |
| processor | string | 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 | number |
Every platform and plan this server knows (Etsy, Shopify Basic, Payhip Free/Plus/Pro, Gumroad direct/Discover, Ko-fi Shop, Notion Marketplace, Square online/in person) with its rates as fractions, fixed and listing fees in USD, monthly plan fee, whether it sells digital downloads, whether the seller adds their own processor, the tax-base flag, fees-as-of date and source URLs. Also the card processor presets. Call this first to get valid platform ids.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Lowest whole-cent price that keeps a target profit margin on a selling platform after its fees, for a given cost per item. status is "ok", "not_possible" or "not_practical". With "ok" it returns price_usd, the fee breakdown at that price, profit_usd and the achieved margin. target_margin is a FRACTION of the price (0.30 = 30%). Rates are dated and sourced; read 'assumptions' and 'verify' before quoting. US sellers only. Read-only; sells nothing.
| Argument | Type | Description |
|---|---|---|
| cost* | number | Your cost per item sold in USD (materials, labour, packaging you pay). 0 for a digital download with no per-sale cost. |
| region | string | 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* | string | Platform and plan id from list_platforms, e.g. "etsy", "payhip-free", "gumroad-direct", "ko-fi-shop". |
| processor | string | 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). |
| target_margin* | number |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| 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 | number | 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 | number | Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"platform",
"price"
],
"properties": {
"cost": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional cost per item in USD, so the answer includes profit and margin. Default 0."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0.01,
"description": "Sale price in USD before buyer sales tax, in whole cents, at least 0.01, e.g. 17."
},
"region": {
"enum": [
"us",
"international"
],
"type": "string",
"description": "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": {
"enum": [
"etsy",
"shopify-basic",
"payhip-free",
"payhip-plus",
"payhip-pro",
"gumroad-direct",
"gumroad-discover",
"ko-fi-shop",
"notion-marketplace",
"square-online",
"square-in-person"
],
"type": "string",
"description": "Platform and plan id from list_platforms, e.g. \"etsy\", \"payhip-free\", \"gumroad-direct\", \"ko-fi-shop\"."
},
"processor": {
"enum": [
"stripe",
"paypal"
],
"type": "string",
"description": "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": {
"type": "number",
"minimum": 0,
"description": "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).",
"exclusiveMaximum": 1
},
"processor_rate": {
"type": "number",
"maximum": 0.2,
"minimum": 0,
"description": "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": {
"type": "number",
"maximum": 5,
"minimum": 0,
"description": "Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee."
}
},
"additionalProperties": false
}| Target profit margin as a FRACTION of the price: profit / price. 0.30 means 30%. Must be at least 0 and under 1. A value like 30 is rejected as a percent. Margins below 0.0001 are treated as 0. Within 0.01 of the platform's maximum (1 minus its percentage fees) the answer is status "not_practical". |
| buyer_tax_rate | number | 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 | number | 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. |
| price_floor_usd | number | Lowest price to suggest, in USD. Default 1.00 (Marginrule's assumption, not a platform rule). 0 turns the floor off. |
| processor_fixed_usd | number | Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"platform",
"cost",
"target_margin"
],
"properties": {
"cost": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your cost per item sold in USD (materials, labour, packaging you pay). 0 for a digital download with no per-sale cost."
},
"region": {
"enum": [
"us",
"international"
],
"type": "string",
"description": "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": {
"enum": [
"etsy",
"shopify-basic",
"payhip-free",
"payhip-plus",
"payhip-pro",
"gumroad-direct",
"gumroad-discover",
"ko-fi-shop",
"notion-marketplace",
"square-online",
"square-in-person"
],
"type": "string",
"description": "Platform and plan id from list_platforms, e.g. \"etsy\", \"payhip-free\", \"gumroad-direct\", \"ko-fi-shop\"."
},
"processor": {
"enum": [
"stripe",
"paypal"
],
"type": "string",
"description": "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)."
},
"target_margin": {
"type": "number",
"minimum": 0,
"description": "Target profit margin as a FRACTION of the price: profit / price. 0.30 means 30%. Must be at least 0 and under 1. A value like 30 is rejected as a percent. Margins below 0.0001 are treated as 0. Within 0.01 of the platform's maximum (1 minus its percentage fees) the answer is status \"not_practical\".",
"exclusiveMaximum": 1
},
"buyer_tax_rate": {
"type": "number",
"minimum": 0,
"description": "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).",
"exclusiveMaximum": 1
},
"processor_rate": {
"type": "number",
"maximum": 0.2,
"minimum": 0,
"description": "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."
},
"price_floor_usd": {
"type": "number",
"maximum": 1000,
"minimum": 0,
"description": "Lowest price to suggest, in USD. Default 1.00 (Marginrule's assumption, not a platform rule). 0 turns the floor off."
},
"processor_fixed_usd": {
"type": "number",
"maximum": 5,
"minimum": 0,
"description": "Advanced override: your card processor's fixed fee per sale in USD, e.g. 0.30. Replaces the preset's fixed fee."
}
},
"additionalProperties": false
}