Profitlee-MCP Server

ProfitLee MCP là một máy chủ MCP dùng để phân tích lợi nhuận thương mại điện tử và thị trường. Nó giúp người dùng tính toán lợi nhuận ròng, biên lợi nhuận, ROI, giá hòa vốn và kết quả điều chỉnh phí từ các đầu vào như chi phí sản phẩm, giá bán, vận chuyển, quảng cáo, phí nền tảng và thuế. Nó cũng hỗ trợ các kịch bản lợi nhuận có thể tái sử dụng để người dùng dễ dàng so sánh các giả định về giá và chi phí.

GitHub

Tài liệu

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