Profitlee Mcp

io.github.AronLEEdev由 GitHub 帳號 AronLEEdev 發布v0.2.1更新於 Oct 25, 2026

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

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理計算 Amazon FBA/FBM 與 TikTok Shop 的利潤空間，並管理已儲存的 Profitlee 情境。

可以做什麼
計算 Amazon 或 TikTok Shop 商品在美、德、日區域的單件成本結構、毛利／淨利率與每月損益，支援 FBA、FBM、TikTok FBT 或自行出貨模式，以及費用、廣告、退貨與銷量等輸入。列出並依 id 讀取已儲存的情境。儲存、重新命名、更新、複製與刪除情境。結果來自 Profitlee 即時 API，而非在本機重新實作的費用邏輯。
適用情境
適合評估電商產品獲利能力、比較不同出貨模式與區域時使用，也適合讓助理在 Profitlee 帳戶中儲存並反覆查看具名的計算情境。
執行需求
透過 npx 在本機執行，需要 Node.js 20 以上版本，並能連線至 Profitlee API。環境變數 PROFITLEE_API_TOKEN（Profitlee Pro 權杖）為選用，僅情境相關工具需要；calculate_profit 不需權杖。可用 PROFITLEE_BASE_URL 覆寫 API 位址以便測試。
安裝前請注意
情境工具需要以 PROFITLEE_API_TOKEN 傳入 Profitlee Pro API 權杖，該權杖可存取你儲存的情境。儲存、更新、複製與刪除工具會變更或移除你 Profitlee 帳戶中的資料。計算輸入會傳送至 Profitlee 的 API，結果取決於其目前費率表。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Profitlee Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

profitlee-mcp

[npm version] [license] [smithery badge] [Glama MCP Server]

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:

json
{  "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

bash
npm installnpm 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

來源：README.md，提交 58b5fb3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分