Profitlee-MCP

ProfitLee MCP es un servidor MCP para analizar la rentabilidad de comercio electrónico y marketplaces. Ayuda a los usuarios a calcular el beneficio neto, el margen de beneficio, el ROI, el precio de equilibrio y los resultados ajustados por tarifas a partir del costo del producto, precio de venta, envío, anuncios, tarifas de plataforma e impuestos. También admite escenarios de beneficio reutilizables para que los usuarios puedan comparar precios y supuestos de costos más fácilmente.

GitHubPrueba este MCPPatrocinado

Documentación

profitlee-mcp

Un servidor MCP para Profitlee — calcula márgenes de beneficio precisos por país para Amazon FBA/FBM y TikTok Shop, y gestiona escenarios guardados, desde cualquier cliente MCP (Claude Desktop, Claude Code, Cursor, …).

calculate_profit es gratuito y no requiere token. Las herramientas de escenarios requieren un token de API de Profitlee Pro.

Nombre de registro MCP: io.github.AronLEEdev/profitlee-mcp

Inicio rápido

Añade a la configuración de tu cliente MCP:

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

PROFITLEE_API_TOKEN es opcional — omite todo el bloque env para usar solo calculate_profit. Crea un token en tu página de cuenta de Profitlee para desbloquear las herramientas de escenarios.

Requiere Node.js 20+.

Herramientas

Herramienta	Autenticación	Descripción
`calculate_profit`	Ninguna	Desglose completo del coste por unidad, margen bruto/neto y P&L mensual.
`list_scenarios`	Token Pro	Lista tus escenarios guardados.
`get_scenario`	Token Pro	Lee un escenario (entradas + salidas) por id.
`save_scenario`	Token Pro	Guarda un escenario con nombre a partir de entradas de calculadora.
`update_scenario`	Token Pro	Renombra y/o reemplaza las entradas de un escenario.
`delete_scenario`	Token Pro	Elimina un escenario por id.
`copy_scenario`	Token Pro	Duplica un escenario en uno nuevo ("Copia de …").

Entradas de `calculate_profit`

Elige un platform + mode, proporciona los detalles físicos y de coste del producto, y Profitlee integra todas las tarifas en un único margen neto. Las tasas son decimales de 0–1 (ej. 0.15 = 15%). EE. UU. usa pulgadas + libras; DE/JP usan cm + kg.

Campo	Notas
`platform`	`amazon` (por defecto) o `tiktok_shop`.
`region`	`us`, `de`, o `jp`.
`mode`	amazon: `fba` \| `fbm`. tiktok_shop: `fbt` \| `self_fulfilled`.
`L`, `W`, `H`, `weight`	Dimensiones + peso unitario.
`fob`, `headShip`, `duty`	Coste unitario, flete de entrada por unidad, arancel de importación por unidad.
`price`	Precio de venta (bruto; incluye IVA para DE/JP).
`ppcAcos`, `returnRate`	ACoS de anuncios y tasa de devolución (0–1).
`monthlyVolume`	Unidades por mes (escala el P&L).
`referralPct`	Tarifa de referencia (0–1). Preferida sobre `referralCategory`.
`isApparel`	Afecta algunas tarifas.
específico del modo	FBA: `inboundOption`, `storageMonths`, `storageSeason`. FBM / TikTok autogestionado: `outboundShipPerUnit`, `pickPackPerUnit`, `monthly3plStorage`. TikTok FBT: `storageMonthsPastFree`.

La API de Profitlee es la fuente de verdad para la validación — las entradas incompletas o fuera de rango devuelven un error claro que lista los campos problemáticos. Referencia completa de campos: https://profitlee.com/docs/api.

Variables de entorno

Variable	Requerida	Predeterminado	Propósito
`PROFITLEE_API_TOKEN`	No	—	Token Pro (`eck_live_…`); solo necesario para las herramientas de escenarios.
`PROFITLEE_BASE_URL`	No	`https://profitlee.com`	Sobrescribir el origen de la API (pruebas).

Cómo funciona

El servidor es una capa delgada sobre la API HTTP pública de Profitlee:

calculate_profit → POST /api/v1/calculate (pública, sin token).
herramientas de escenarios → /api/v1/scenarios* (requieren el token Pro; el servidor falla rápido con un mensaje claro si falta).

No se reimplementa ninguna lógica de tarifas aquí, por lo que los resultados siempre coinciden con la calculadora en vivo de Profitlee y las tablas de tarifas vigentes.

Desarrollo

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

Publicación

Mantenimiento: consulta PUBLISHING.md para los pasos de publicación en npm y registro MCP. El manifiesto de registro está en server.json.

Licencia

MIT