Karrito

karrito-mcp

Servidor MCP para Karrito — el constructor de catálogos digitales para vendedores de WhatsApp en LATAM.

Conecta tu asistente de IA (Claude, Cursor, Windsurf) a Karrito y gestiona toda tu tienda — productos, pedidos, descuentos, reseñas, envíos, analíticas — sin salir de tu editor.

Instalación

Inicio rápido (npx)

npx karrito-mcp

Claude Code

claude mcp add karrito -- npx karrito-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "karrito": {
      "command": "npx",
      "args": ["karrito-mcp"],
      "env": {
        "KARRITO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

Añade a tu configuración de MCP:

{
  "karrito": {
    "command": "npx",
    "args": ["karrito-mcp"],
    "env": {
      "KARRITO_API_KEY": "your-api-key-here"
    }
  }
}

Configuración

Variable	Requerido	Descripción
KARRITO_API_KEY	Para herramientas autenticadas	Tu clave de API de Karrito desde Configuración > API
KARRITO_API_URL	No	URL de API personalizada (por defecto: https://karrito.shop)

Recursos (5)

Datos estáticos sobre Karrito — no se requiere autenticación.

Recurso	URI	Descripción
Precios	karrito://pricing	Comparación de planes, precios y características
Características	karrito://features	Lista completa de características (core, pro, próximas)
Nichos	karrito://niches	Los 50 nichos de tienda disponibles
Competidores	karrito://competitors	19 competidores comparados con las ventajas de Karrito
Monedas	karrito://currencies	6 monedas LATAM compatibles

Herramientas (30)

Públicas (sin autenticación requerida)

Herramienta	Descripción
search_catalogs	Buscar catálogos públicos por palabra clave
get_niche_info	Obtener información sobre un nicho específico

Productos (autenticación requerida)

Herramienta	Descripción
list_my_products	Listar productos en tu catálogo
create_product	Crear un nuevo producto
update_product	Actualizar un producto existente
delete_product	Eliminar un producto (eliminación suave)

Categorías (autenticación requerida)

Herramienta	Descripción
list_categories	Listar categorías en tu tienda
create_category	Crear una nueva categoría
update_category	Actualizar una categoría existente
delete_category	Eliminar una categoría

Pedidos (autenticación requerida)

Herramienta	Descripción
list_my_orders	Listar pedidos con filtro de estado opcional
get_order	Obtener información detallada del pedido
update_order_status	Cambiar estado del pedido (confirmar, enviar, entregar, cancelar)

Tienda (autenticación requerida)

Herramienta	Descripción
get_my_store	Obtener información de la tienda (nombre, slug, moneda, estadísticas)
update_store	Actualizar configuración de la tienda (nombre, WhatsApp, moneda, etc.)
toggle_publish	Publicar o despublicar rápidamente tu tienda

Descuentos (autenticación requerida)

Herramienta	Descripción
list_discounts	Listar códigos de descuento
create_discount	Crear un código de descuento (porcentaje o fijo)
update_discount	Actualizar un descuento existente
delete_discount	Eliminar un código de descuento

Reseñas (autenticación requerida)

Herramienta	Descripción
list_reviews	Listar reseñas con filtro de estado opcional
moderate_review	Aprobar o rechazar una reseña
delete_review	Eliminar permanentemente una reseña

Clientes (autenticación requerida)

Herramienta	Descripción
list_customers	Listar clientes que han realizado pedidos
get_customer	Obtener detalle del cliente con historial de pedidos

Analíticas (autenticación requerida)

Herramienta	Descripción
get_analytics	Estadísticas de la tienda: pedidos, ingresos, productos, clientes, AOV, productos populares

Envíos (autenticación requerida)

Herramienta	Descripción
list_shipping_options	Listar opciones de envío
create_shipping_option	Crear una opción de envío (entrega, recogida, express)
update_shipping_option	Actualizar una opción de envío
delete_shipping_option	Eliminar una opción de envío

Ejemplos de uso

Explorar catálogos públicos

"Busca catálogos de panadería en Karrito"

El asistente usará search_catalogs con la consulta "bakery" para encontrar tiendas coincidentes.

Explorar nichos

"¿Qué nichos soporta Karrito para negocios de comida?"

El asistente usará get_niche_info para buscar nichos relacionados con comida.

Gestiona tu catálogo

"Lista todos mis productos y añade uno nuevo llamado 'Chocolate Cake' a $15"

El asistente usará list_my_products y create_product (requiere KARRITO_API_KEY).

Gestionar pedidos

"Muéstrame todos los pedidos pendientes y confirma el primero"

El asistente usará list_my_orders con filtro de estado y update_order_status.

Crear descuentos

"Crea un código de descuento del 20% VERANO20 que expire el 31 de diciembre"

El asistente usará create_discount con los parámetros proporcionados.

Moderar reseñas

"Muéstrame reseñas pendientes y aprueba las de 4+ estrellas"

El asistente usará list_reviews con estado "pending" y moderate_review.

Obtener analíticas

"¿Cómo está funcionando mi tienda? Muéstrame las estadísticas"

El asistente usará get_analytics para obtener las métricas de la tienda.

Comparar plataformas

"¿Cómo se compara Karrito con Shopify y TiendaNube?"

El asistente leerá el recurso karrito://competitors.

Desarrollo

git clone https://github.com/curetcore/karrito-mcp
cd karrito-mcp
npm install
npm run dev

Licencia

MIT