Marginrule pricing agent is an MCP server published by com.marginrule, hosted at mcp.marginrule.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including price_for_margin, fees_breakdown, discount_impact, compare_plans, list_platforms.
Fee-accurate prices, fees and payouts for Payhip, Ko-fi, Gumroad, Etsy and more. US sellers. Free.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | 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 |
None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
| 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 | 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. |
{
"name": "price_for_margin",
"title": "Lowest price for a target margin",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"title": "Lowest price for a target margin",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | 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 | 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. |
{
"name": "fees_breakdown",
"title": "Fees and take-home at a price",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"title": "Fees and take-home at a price",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | 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. |
{
"name": "discount_impact",
"title": "What a discount does to fees and profit",
"description": "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.",
"inputSchema": {
"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
},
"annotations": {
"title": "What a discount does to fees and profit",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Compares selling plans at your price and monthly sales: Payhip Free, Plus and Pro, Gumroad direct and Discover, Ko-fi Shop and Ko-fi Gold, and Shopify Basic billed monthly or yearly. For each plan: fees per sale, monthly plan cost and what you keep a month after both. Returns the cheapest plan at your volume, the break-even sales a month between tiers (such as Payhip Plus vs Free), and which plan keeps the most at each volume. Every number comes from dated, sourced fee rows; a plan without sourced numbers is left out and named. US sellers, domestic cards. Read-only; sells nothing.
| Parameter | Type | Description |
|---|---|---|
| cost | number | Optional cost per item sold in USD, so the answer adds profit_per_month_usd and counts it in sales_to_cover_plan_cost. Default 0. |
| price * | number | Your sale price per item in USD before buyer sales tax, in whole cents, e.g. 17. |
| platforms | array | Optional filter: families (payhip, gumroad, ko-fi, shopify) and/or plan ids (payhip-free, payhip-plus, payhip-pro, gumroad-direct, gumroad-discover, ko-fi-shop, ko-fi-gold, shopify-basic-monthly, shopify-basic-yearly). Leave it out to compare every plan. |
| processor | string | Card processor for the plans where you add your own (Payhip plans, Ko-fi Shop and Ko-fi Gold). "stripe" = 2.9% + $0.30 (default). "paypal" = PayPal Checkout or Guest Checkout, 3.49% + $0.49. Domestic cards only. Gumroad and Shopify charge their own processing. |
| sales_per_month * | integer | How many sales you make (or expect) in a month, a whole number, e.g. 50. |
{
"name": "compare_plans",
"title": "Which plan keeps the most at my volume",
"description": "Compares selling plans at your price and monthly sales: Payhip Free, Plus and Pro, Gumroad direct and Discover, Ko-fi Shop and Ko-fi Gold, and Shopify Basic billed monthly or yearly. For each plan: fees per sale, monthly plan cost and what you keep a month after both. Returns the cheapest plan at your volume, the break-even sales a month between tiers (such as Payhip Plus vs Free), and which plan keeps the most at each volume. Every number comes from dated, sourced fee rows; a plan without sourced numbers is left out and named. US sellers, domestic cards. Read-only; sells nothing.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"price",
"sales_per_month"
],
"properties": {
"cost": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional cost per item sold in USD, so the answer adds profit_per_month_usd and counts it in sales_to_cover_plan_cost. Default 0."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0.01,
"description": "Your sale price per item in USD before buyer sales tax, in whole cents, e.g. 17."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"payhip",
"gumroad",
"ko-fi",
"shopify",
"payhip-free",
"payhip-plus",
"payhip-pro",
"gumroad-direct",
"gumroad-discover",
"ko-fi-shop",
"ko-fi-gold",
"shopify-basic-monthly",
"shopify-basic-yearly"
],
"type": "string"
},
"maxItems": 13,
"minItems": 1,
"description": "Optional filter: families (payhip, gumroad, ko-fi, shopify) and/or plan ids (payhip-free, payhip-plus, payhip-pro, gumroad-direct, gumroad-discover, ko-fi-shop, ko-fi-gold, shopify-basic-monthly, shopify-basic-yearly). Leave it out to compare every plan."
},
"processor": {
"enum": [
"stripe",
"paypal"
],
"type": "string",
"description": "Card processor for the plans where you add your own (Payhip plans, Ko-fi Shop and Ko-fi Gold). \"stripe\" = 2.9% + $0.30 (default). \"paypal\" = PayPal Checkout or Guest Checkout, 3.49% + $0.49. Domestic cards only. Gumroad and Shopify charge their own processing."
},
"sales_per_month": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "How many sales you make (or expect) in a month, a whole number, e.g. 50."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Which plan keeps the most at my volume",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 parameters.
{
"name": "list_platforms",
"title": "List platforms and fee presets",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List platforms and fee presets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 parameters.
{
"name": "data_version",
"title": "Fee data version and sources",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Fee data version and sources",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Marginrule pricing agent: free, read-only, fee-accurate pricing math for small online sellers (US sellers). Call list_platforms for platform ids, then price_for_margin (lowest whole-cent price that keeps a target margin after fees) or fees_breakdown (fees and take-home at a price), or discount_impact (what a percentage or dollar discount does to fees, profit and the sales needed to make up for it), or compare_plans (which selling plan keeps the most at your price and monthly sales, with break-even sales between tiers). Units: every rate and margin is a FRACTION (0.30 = 30%); money is USD. Every answer carries fees_as_of, source URLs, assumptions and a verify note: Verify on the platform's page before relying on it. Platforms change fees without notice; every rate here carries the date it was read and its source URL. Not tax or accounting advice. Not affiliated with any platform named.
Names, descriptions and schemas were written by the server and are shown as data.