English Français العربية

io.github.AronLEEdev/profitlee-mcp

السجل الرسمي التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • PROFITLEE_API_TOKEN سري 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.AronLEEdev/profitlee-mcp؟

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

كيف أثبّت io.github.AronLEEdev/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.AronLEEdev/profitlee-mcp إلى مفتاح API؟

نعم. يتطلب PROFITLEE_API_TOKEN، وتضبطها في إعداداته.

هل io.github.AronLEEdev/profitlee-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.AronLEEdev/profitlee-mcp؟

ينشره AronLEEdev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.