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

`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.

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: .

Environment variables

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