Profitlee-MCP

ProfitLee MCP é um servidor MCP para analisar a rentabilidade de e-commerce e marketplaces. Ele ajuda os usuários a calcular lucro líquido, margem de lucro, ROI, preço de equilíbrio e resultados ajustados por taxas a partir de custo do produto, preço de venda, frete, anúncios, taxas da plataforma e impostos. Também suporta cenários de lucro reutilizáveis para que os usuários possam comparar preços e premissas de custo com mais facilidade.

GitHubExperimente este MCPPatrocinado

Documentação

profitlee-mcp

Um servidor MCP para Profitlee — calcule margens de lucro precisas por país para Amazon FBA/FBM e TikTok Shop, e gerencie cenários salvos, a partir de qualquer cliente MCP (Claude Desktop, Claude Code, Cursor, …).

O calculate_profit é gratuito e não requer token. As ferramentas de cenário exigem um token da API Profitlee Pro.

Nome no registro MCP: io.github.AronLEEdev/profitlee-mcp

Início rápido

Adicione à configuração do seu cliente MCP:

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

O PROFITLEE_API_TOKEN é opcional — omita todo o bloco env para usar apenas o calculate_profit. Crie um token na sua página de conta do Profitlee para desbloquear as ferramentas de cenário.

Requer Node.js 20+.

Ferramentas

Ferramenta	Autenticação	Descrição
`calculate_profit`	nenhuma	Pilha completa de custos por unidade, margem bruta/líquida e P&L mensal.
`list_scenarios`	Token Pro	Liste seus cenários salvos.
`get_scenario`	Token Pro	Leia um cenário (entradas + saídas) por id.
`save_scenario`	Token Pro	Salve um cenário nomeado a partir das entradas da calculadora.
`update_scenario`	Token Pro	Renomeie e/ou substitua as entradas de um cenário.
`delete_scenario`	Token Pro	Exclua um cenário por id.
`copy_scenario`	Token Pro	Duplique um cenário em um novo ("Cópia de …").

Entradas do `calculate_profit`

Escolha um platform + mode, forneça os detalhes físicos e de custo do produto, e o Profitlee incorpora todas as taxas em uma única margem líquida. As taxas são decimais de 0–1 (ex.: 0.15 = 15%). Os EUA usam polegadas + libras; DE/JP usam cm + kg.

Campo	Observações
`platform`	`amazon` (padrão) ou `tiktok_shop`.
`region`	`us`, `de` ou `jp`.
`mode`	amazon: `fba` \| `fbm`. tiktok_shop: `fbt` \| `self_fulfilled`.
`L`, `W`, `H`, `weight`	Dimensões + peso unitário.
`fob`, `headShip`, `duty`	Custo unitário, frete de entrada/unidade, imposto de importação/unidade.
`price`	Preço de venda (bruto; inclui IVA para DE/JP).
`ppcAcos`, `returnRate`	ACoS de anúncios e taxa de devolução (0–1).
`monthlyVolume`	Unidades/mês (dimensiona o P&L).
`referralPct`	Taxa de referência (0–1). Preferida em relação a `referralCategory`.
`isApparel`	Afeta algumas taxas.
específico do modo	FBA: `inboundOption`, `storageMonths`, `storageSeason`. FBM / TikTok autoatendido: `outboundShipPerUnit`, `pickPackPerUnit`, `monthly3plStorage`. TikTok FBT: `storageMonthsPastFree`.

A API do Profitlee é a fonte da verdade para validação — entradas incompletas ou fora do intervalo retornam um erro claro listando os campos problemáticos. Referência completa dos campos: https://profitlee.com/docs/api.

Variáveis de ambiente

Variável	Obrigatória	Padrão	Finalidade
`PROFITLEE_API_TOKEN`	Não	—	Token Pro (`eck_live_…`); necessário apenas para as ferramentas de cenário.
`PROFITLEE_BASE_URL`	Não	`https://profitlee.com`	Substitui a origem da API (testes).

Como funciona

O servidor é um wrapper leve sobre a API HTTP pública do Profitlee:

calculate_profit → POST /api/v1/calculate (público, sem token).
ferramentas de cenário → /api/v1/scenarios* (exigem o token Pro; o servidor falha rapidamente com uma mensagem clara se ele estiver ausente).

Nenhuma lógica de taxas é reimplementada aqui, então os resultados sempre correspondem à calculadora ao vivo do Profitlee e às tabelas de taxas atuais.

Desenvolvimento

npm install
npm test       # vitest (27 tests)
npm run build  # tsc -> dist/
npm run dev    # run from source with tsx

Publicação

Mantenedores: consulte PUBLISHING.md para etapas de publicação npm + registro MCP. O manifesto do registro está em server.json.

Licença

MIT