Profitlee-MCP Server

ProfitLee MCP est un serveur MCP pour analyser la rentabilité du commerce électronique et des places de marché. Il aide les utilisateurs à calculer le bénéfice net, la marge bénéficiaire, le retour sur investissement, le prix d'équilibre et les résultats ajustés des frais à partir du coût du produit, du prix de vente, de l'expédition, des publicités, des frais de plateforme et des données fiscales. Il prend également en charge des scénarios de profit réutilisables afin que les utilisateurs puissent comparer plus facilement les prix et les hypothèses de coûts.

GitHub

Documentation

profitlee-mcp

An MCP server for Profitlee — compute country-accurate Amazon FBA/FBM and TikTok Shop profit margins, and manage saved scenarios, from any MCP client (Claude Desktop, Claude Code, Cursor, …).

calculate_profit is free and needs no token. The scenario tools require a Profitlee Pro API token.

MCP registry name: io.github.AronLEEdev/profitlee-mcp

Quick start

Add to your MCP client config:

{
  "mcpServers": {
    "profitlee": {
      "command": "npx",
      "args": ["-y", "profitlee-mcp"],
      "env": {
        "PROFITLEE_API_TOKEN": "eck_live_xxx"
      }
    }
  }
}

PROFITLEE_API_TOKEN is optional — omit the whole env block to use calculate_profit only. Create a token on your Profitlee account page to unlock the scenario tools.

Requires Node.js 20+.

Tools

Tool	Auth	Description
`calculate_profit`	none	Full per-unit cost stack, gross/net margin, and monthly P&L.
`list_scenarios`	Pro token	List your saved scenarios.
`get_scenario`	Pro token	Read one scenario (inputs + outputs) by id.
`save_scenario`	Pro token	Save a named scenario from calculator inputs.
`update_scenario`	Pro token	Rename and/or replace a scenario's inputs.
`delete_scenario`	Pro token	Delete a scenario by id.
`copy_scenario`	Pro token	Duplicate a scenario into a new one ("Copy of …").

`calculate_profit` inputs

Pick a platform + mode, give the product's physical and cost details, and Profitlee folds every fee into a single net margin. Rates are 0–1 decimals (e.g. 0.15 = 15%). US uses inches + pounds; DE/JP use cm + kg.

Field	Notes
`platform`	`amazon` (default) or `tiktok_shop`.
`region`	`us`, `de`, or `jp`.
`mode`	amazon: `fba` \| `fbm`. tiktok_shop: `fbt` \| `self_fulfilled`.
`L`, `W`, `H`, `weight`	Dimensions + unit weight.
`fob`, `headShip`, `duty`	Unit cost, inbound freight/unit, import duty/unit.
`price`	Selling price (gross; VAT-inclusive for DE/JP).
`ppcAcos`, `returnRate`	Ad ACoS and return rate (0–1).
`monthlyVolume`	Units/month (scales the P&L).
`referralPct`	Referral fee (0–1). Preferred over `referralCategory`.
`isApparel`	Affects some fees.
mode-specific	FBA: `inboundOption`, `storageMonths`, `storageSeason`. FBM / TikTok self-fulfilled: `outboundShipPerUnit`, `pickPackPerUnit`, `monthly3plStorage`. TikTok FBT: `storageMonthsPastFree`.

The Profitlee API is the source of truth for validation — incomplete or out-of-range inputs come back as a clear error listing the offending fields. Full field reference: https://profitlee.com/docs/api.

Environment variables

Var	Required	Default	Purpose
`PROFITLEE_API_TOKEN`	No	—	Pro token (`eck_live_…`); needed only for the scenario tools.
`PROFITLEE_BASE_URL`	No	`https://profitlee.com`	Override the API origin (testing).

How it works

The server is a thin wrapper over Profitlee's public HTTP API:

calculate_profit → POST /api/v1/calculate (public, no token).
scenario tools → /api/v1/scenarios* (require the Pro token; the server fails fast with a clear message if it's missing).

No fee logic is reimplemented here, so results always match the live Profitlee calculator and current fee tables.

Development

npm install
npm test       # vitest (27 tests)
npm run build  # tsc -> dist/
npm run dev    # run from source with tsx

Releasing

Maintainers: see PUBLISHING.md for npm publish + MCP registry steps. The registry manifest lives in server.json.

License

MIT