profitlee-mcp

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