karrito-mcp

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"
    }
  }
}

Configuration

| Variable | Required | Description | |----------|----------|-------------| | KARRITO_API_KEY | For authenticated tools | Your Karrito API key from Settings > Integrations | | 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, lifetime, upcoming) | | Niches | karrito://niches | All 50 available store niches | | Competitors | karrito://competitors | 19 competitors compared with Karrito advantages | | Currencies | karrito://currencies | 6 supported currencies (DOP, USD, MXN, COP, ARS, BRL) |

Tools (30)

Public (no auth required)

| Tool | Description | |------|-------------| | search_catalogs | Search published 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 (PENDING, CONFIRMED, COMPLETED, CANCELLED) |

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 |

Order status flow

PENDING → CONFIRMED → COMPLETED
   ↓          ↓
CANCELLED  CANCELLED

• PENDING: New order, not yet confirmed
• CONFIRMED: Order accepted by seller
• COMPLETED: Order delivered/fulfilled (terminal)
• CANCELLED: Order cancelled (terminal)

Usage examples

Browse public catalogs

"Search for bakery catalogs on Karrito"

Manage your catalog

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

Manage orders

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

Create discounts

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

Get analytics

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

Compare platforms

"How does Karrito compare to Shopify and TiendaNube?"

Changelog

v3.0.0 (2026-03-23)

Breaking changes:

• Order status values are now UPPERCASE: PENDING, CONFIRMED, COMPLETED, CANCELLED
• Removed shipped and delivered statuses (use COMPLETED instead)
• create_shipping_option no longer accepts description or estimatedDays (not supported by API)
• update_shipping_option no longer accepts description or estimatedDays

Bug fixes:

• Fixed search_catalogs — was calling non-existent endpoint, now works correctly
• Fixed update_order_status — was sending wrong status enum values
• Fixed list_my_orders status filter — was offering invalid status values
• Fixed get_customer — was returning list instead of individual customer
• Fixed pricing resource — removeBranding was incorrectly marked as Pro (it's Lifetime only)
• Fixed features resource — "Remove branding" moved from Pro to Lifetime section
• Fixed currencies resource — added BRL (Brazilian Real), removed CLP (not supported)
• Fixed auth error message URL — now points to correct page (/admin/settings)
• Fixed order status update URL path (/orders/:id instead of /orders/:id/status)

Improvements:

• Unified version across all files (was 4 different versions)
• Centralized auth error handling via shared auth-guard.ts
• Added lifetime section to features resource
• Added position field to update_shipping_option
• Added comparePrice and isActive to create_product
• Better tool descriptions with valid status values documented

Development

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

License

MIT