karrito-mcp 1.0.0 → 1.1.0

package/dist/index.js

@@ -12,9 +12,11 @@ import { register as registerCurrencies } from './resources/currencies.js';
 import { register as registerCatalogTools } from './tools/catalog.js';
 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';
 const server = new McpServer({
     name: 'karrito',
-    version: '1.0.0',
+    version: '1.1.0',
 });
 const client = new KarritoApiClient();
 // Register static resources (public, no auth needed)
@@ -27,6 +29,8 @@ registerCurrencies(server);
 registerCatalogTools(server, client);
 registerProductTools(server, client);
 registerOrderTools(server, client);
+registerCategoryTools(server, client);
+registerStoreTools(server, client);
 // Connect via stdio
 async function main() {
     const transport = new StdioServerTransport();

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

@@ -19,5 +19,9 @@ export declare class KarritoApiClient {
     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>;
+    createCategory(data: Record<string, unknown>): Promise<unknown>;
+    getStore(): 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.0.0',
+            'User-Agent': 'karrito-mcp/1.1.0',
         };
         if (this.apiKey) {
             headers['Authorization'] = `Bearer ${this.apiKey}`;
@@ -70,4 +70,24 @@ export class KarritoApiClient {
     async getOrder(id) {
         return this.request(`/api/v1/orders/${id}`);
     }
+    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',
+        });
+    }
+    async createCategory(data) {
+        return this.request('/api/v1/categories', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async getStore() {
+        return this.request('/api/v1/store');
+    }
 }

package/dist/tools/categories.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/categories.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export function register(server, client) {
+    // --- list_categories (auth required) ---
+    server.tool('list_categories', 'List categories in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        limit: z.number().min(1).max(100).default(50).describe('Max categories to return (1-100)'),
+        offset: z.number().min(0).default(0).describe('Pagination offset'),
+    }, async ({ limit, offset }) => {
+        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.listCategories(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 categories: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- create_category (auth required) ---
+    server.tool('create_category', 'Create a new category in your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        name: z.string().min(1).max(100).describe('Category name'),
+        position: z.number().int().min(0).optional().describe('Sort order (lower = first)'),
+    }, async ({ name, position }) => {
+        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 categoryData = { name };
+            if (position !== undefined)
+                categoryData.position = position;
+            const data = await client.createCategory(categoryData);
+            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 category: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/products.js

@@ -80,4 +80,89 @@ export function register(server, client) {
             };
         }
     });
+    // --- update_product (auth required) ---
+    server.tool('update_product', 'Update an existing product in your Karrito catalog. Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Product ID to update'),
+        name: z.string().min(1).max(200).optional().describe('New product name'),
+        price: z.number().min(0).optional().describe('New price in store currency'),
+        description: z.string().max(2000).optional().describe('New product description'),
+        categoryId: z.string().optional().describe('New category ID'),
+        comparePrice: z.number().min(0).optional().describe('Compare-at price (must be > price)'),
+        isActive: z.boolean().optional().describe('Whether the product 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, price, description, categoryId, comparePrice, isActive).' }],
+                    isError: true,
+                };
+            }
+            const data = await client.updateProduct(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 product: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- delete_product (auth required) ---
+    server.tool('delete_product', 'Delete a product from your Karrito catalog (soft delete). Requires KARRITO_API_KEY environment variable.', {
+        id: z.string().describe('Product 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.deleteProduct(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 product: ${message}` }],
+                isError: true,
+            };
+        }
+    });
 }

package/dist/tools/store.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/store.js

@@ -0,0 +1,34 @@
+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 () => {
+        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.getStore();
+            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 store info: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

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