Back to Browse

Profitlee MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2
Moderate5.2Moderate Risk

This MCP server for the Profitlee profit calculator is well-structured with proper authentication controls and clean code practices. The server correctly gates Pro API features behind token authentication, validates inputs via Zod schemas, and handles errors gracefully. Minor code quality observations around error handling breadth and logging do not significantly impact the security posture. Supply chain analysis found 5 known vulnerabilities in dependencies (2 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Profitlee Pro API token (eck_live_...). Required only for the scenario tools; calculate_profit works without it.Required

Environment variable: PROFITLEE_API_TOKEN

Override the Profitlee API origin (default https://profitlee.com). For testing.Optional

Environment variable: PROFITLEE_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-aronleedev-profitlee-mcp": {
      "env": {
        "PROFITLEE_BASE_URL": "your-profitlee-base-url-here",
        "PROFITLEE_API_TOKEN": "your-profitlee-api-token-here"
      },
      "args": [
        "-y",
        "profitlee-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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:

{
  "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_TOKENNoPro 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_profitPOST /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

Reviews

No reviews yet

Be the first to review this server!