karrito-mcp 1.1.0 → 2.0.1

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for [Karrito](https://karrito.shop) — the digital catalog builder for WhatsApp sellers in LATAM.
 
-Connect your AI assistant (Claude, Cursor, Windsurf) to Karrito and manage your catalog, search public stores, and get platform information without leaving your editor.
+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
 
@@ -69,15 +69,87 @@ Static data about Karrito — no authentication required.
 | Competitors | `karrito://competitors` | 19 competitors compared with Karrito advantages |
 | Currencies | `karrito://currencies` | 6 supported LATAM currencies |
 
-## Tools (5)
+## Tools (30)
 
-| Tool | Auth | Description |
-|------|------|-------------|
-| `search_catalogs` | No | Search public catalogs by keyword |
-| `get_niche_info` | No | Get info about a specific niche |
-| `list_my_products` | Yes | List products in your catalog |
-| `create_product` | Yes | Create a new product |
-| `list_my_orders` | Yes | List orders from your store |
+### 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
 
@@ -99,6 +171,30 @@ The assistant will use `get_niche_info` to search food-related niches.
 
 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?"

package/dist/index.js

@@ -14,9 +14,14 @@ import { register as registerProductTools } from './tools/products.js';
 import { register as registerOrderTools } from './tools/orders.js';
 import { register as registerCategoryTools } from './tools/categories.js';
 import { register as registerStoreTools } from './tools/store.js';
+import { register as registerDiscountTools } from './tools/discounts.js';
+import { register as registerReviewTools } from './tools/reviews.js';
+import { register as registerCustomerTools } from './tools/customers.js';
+import { register as registerStatsTools } from './tools/stats.js';
+import { register as registerShippingTools } from './tools/shipping.js';
 const server = new McpServer({
     name: 'karrito',
-    version: '1.1.0',
+    version: '2.0.0',
 });
 const client = new KarritoApiClient();
 // Register static resources (public, no auth needed)
@@ -31,13 +36,38 @@ registerProductTools(server, client);
 registerOrderTools(server, client);
 registerCategoryTools(server, client);
 registerStoreTools(server, client);
+registerDiscountTools(server, client);
+registerReviewTools(server, client);
+registerCustomerTools(server, client);
+registerStatsTools(server, client);
+registerShippingTools(server, client);
 // Connect via stdio
 async function main() {
+    const hasKey = !!process.env.KARRITO_API_KEY;
+    const maskedKey = hasKey
+        ? `${process.env.KARRITO_API_KEY.slice(0, 8)}${'*'.repeat(12)}${process.env.KARRITO_API_KEY.slice(-4)}`
+        : 'not set';
+    console.error('');
+    console.error('  ╔═══════════════════════════════════════════════╗');
+    console.error('  ║                                               ║');
+    console.error('  ║   🛒  Karrito MCP Server  v2.0.0              ║');
+    console.error('  ║                                               ║');
+    console.error('  ║   30 tools  •  5 resources                    ║');
+    console.error('  ║   Manage your entire store from AI            ║');
+    console.error('  ║                                               ║');
+    console.error('  ╠═══════════════════════════════════════════════╣');
+    console.error(`  ║   API Key:  ${maskedKey.padEnd(34)}║`);
+    console.error(`  ║   Status:   ${hasKey ? '● Connected' : '○ Public only (set KARRITO_API_KEY)'}${hasKey ? '                       ' : ''}║`);
+    console.error('  ║                                               ║');
+    console.error('  ║   Docs:     docs.karrito.shop                 ║');
+    console.error('  ║   npm:      npmjs.com/package/karrito-mcp     ║');
+    console.error('  ║                                               ║');
+    console.error('  ╚═══════════════════════════════════════════════╝');
+    console.error('');
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('Karrito MCP Server running on stdio');
 }
 main().catch((error) => {
-    console.error('Fatal error:', error);
+    console.error('  ✕ Fatal error:', error);
     process.exit(1);
 });

package/dist/lib/api-client.d.ts

@@ -16,12 +16,30 @@ export declare class KarritoApiClient {
     listProducts(limit?: number, offset?: number): Promise<unknown>;
     getProduct(id: string): Promise<unknown>;
     createProduct(data: Record<string, unknown>): Promise<unknown>;
-    listCategories(limit?: number, offset?: number): Promise<unknown>;
-    listOrders(limit?: number, offset?: number, status?: string): Promise<unknown>;
-    getOrder(id: string): Promise<unknown>;
     updateProduct(id: string, data: Record<string, unknown>): Promise<unknown>;
     deleteProduct(id: string): Promise<unknown>;
+    listCategories(limit?: number, offset?: number): Promise<unknown>;
     createCategory(data: Record<string, unknown>): Promise<unknown>;
+    updateCategory(id: string, data: Record<string, unknown>): Promise<unknown>;
+    deleteCategory(id: string): Promise<unknown>;
+    listOrders(limit?: number, offset?: number, status?: string): Promise<unknown>;
+    getOrder(id: string): Promise<unknown>;
+    updateOrderStatus(id: string, status: string): Promise<unknown>;
     getStore(): Promise<unknown>;
+    updateStore(data: Record<string, unknown>): Promise<unknown>;
+    listDiscounts(limit?: number, offset?: number): Promise<unknown>;
+    createDiscount(data: Record<string, unknown>): Promise<unknown>;
+    updateDiscount(id: string, data: Record<string, unknown>): Promise<unknown>;
+    deleteDiscount(id: string): Promise<unknown>;
+    listReviews(limit?: number, offset?: number, status?: string): Promise<unknown>;
+    moderateReview(id: string, status: string): Promise<unknown>;
+    deleteReview(id: string): Promise<unknown>;
+    listCustomers(limit?: number, offset?: number): Promise<unknown>;
+    getCustomer(id: string): Promise<unknown>;
+    getStats(): Promise<unknown>;
+    listShipping(): Promise<unknown>;
+    createShipping(data: Record<string, unknown>): Promise<unknown>;
+    updateShipping(id: string, data: Record<string, unknown>): Promise<unknown>;
+    deleteShipping(id: string): Promise<unknown>;
 }
 export {};

package/dist/lib/api-client.js

@@ -14,7 +14,7 @@ export class KarritoApiClient {
     async request(path, options = {}) {
         const headers = {
             'Content-Type': 'application/json',
-            'User-Agent': 'karrito-mcp/1.1.0',
+            'User-Agent': 'karrito-mcp/2.0.0',
         };
         if (this.apiKey) {
             headers['Authorization'] = `Bearer ${this.apiKey}`;
@@ -47,7 +47,7 @@ export class KarritoApiClient {
     async checkSlug(slug) {
         return this.request(`/api/check-slug?slug=${encodeURIComponent(slug)}`);
     }
-    // --- Authenticated endpoints ---
+    // --- Products ---
     async listProducts(limit = 50, offset = 0) {
         return this.request(`/api/v1/products?limit=${limit}&offset=${offset}`);
     }
@@ -60,9 +60,39 @@ export class KarritoApiClient {
             body: JSON.stringify(data),
         });
     }
+    async updateProduct(id, data) {
+        return this.request(`/api/v1/products/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteProduct(id) {
+        return this.request(`/api/v1/products/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // --- Categories ---
     async listCategories(limit = 50, offset = 0) {
         return this.request(`/api/v1/categories?limit=${limit}&offset=${offset}`);
     }
+    async createCategory(data) {
+        return this.request('/api/v1/categories', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateCategory(id, data) {
+        return this.request(`/api/v1/categories/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteCategory(id) {
+        return this.request(`/api/v1/categories/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // --- Orders ---
     async listOrders(limit = 50, offset = 0, status) {
         const statusParam = status ? `&status=${status}` : '';
         return this.request(`/api/v1/orders?limit=${limit}&offset=${offset}${statusParam}`);
@@ -70,24 +100,89 @@ export class KarritoApiClient {
     async getOrder(id) {
         return this.request(`/api/v1/orders/${id}`);
     }
-    async updateProduct(id, data) {
-        return this.request(`/api/v1/products/${id}`, {
+    async updateOrderStatus(id, status) {
+        return this.request(`/api/v1/orders/${id}/status`, {
+            method: 'PUT',
+            body: JSON.stringify({ status }),
+        });
+    }
+    // --- Store ---
+    async getStore() {
+        return this.request('/api/v1/store');
+    }
+    async updateStore(data) {
+        return this.request('/api/v1/store', {
             method: 'PUT',
             body: JSON.stringify(data),
         });
     }
-    async deleteProduct(id) {
-        return this.request(`/api/v1/products/${id}`, {
+    // --- Discounts ---
+    async listDiscounts(limit = 50, offset = 0) {
+        return this.request(`/api/v1/discounts?limit=${limit}&offset=${offset}`);
+    }
+    async createDiscount(data) {
+        return this.request('/api/v1/discounts', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateDiscount(id, data) {
+        return this.request(`/api/v1/discounts/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteDiscount(id) {
+        return this.request(`/api/v1/discounts/${id}`, {
             method: 'DELETE',
         });
     }
-    async createCategory(data) {
-        return this.request('/api/v1/categories', {
+    // --- Reviews ---
+    async listReviews(limit = 50, offset = 0, status) {
+        const statusParam = status ? `&status=${status}` : '';
+        return this.request(`/api/v1/reviews?limit=${limit}&offset=${offset}${statusParam}`);
+    }
+    async moderateReview(id, status) {
+        return this.request(`/api/v1/reviews/${id}/moderate`, {
+            method: 'PUT',
+            body: JSON.stringify({ status }),
+        });
+    }
+    async deleteReview(id) {
+        return this.request(`/api/v1/reviews/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // --- Customers ---
+    async listCustomers(limit = 50, offset = 0) {
+        return this.request(`/api/v1/customers?limit=${limit}&offset=${offset}`);
+    }
+    async getCustomer(id) {
+        return this.request(`/api/v1/customers/${id}`);
+    }
+    // --- Stats ---
+    async getStats() {
+        return this.request('/api/v1/stats');
+    }
+    // --- Shipping ---
+    async listShipping() {
+        return this.request('/api/v1/shipping');
+    }
+    async createShipping(data) {
+        return this.request('/api/v1/shipping', {
             method: 'POST',
             body: JSON.stringify(data),
         });
     }
-    async getStore() {
-        return this.request('/api/v1/store');
+    async updateShipping(id, data) {
+        return this.request(`/api/v1/shipping/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteShipping(id) {
+        return this.request(`/api/v1/shipping/${id}`, {
+            method: 'DELETE',
+        });
     }
 }

package/dist/tools/categories.js

@@ -73,4 +73,86 @@ export function register(server, client) {
             };
         }
     });
+    // --- update_category (auth required) ---
+    server.tool('update_category', 'Update an existing category in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Category ID to update'),
+        name: z.string().min(1).max(100).optional().describe('New category name'),
+        position: z.number().int().min(0).optional().describe('New sort order (lower = first)'),
+        isActive: z.boolean().optional().describe('Whether the category is active'),
+    }, async ({ id, ...updates }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const updateData = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (value !== undefined)
+                    updateData[key] = value;
+            }
+            if (Object.keys(updateData).length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No fields to update. Provide at least one field (name, position, isActive).' }],
+                    isError: true,
+                };
+            }
+            const data = await client.updateCategory(id, updateData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error updating category: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- delete_category (auth required) ---
+    server.tool('delete_category', 'Delete a category from your Karrito store. Products in this category will become uncategorized. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Category ID to delete'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const data = await client.deleteCategory(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error deleting category: ${message}` }],
+                isError: true,
+            };
+        }
+    });
 }

package/dist/tools/customers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KarritoApiClient } from '../lib/api-client.js';
+export declare function register(server: McpServer, client: KarritoApiClient): void;

package/dist/tools/customers.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+function authError() {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+            },
+        ],
+        isError: true,
+    };
+}
+export function register(server, client) {
+    // --- list_customers (auth required) ---
+    server.tool('list_customers', 'List customers who have placed orders in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        limit: z.number().min(1).max(100).default(50).describe('Max customers to return (1-100)'),
+        offset: z.number().min(0).default(0).describe('Pagination offset'),
+    }, async ({ limit, offset }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.listCustomers(limit, offset);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error listing customers: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- get_customer (auth required) ---
+    server.tool('get_customer', 'Get detailed information about a specific customer including their order history. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Customer ID to retrieve'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.getCustomer(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error getting customer: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/discounts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KarritoApiClient } from '../lib/api-client.js';
+export declare function register(server: McpServer, client: KarritoApiClient): void;

package/dist/tools/discounts.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+function authError() {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+            },
+        ],
+        isError: true,
+    };
+}
+export function register(server, client) {
+    // --- list_discounts (auth required) ---
+    server.tool('list_discounts', 'List discount codes in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        limit: z.number().min(1).max(100).default(50).describe('Max discounts to return (1-100)'),
+        offset: z.number().min(0).default(0).describe('Pagination offset'),
+    }, async ({ limit, offset }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.listDiscounts(limit, offset);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error listing discounts: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- create_discount (auth required) ---
+    server.tool('create_discount', 'Create a new discount code for your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        code: z.string().min(1).max(50).describe('Discount code (e.g., VERANO20)'),
+        type: z.enum(['percentage', 'fixed']).describe('Discount type: percentage (e.g., 20%) or fixed amount (e.g., $5 off)'),
+        value: z.number().min(0).describe('Discount value (percentage 0-100 or fixed amount in store currency)'),
+        minOrderAmount: z.number().min(0).optional().describe('Minimum order amount required to use this discount'),
+        maxUses: z.number().int().min(1).optional().describe('Maximum number of times this discount can be used'),
+        expiresAt: z.string().optional().describe('Expiration date in ISO 8601 format (e.g., 2026-12-31T23:59:59Z)'),
+    }, async ({ code, type, value, minOrderAmount, maxUses, expiresAt }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const discountData = { code, type, value };
+            if (minOrderAmount !== undefined)
+                discountData.minOrderAmount = minOrderAmount;
+            if (maxUses !== undefined)
+                discountData.maxUses = maxUses;
+            if (expiresAt !== undefined)
+                discountData.expiresAt = expiresAt;
+            const data = await client.createDiscount(discountData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error creating discount: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- update_discount (auth required) ---
+    server.tool('update_discount', 'Update an existing discount code in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Discount ID to update'),
+        code: z.string().min(1).max(50).optional().describe('New discount code'),
+        type: z.enum(['percentage', 'fixed']).optional().describe('New discount type'),
+        value: z.number().min(0).optional().describe('New discount value'),
+        minOrderAmount: z.number().min(0).optional().describe('New minimum order amount'),
+        maxUses: z.number().int().min(1).optional().describe('New maximum uses'),
+        expiresAt: z.string().optional().describe('New expiration date in ISO 8601 format'),
+    }, async ({ id, ...updates }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const updateData = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (value !== undefined)
+                    updateData[key] = value;
+            }
+            if (Object.keys(updateData).length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No fields to update. Provide at least one field (code, type, value, minOrderAmount, maxUses, expiresAt).' }],
+                    isError: true,
+                };
+            }
+            const data = await client.updateDiscount(id, updateData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error updating discount: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- delete_discount (auth required) ---
+    server.tool('delete_discount', 'Delete a discount code from your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Discount ID to delete'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.deleteDiscount(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error deleting discount: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/orders.js

@@ -5,7 +5,7 @@ export function register(server, client) {
         limit: z.number().min(1).max(100).default(50).describe('Max orders to return (1-100)'),
         offset: z.number().min(0).default(0).describe('Pagination offset'),
         status: z
-            .enum(['pending', 'confirmed', 'delivered', 'cancelled'])
+            .enum(['pending', 'confirmed', 'shipped', 'delivered', 'cancelled'])
             .optional()
             .describe('Filter by order status'),
     }, async ({ limit, offset, status }) => {
@@ -39,4 +39,75 @@ export function register(server, client) {
             };
         }
     });
+    // --- get_order (auth required) ---
+    server.tool('get_order', 'Get detailed information about a specific order including items, customer info, and status. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Order ID to retrieve'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const data = await client.getOrder(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error getting order: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- update_order_status (auth required) ---
+    server.tool('update_order_status', 'Update the status of an order (e.g., confirm, ship, deliver, or cancel). Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Order ID to update'),
+        status: z
+            .enum(['pending', 'confirmed', 'shipped', 'delivered', 'cancelled'])
+            .describe('New order status'),
+    }, async ({ id, status }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const data = await client.updateOrderStatus(id, status);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error updating order status: ${message}` }],
+                isError: true,
+            };
+        }
+    });
 }

package/dist/tools/reviews.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KarritoApiClient } from '../lib/api-client.js';
+export declare function register(server: McpServer, client: KarritoApiClient): void;

package/dist/tools/reviews.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+function authError() {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+            },
+        ],
+        isError: true,
+    };
+}
+export function register(server, client) {
+    // --- list_reviews (auth required) ---
+    server.tool('list_reviews', 'List product reviews in your Karrito store. Can filter by moderation status. Requires KARRITO_API_KEY environment variable.', {
+        limit: z.number().min(1).max(100).default(20).describe('Max reviews to return (1-100)'),
+        offset: z.number().min(0).default(0).describe('Pagination offset'),
+        status: z
+            .enum(['pending', 'approved', 'rejected'])
+            .optional()
+            .describe('Filter by moderation status'),
+    }, async ({ limit, offset, status }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.listReviews(limit, offset, status);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error listing reviews: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- moderate_review (auth required) ---
+    server.tool('moderate_review', 'Approve or reject a product review. Approved reviews are visible on the public catalog. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Review ID to moderate'),
+        status: z.enum(['approved', 'rejected']).describe('Moderation decision: approved (visible) or rejected (hidden)'),
+    }, async ({ id, status }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.moderateReview(id, status);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error moderating review: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- delete_review (auth required) ---
+    server.tool('delete_review', 'Permanently delete a product review. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Review ID to delete'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.deleteReview(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error deleting review: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/shipping.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KarritoApiClient } from '../lib/api-client.js';
+export declare function register(server: McpServer, client: KarritoApiClient): void;

package/dist/tools/shipping.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+function authError() {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+            },
+        ],
+        isError: true,
+    };
+}
+export function register(server, client) {
+    // --- list_shipping_options (auth required) ---
+    server.tool('list_shipping_options', 'List shipping options configured for your Karrito store. Requires KARRITO_API_KEY environment variable.', {}, async () => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.listShipping();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error listing shipping options: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- create_shipping_option (auth required) ---
+    server.tool('create_shipping_option', 'Create a new shipping option for your Karrito store (e.g., delivery, pickup, express). Requires KARRITO_API_KEY environment variable.', {
+        name: z.string().min(1).max(100).describe('Shipping option name (e.g., "Delivery", "Pickup in store", "Express")'),
+        price: z.number().min(0).describe('Shipping price in store currency (0 for free shipping)'),
+        description: z.string().max(500).optional().describe('Description of this shipping option'),
+        estimatedDays: z.number().int().min(0).optional().describe('Estimated delivery time in days'),
+        isActive: z.boolean().optional().describe('Whether this shipping option is active (default: true)'),
+    }, async ({ name, price, description, estimatedDays, isActive }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const shippingData = { name, price };
+            if (description !== undefined)
+                shippingData.description = description;
+            if (estimatedDays !== undefined)
+                shippingData.estimatedDays = estimatedDays;
+            if (isActive !== undefined)
+                shippingData.isActive = isActive;
+            const data = await client.createShipping(shippingData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error creating shipping option: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- update_shipping_option (auth required) ---
+    server.tool('update_shipping_option', 'Update an existing shipping option in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Shipping option ID to update'),
+        name: z.string().min(1).max(100).optional().describe('New shipping option name'),
+        price: z.number().min(0).optional().describe('New shipping price'),
+        description: z.string().max(500).optional().describe('New description'),
+        estimatedDays: z.number().int().min(0).optional().describe('New estimated delivery time in days'),
+        isActive: z.boolean().optional().describe('Whether this shipping option is active'),
+    }, async ({ id, ...updates }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const updateData = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (value !== undefined)
+                    updateData[key] = value;
+            }
+            if (Object.keys(updateData).length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No fields to update. Provide at least one field (name, price, description, estimatedDays, isActive).' }],
+                    isError: true,
+                };
+            }
+            const data = await client.updateShipping(id, updateData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error updating shipping option: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- delete_shipping_option (auth required) ---
+    server.tool('delete_shipping_option', 'Delete a shipping option from your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Shipping option ID to delete'),
+    }, async ({ id }) => {
+        if (!client.hasApiKey)
+            return authError();
+        try {
+            const data = await client.deleteShipping(id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error deleting shipping option: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/stats.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KarritoApiClient } from '../lib/api-client.js';
+export declare function register(server: McpServer, client: KarritoApiClient): void;

package/dist/tools/stats.js

@@ -0,0 +1,34 @@
+export function register(server, client) {
+    // --- get_analytics (auth required) ---
+    server.tool('get_analytics', 'Get store analytics: total orders, revenue, products, customers, average order value, and popular products. Requires KARRITO_API_KEY environment variable.', {}, async () => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const data = await client.getStats();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error getting analytics: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/store.js

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 export function register(server, client) {
     // --- get_my_store (auth required) ---
     server.tool('get_my_store', 'Get information about your Karrito store (name, slug, currency, stats). Requires KARRITO_API_KEY environment variable.', {}, async () => {
@@ -31,4 +32,93 @@ export function register(server, client) {
             };
         }
     });
+    // --- update_store (auth required) ---
+    server.tool('update_store', 'Update your Karrito store settings (name, WhatsApp number, currency, description, etc.). Requires KARRITO_API_KEY environment variable.', {
+        name: z.string().min(1).max(100).optional().describe('Store name'),
+        whatsappNumber: z.string().optional().describe('WhatsApp number in E.164 format (e.g., +18091234567)'),
+        currency: z
+            .enum(['DOP', 'USD', 'MXN', 'COP', 'ARS', 'BRL'])
+            .optional()
+            .describe('Store currency'),
+        whatsappTemplate: z.string().max(2000).optional().describe('WhatsApp message template with shortcodes: {tienda}, {productos}, {total}, {nombre}'),
+        isPublished: z.boolean().optional().describe('Whether the store is publicly visible'),
+        isMaintenance: z.boolean().optional().describe('Whether the store is in maintenance mode'),
+        description: z.string().max(500).optional().describe('Store description'),
+    }, async ({ ...updates }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const updateData = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (value !== undefined)
+                    updateData[key] = value;
+            }
+            if (Object.keys(updateData).length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No fields to update. Provide at least one field (name, whatsappNumber, currency, whatsappTemplate, isPublished, isMaintenance, description).' }],
+                    isError: true,
+                };
+            }
+            const data = await client.updateStore(updateData);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error updating store: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- toggle_publish (auth required) ---
+    server.tool('toggle_publish', 'Quickly publish or unpublish your Karrito store. Shortcut for update_store with isPublished. Requires KARRITO_API_KEY environment variable.', {
+        published: z.boolean().describe('true to publish the store, false to unpublish'),
+    }, async ({ published }) => {
+        if (!client.hasApiKey) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Authentication required. Set the KARRITO_API_KEY environment variable with your Karrito API key. You can generate one at https://karrito.shop/settings/api',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const data = await client.updateStore({ isPublished: published });
+            const action = published ? 'published' : 'unpublished';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Store ${action} successfully.\n\n${JSON.stringify(data, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error toggling publish: ${message}` }],
+                isError: true,
+            };
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karrito-mcp",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "description": "MCP server for Karrito — digital catalog builder for WhatsApp sellers in LATAM",
   "bin": {
     "karrito-mcp": "./dist/index.js"