English Français العربية

io.github.AronLEEdev/profitlee-mcp

Registre officiel E-commerce

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.AronLEEdev/profitlee-mcp ?

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

Comment installer io.github.AronLEEdev/profitlee-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.AronLEEdev/profitlee-mcp ?

Oui. Il attend PROFITLEE_API_TOKEN, à renseigner dans sa configuration.

io.github.AronLEEdev/profitlee-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.AronLEEdev/profitlee-mcp ?

Il est publié par AronLEEdev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.