Profitlee Mcp

by AronLEEdev

298 downloads

Not rated

GitHub

Description

ProfitLee MCP is an MCP server for analyzing ecommerce and marketplace profitability. It helps users calculate net profit, profit margin, ROI, breakeven price, and fee-adjusted outcomes from product cost, selling price, shipping, ads, platform fees, and tax inputs. It also…

About

Details

Author: AronLEEdev
Downloads: 298
Categories: Marketing, Other, Finance

- calculate_profit – free, no authentication needed.
- Full per-unit cost stack with gross/net margin and monthly P&L.
- Supports Amazon (FBA/FBM) and TikTok Shop (FBT/self-fulfilled).
- Regions: US (inches/pounds), DE/JP (cm/kg).
- Scenario CRUD tools (list_scenarios, get_scenario, save_scenario, update_scenario, delete_scenario) – require Pro token.
- All fee logic matches the live Profitlee calculator via its API.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Profitlee Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

From the repository

Add the server to your MCP client configuration using npx -y profitlee-mcp as the command. Optionally set the PROFITLEE_API_TOKEN environment variable to unlock scenario tools. Requires Node.js 20+.

`calculate_profit`

Calculate ecommerce profit for one product on Amazon FBA, Amazon FBM, TikTok Shop FBT, or TikTok Shop self-fulfilled. Returns per-unit fees, landed cost, gross margin, net margin after ads/returns/storage, and monthly P&L. Free to use; no Profitlee API token required.

`list_scenarios`

List saved Profitlee profit scenarios for the authenticated Pro account. Use this before get_scenario, update_scenario, or delete_scenario when you need a scenario id. Requires PROFITLEE_API_TOKEN.

`get_scenario`

Fetch one saved Profitlee scenario by id, including the original calculator inputs and the computed profit output. Requires PROFITLEE_API_TOKEN.

`save_scenario`

Create a saved Profitlee scenario from a scenario name and calculator inputs. Profitlee validates the inputs and computes outputs server-side. Requires PROFITLEE_API_TOKEN.

`update_scenario`

Update an existing Profitlee scenario by id. Pass name to rename it, inputs to replace calculator inputs and recompute outputs, or both. Requires PROFITLEE_API_TOKEN.

`delete_scenario`

Delete one saved Profitlee scenario by id. This permanently removes the saved scenario from the authenticated Pro account. Requires PROFITLEE_API_TOKEN.

`copy_scenario`

Duplicate an existing Profitlee scenario into a new one. Profitlee reads the source inputs server-side and recomputes outputs, so the copy reflects the current fee tables. The new name defaults to "Copy of <source name>" unless you pass name. Counts against the saved-scenario limit. Requires PROFITLEE_API_TOKEN.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "profitlee mcp": {
            "profitlee": {
                "command": "npx",
                "args": [
                    "-y",
                    "profitlee-mcp"
                ],
                "env": {
                    "PROFITLEE_API_TOKEN": "eck_live_xxx"
                }
            }
        }
    }
}

McpServers

{
    "profitlee": {
        "command": "npx",
        "args": [
            "-y",
            "profitlee-mcp"
        ],
        "env": {
            "PROFITLEE_API_TOKEN": "eck_live_xxx"
        }
    }
}

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: ``

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


| Tool | Auth | Description |
| --- | --- | --- |
|

calculate_profit

 | none | Full per-unit cost stack, gross/net margin, and monthly P&L. |
|

list_scenarios

 | Pro token | List your saved scenarios. |
|

get_scenario

 | Pro token | Read one scenario (inputs + outputs) by id. |
|

save_scenario

 | Pro token | Save a named scenario from calculator inputs. |
|

update_scenario

 | Pro token | Rename and/or replace a scenario's inputs. |
|

delete_scenario

 | Pro token | Delete a scenario by id. |

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.

| Field | Notes |
| --- | --- |
|

platform | amazon (default) or tiktok_shop

. |
|

region | us, de, or jp

. |
|

mode | amazon: fba \| fbm. tiktok_shop: fbt \| self_fulfilled

. |
|

L, W, H, weight

 | Dimensions + unit weight. |
|

fob, headShip, duty

 | Unit cost, inbound freight/unit, import duty/unit. |
|

price

 | Selling price (gross; VAT-inclusive for DE/JP). |
|

ppcAcos, returnRate

 | Ad ACoS and return rate (0–1). |
|

monthlyVolume

 | Units/month (scales the P&L). |
|

referralPct | Referral fee (0–1). Preferred over referralCategory

. |
|

isApparel

 | Affects some fees. |
| mode-specific | FBA:

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


| Var | Required | Default | Purpose |
| --- | --- | --- | --- |
|

PROFITLEE_API_TOKEN | No | — | Pro token (eck_live_…

); needed only for the scenario tools. |
|

PROFITLEE_BASE_URL | No | https://profitlee.com

 | Override 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 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

calculate_profit

list_scenarios

get_scenario

save_scenario

update_scenario

delete_scenario

copy_scenario

Claude Desktop / Cursor

McpServers

profitlee-mcp

Quick start

Tools

calculate_profit inputs

Environment variables

How it works

Development

Releasing

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`calculate_profit`

`list_scenarios`

`get_scenario`

`save_scenario`

`update_scenario`

`delete_scenario`

`copy_scenario`

calculate_profit`inputs`