Profitlee Mcp

io.github.AronLEEdevPublished by GitHub account AronLEEdevv0.2.1Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant compute Amazon FBA/FBM and TikTok Shop profit margins and manage saved Profitlee scenarios.

What you can do
Calculate per-unit cost stacks, gross/net margins and monthly P&L for Amazon or TikTok Shop products across US, DE and JP regions, with FBA, FBM, TikTok FBT or self-fulfilled modes and fee, ad, return and volume inputs. List and read saved scenarios by id. Save, rename, update, duplicate and delete scenarios. Results come from Profitlee's live API rather than reimplemented fee logic.
When to use it
Useful when evaluating ecommerce product profitability or comparing fulfillment modes and regions, and when you want an assistant to keep and revisit named calculation scenarios in a Profitlee account.
Requirements
Runs locally via npx, requiring Node.js 20 or later and network access to the Profitlee API. The PROFITLEE_API_TOKEN environment variable (a Profitlee Pro token) is optional and only needed for the scenario tools; calculate_profit works without it. PROFITLEE_BASE_URL can override the API origin for testing.
Before you install
The scenario tools need a Profitlee Pro API token passed as PROFITLEE_API_TOKEN, which grants access to your saved scenarios. Save, update, copy and delete tools change or remove data in your Profitlee account. Calculation inputs are sent to Profitlee's API, and results depend on its current fee tables.

Installation

In SourceWeft

  1. Open Profitlee Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit 58b5fb3

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts