Skip to main content
Glama
karrito-mcp

karrito-mcp

by curetcore

karrito-mcp

npm version license CI

MCP server for Karrito — the digital catalog builder for WhatsApp sellers in LATAM.

Connect your AI assistant (Claude, Cursor, Windsurf) to Karrito and manage your entire store — products, orders, discounts, reviews, shipping, analytics — without leaving your editor.

Installation

Quick start (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

Add to your MCP configuration:

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

Related MCP server: ManyContacts MCP Server

Configuration

Variable

Required

Description

KARRITO_API_KEY

For authenticated tools

Your Karrito API key from Settings > API

KARRITO_API_URL

No

Custom API URL (default: https://karrito.shop)

Resources (5)

Static data about Karrito — no authentication required.

Resource

URI

Description

Pricing

karrito://pricing

Plans, prices, and features comparison

Features

karrito://features

Complete feature list (core, pro, upcoming)

Niches

karrito://niches

All 50 available store niches

Competitors

karrito://competitors

19 competitors compared with Karrito advantages

Currencies

karrito://currencies

6 supported LATAM currencies

Tools (30)

Public (no auth required)

Tool

Description

search_catalogs

Search public catalogs by keyword

get_niche_info

Get info about a specific niche

Products (auth required)

Tool

Description

list_my_products

List products in your catalog

create_product

Create a new product

update_product

Update an existing product

delete_product

Delete a product (soft delete)

Categories (auth required)

Tool

Description

list_categories

List categories in your store

create_category

Create a new category

update_category

Update an existing category

delete_category

Delete a category

Orders (auth required)

Tool

Description

list_my_orders

List orders with optional status filter

get_order

Get detailed order info

update_order_status

Change order status (confirm, ship, deliver, cancel)

Store (auth required)

Tool

Description

get_my_store

Get store info (name, slug, currency, stats)

update_store

Update store settings (name, WhatsApp, currency, etc.)

toggle_publish

Quickly publish or unpublish your store

Discounts (auth required)

Tool

Description

list_discounts

List discount codes

create_discount

Create a discount code (percentage or fixed)

update_discount

Update an existing discount

delete_discount

Delete a discount code

Reviews (auth required)

Tool

Description

list_reviews

List reviews with optional status filter

moderate_review

Approve or reject a review

delete_review

Permanently delete a review

Customers (auth required)

Tool

Description

list_customers

List customers who have ordered

get_customer

Get customer detail with order history

Analytics (auth required)

Tool

Description

get_analytics

Store stats: orders, revenue, products, customers, AOV, popular products

Shipping (auth required)

Tool

Description

list_shipping_options

List shipping options

create_shipping_option

Create a shipping option (delivery, pickup, express)

update_shipping_option

Update a shipping option

delete_shipping_option

Delete a shipping option

Usage examples

Browse public catalogs

"Search for bakery catalogs on Karrito"

The assistant will use search_catalogs with query "bakery" to find matching stores.

Explore niches

"What niches does Karrito support for food businesses?"

The assistant will use get_niche_info to search food-related niches.

Manage your catalog

"List all my products and add a new one called 'Chocolate Cake' at $15"

The assistant will use list_my_products and create_product (requires KARRITO_API_KEY).

Manage orders

"Show me all pending orders and confirm the first one"

The assistant will use list_my_orders with status filter and update_order_status.

Create discounts

"Create a 20% discount code VERANO20 that expires on December 31"

The assistant will use create_discount with the provided parameters.

Moderate reviews

"Show me pending reviews and approve the ones with 4+ stars"

The assistant will use list_reviews with status "pending" and moderate_review.

Get analytics

"How is my store performing? Show me the stats"

The assistant will use get_analytics to retrieve store metrics.

Compare platforms

"How does Karrito compare to Shopify and TiendaNube?"

The assistant will read the karrito://competitors resource.

Development

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

License

MIT

Available Tools

30 tools
create_categoryA

Create a new category in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: name (required), position.

create_discountB

Create a new discount code for your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: code (required), type (required), value (required), maxUses, +2 more.

create_productB

Create a new product in your Karrito catalog. Requires KARRITO_API_KEY environment variable.

Inputs: name (required), price (required), imageUrl, categoryId, +1 more.

create_shipping_optionC

Create a new shipping option for your Karrito store (e.g., delivery, pickup, express). Requires KARRITO_API_KEY environment variable.

Inputs: name (required), price (required), isActive, description, +1 more.

delete_categoryA

Delete a category from your Karrito store. Products in this category will become uncategorized. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

delete_discountC

Delete a discount code from your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

delete_productA

Delete a product from your Karrito catalog (soft delete). Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

delete_reviewA

Permanently delete a product review. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

delete_shipping_optionB

Delete a shipping option from your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

get_analyticsB

Get store analytics: total orders, revenue, products, customers, average order value, and popular products. Requires KARRITO_API_KEY environment variable.

Inputs: no named parameters.

get_customerA

Get detailed information about a specific customer including their order history. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

get_my_storeA

Get information about your Karrito store (name, slug, currency, stats). Requires KARRITO_API_KEY environment variable.

Inputs: no named parameters.

get_niche_infoA

Get information about a specific Karrito niche by slug or name. Returns niche details from the 50 available niches. No authentication required.

Inputs: niche (required).

get_orderA

Get detailed information about a specific order including items, customer info, and status. Requires KARRITO_API_KEY environment variable.

Inputs: id (required).

list_categoriesA

List categories in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset.

list_customersB

List customers who have placed orders in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset.

list_discountsB

List discount codes in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset.

list_my_ordersB

List orders from your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset, status.

list_my_productsB

List products in your Karrito catalog. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset.

list_reviewsA

List product reviews in your Karrito store. Can filter by moderation status. Requires KARRITO_API_KEY environment variable.

Inputs: limit, offset, status.

list_shipping_optionsA

List shipping options configured for your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: no named parameters.

moderate_reviewA

Approve or reject a product review. Approved reviews are visible on the public catalog. Requires KARRITO_API_KEY environment variable.

Inputs: id (required), status (required).

search_catalogsA

Search public Karrito catalogs by keyword. No authentication required.

Inputs: query (required).

toggle_publishA

Quickly publish or unpublish your Karrito store. Shortcut for update_store with isPublished. Requires KARRITO_API_KEY environment variable.

Inputs: published (required).

update_categoryB

Update an existing category in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: id (required), name, isActive, position.

update_discountB

Update an existing discount code in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: id (required), code, type, value, +3 more.

update_order_statusA

Update the status of an order (e.g., confirm, ship, deliver, or cancel). Requires KARRITO_API_KEY environment variable.

Inputs: id (required), status (required).

update_productB

Update an existing product in your Karrito catalog. Requires KARRITO_API_KEY environment variable.

Inputs: id (required), name, price, isActive, +3 more.

update_shipping_optionB

Update an existing shipping option in your Karrito store. Requires KARRITO_API_KEY environment variable.

Inputs: id (required), name, price, isActive, +2 more.

update_storeB

Update your Karrito store settings (name, WhatsApp number, currency, description, etc.). Requires KARRITO_API_KEY environment variable.

Inputs: name, currency, description, isPublished, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 30 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., products, orders, categories, discounts, reviews, customers, shipping options, store settings, analytics, catalogs, niches). There is no overlap; even similar-sounding tools like list_shipping_options and create_shipping_option have clearly different purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (e.g., list_shipping_options, create_product, update_order_status). The naming is predictable and makes it easy for an agent to infer functionality from the name alone.

    Tool Count4/5

    With 30 tools, the server covers a broad e-commerce domain including products, orders, categories, discounts, reviews, customers, analytics, and shipping. While slightly above the typical sweet spot, each tool serves a clear purpose and the count is justified by the scope.

    Completeness4/5

    The tool surface provides comprehensive CRUD and lifecycle management for most resources (products, categories, discounts, shipping options, orders, reviews, customers). Minor gaps exist (no create_order or create_review), but these actions are likely customer-facing and not expected from a store management API. Overall, the set covers the essential administrative operations.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for ManyContacts WhatsApp Business CRM that enables AI agents to manage contacts, send messages, run campaigns, and configure auto-replies through comprehensive CRM operations.
      55
      85 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.
      25 npm
      20
      MIT