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