English Français العربية

io.github.AronLEEdev/profitlee-mcp

Official registry E-commerce

MCP server for the Profitlee ecommerce profit calculator (Amazon FBA/FBM + TikTok Shop).

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package profitlee-mcp
Claude Code 
claude mcp add profitlee-mcp -e 'PROFITLEE_API_TOKEN=<your profitlee_api_token>' -e 'PROFITLEE_BASE_URL=<PROFITLEE_BASE_URL>' -- npx -y profitlee-mcp@0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "profitlee-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "profitlee-mcp@0.2.1"
            ],
            "env": {
                "PROFITLEE_API_TOKEN": "<your profitlee_api_token>",
                "PROFITLEE_BASE_URL": "<PROFITLEE_BASE_URL>"
            }
        }
    }
}

Environment variables

  • PROFITLEE_API_TOKEN secret Profitlee Pro API token (eck_live_...). Required only for the scenario tools; calculate_profit works without it.
  • PROFITLEE_BASE_URL Override the Profitlee API origin (default https://profitlee.com). For testing.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. profitlee-mcp
  2. Quick start
  3. Tools
  4. Environment variables
  5. How it works
  6. Development
  7. Releasing
  8. License

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

ToolAuthDescription
calculate_profitnoneFull per-unit cost stack, gross/net margin, and monthly P&L.
list_scenariosPro tokenList your saved scenarios.
get_scenarioPro tokenRead one scenario (inputs + outputs) by id.
save_scenarioPro tokenSave a named scenario from calculator inputs.
update_scenarioPro tokenRename and/or replace a scenario's inputs.
delete_scenarioPro tokenDelete a scenario by id.
copy_scenarioPro tokenDuplicate 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.

FieldNotes
platformamazon (default) or tiktok_shop.
regionus, de, or jp.
modeamazon: fba \fbm. tiktok_shop: fbt \self_fulfilled.
L, W, H, weightDimensions + unit weight.
fob, headShip, dutyUnit cost, inbound freight/unit, import duty/unit.
priceSelling price (gross; VAT-inclusive for DE/JP).
ppcAcos, returnRateAd ACoS and return rate (0–1).
monthlyVolumeUnits/month (scales the P&L).
referralPctReferral fee (0–1). Preferred over referralCategory.
isApparelAffects some fees.
mode-specificFBA: 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

VarRequiredDefaultPurpose
PROFITLEE_API_TOKENNo—Pro token (eck_live_…); needed only for the scenario tools.
PROFITLEE_BASE_URLNohttps://profitlee.comOverride 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

Frequently asked questions

What is io.github.AronLEEdev/profitlee-mcp?

MCP server for the Profitlee ecommerce profit calculator (Amazon FBA/FBM + TikTok Shop).

How do I install io.github.AronLEEdev/profitlee-mcp?

It runs on your machine. In Claude Code: claude mcp add profitlee-mcp -e 'PROFITLEE_API_TOKEN=<your profitlee_api_token>' -e 'PROFITLEE_BASE_URL=<PROFITLEE_BASE_URL>' -- npx -y profitlee-mcp@0.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.AronLEEdev/profitlee-mcp need an API key?

Yes. It expects PROFITLEE_API_TOKEN, which you set in its configuration.

Is io.github.AronLEEdev/profitlee-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.AronLEEdev/profitlee-mcp?

It is published by AronLEEdev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.