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