karrito-mcp 1.0.0

package/README.md

@@ -0,0 +1,119 @@
+# karrito-mcp
+
+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.
+
+## Installation
+
+### Quick start (npx)
+
+```bash
+npx karrito-mcp
+```
+
+### Claude Code
+
+```bash
+claude mcp add karrito -- npx karrito-mcp
+```
+
+### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "karrito": {
+      "command": "npx",
+      "args": ["karrito-mcp"],
+      "env": {
+        "KARRITO_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Add to your MCP configuration:
+
+```json
+{
+  "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](https://karrito.shop/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 (5)
+
+| 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 |
+
+## 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`).
+
+### Compare platforms
+
+> "How does Karrito compare to Shopify and TiendaNube?"
+
+The assistant will read the `karrito://competitors` resource.
+
+## Development
+
+```bash
+git clone https://github.com/curetcore/karrito-mcp
+cd karrito-mcp
+npm install
+npm run dev
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { KarritoApiClient } from './lib/api-client.js';
+// Resources
+import { register as registerPricing } from './resources/pricing.js';
+import { register as registerFeatures } from './resources/features.js';
+import { register as registerNiches } from './resources/niches.js';
+import { register as registerCompetitors } from './resources/competitors.js';
+import { register as registerCurrencies } from './resources/currencies.js';
+// Tools
+import { register as registerCatalogTools } from './tools/catalog.js';
+import { register as registerProductTools } from './tools/products.js';
+import { register as registerOrderTools } from './tools/orders.js';
+const server = new McpServer({
+    name: 'karrito',
+    version: '1.0.0',
+});
+const client = new KarritoApiClient();
+// Register static resources (public, no auth needed)
+registerPricing(server);
+registerFeatures(server);
+registerNiches(server);
+registerCompetitors(server);
+registerCurrencies(server);
+// Register tools
+registerCatalogTools(server, client);
+registerProductTools(server, client);
+registerOrderTools(server, client);
+// Connect via stdio
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Karrito MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

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

@@ -0,0 +1,23 @@
+interface ApiOptions {
+    apiKey?: string;
+    timeout?: number;
+}
+export declare class KarritoApiClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    constructor(options?: ApiOptions);
+    get hasApiKey(): boolean;
+    private request;
+    searchCatalogs(query?: string): Promise<unknown>;
+    checkSlug(slug: string): Promise<{
+        available: boolean;
+    }>;
+    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>;
+}
+export {};

package/dist/lib/api-client.js

@@ -0,0 +1,73 @@
+const BASE_URL = process.env.KARRITO_API_URL ?? 'https://karrito.shop';
+export class KarritoApiClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    constructor(options = {}) {
+        this.baseUrl = BASE_URL;
+        this.apiKey = options.apiKey ?? process.env.KARRITO_API_KEY;
+        this.timeout = options.timeout ?? 10_000;
+    }
+    get hasApiKey() {
+        return Boolean(this.apiKey);
+    }
+    async request(path, options = {}) {
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'karrito-mcp/1.0.0',
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                ...options,
+                headers: { ...headers, ...options.headers },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({
+                    error: response.statusText,
+                }));
+                throw new Error(`Karrito API error ${response.status}: ${error.error}`);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // --- Public endpoints (no auth) ---
+    async searchCatalogs(query) {
+        const params = query ? `?q=${encodeURIComponent(query)}` : '';
+        return this.request(`/api/v1/stores${params}`);
+    }
+    async checkSlug(slug) {
+        return this.request(`/api/check-slug?slug=${encodeURIComponent(slug)}`);
+    }
+    // --- Authenticated endpoints ---
+    async listProducts(limit = 50, offset = 0) {
+        return this.request(`/api/v1/products?limit=${limit}&offset=${offset}`);
+    }
+    async getProduct(id) {
+        return this.request(`/api/v1/products/${id}`);
+    }
+    async createProduct(data) {
+        return this.request('/api/v1/products', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async listCategories(limit = 50, offset = 0) {
+        return this.request(`/api/v1/categories?limit=${limit}&offset=${offset}`);
+    }
+    async listOrders(limit = 50, offset = 0, status) {
+        const statusParam = status ? `&status=${status}` : '';
+        return this.request(`/api/v1/orders?limit=${limit}&offset=${offset}${statusParam}`);
+    }
+    async getOrder(id) {
+        return this.request(`/api/v1/orders/${id}`);
+    }
+}

package/dist/resources/competitors.d.ts

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

package/dist/resources/competitors.js

@@ -0,0 +1,47 @@
+const COMPETITORS_DATA = {
+    summary: 'Karrito is the only catalog builder designed specifically for WhatsApp sellers in LATAM. No payment gateway required — customers order via WhatsApp.',
+    competitors: [
+        { name: 'Shopify', region: 'Global', whatsappNative: false, pricing: '$29+/mo', commission: '2%+', latamFocus: false, freeplan: '3-day trial' },
+        { name: 'TiendaNube', region: 'LATAM', whatsappNative: false, pricing: '$9+/mo', commission: '2%', latamFocus: true, freeplan: 'Yes (limited)' },
+        { name: 'Mercado Shops', region: 'LATAM', whatsappNative: false, pricing: 'Free', commission: '6-13%', latamFocus: true, freeplan: 'Yes' },
+        { name: 'WooCommerce', region: 'Global', whatsappNative: false, pricing: 'Free (hosting extra)', commission: '0%', latamFocus: false, freeplan: 'Yes' },
+        { name: 'Wix', region: 'Global', whatsappNative: false, pricing: '$17+/mo', commission: '0%', latamFocus: false, freeplan: 'Yes (with ads)' },
+        { name: 'Ecwid', region: 'Global', whatsappNative: false, pricing: '$25+/mo', commission: '0%', latamFocus: false, freeplan: 'Yes (5 products)' },
+        { name: 'Square Online', region: 'US-focused', whatsappNative: false, pricing: 'Free', commission: '2.9%', latamFocus: false, freeplan: 'Yes' },
+        { name: 'Jumpseller', region: 'LATAM', whatsappNative: false, pricing: '$19+/mo', commission: '0%', latamFocus: true, freeplan: '14-day trial' },
+        { name: 'Kyte', region: 'Brazil', whatsappNative: true, pricing: '$8+/mo', commission: '0%', latamFocus: true, freeplan: 'Yes (limited)' },
+        { name: 'CatalogApp', region: 'India', whatsappNative: true, pricing: '$5+/mo', commission: '0%', latamFocus: false, freeplan: 'Yes (limited)' },
+        { name: 'Linktree', region: 'Global', whatsappNative: false, pricing: '$5+/mo', commission: '0%', latamFocus: false, freeplan: 'Yes' },
+        { name: 'WhatsApp Business Catalog', region: 'Global', whatsappNative: true, pricing: 'Free', commission: '0%', latamFocus: false, freeplan: 'Yes' },
+        { name: 'GoDaddy', region: 'Global', whatsappNative: false, pricing: '$10+/mo', commission: '0%', latamFocus: false, freeplan: '30-day trial' },
+        { name: 'Zyro/Hostinger', region: 'Global', whatsappNative: false, pricing: '$3+/mo', commission: '0%', latamFocus: false, freeplan: 'No' },
+        { name: 'Empretienda', region: 'Argentina', whatsappNative: true, pricing: '$9+/mo', commission: '0%', latamFocus: true, freeplan: 'Yes (limited)' },
+        { name: 'Pedidos Ya Market', region: 'LATAM', whatsappNative: false, pricing: 'Free', commission: '15-25%', latamFocus: true, freeplan: 'Yes' },
+        { name: 'Rappi Market', region: 'LATAM', whatsappNative: false, pricing: 'Free', commission: '20-30%', latamFocus: true, freeplan: 'Yes' },
+        { name: 'Instagram Shop', region: 'Global', whatsappNative: false, pricing: 'Free', commission: '5%', latamFocus: false, freeplan: 'Yes' },
+        { name: 'Facebook Shops', region: 'Global', whatsappNative: false, pricing: 'Free', commission: '5%', latamFocus: false, freeplan: 'Yes' },
+    ],
+    karritoAdvantages: [
+        '0% commission on all plans, forever',
+        'WhatsApp-native checkout — customers order via message, no payment gateway needed',
+        'Built for LATAM: multi-currency (DOP, MXN, COP, ARS, CLP, USD), Spanish-first',
+        'Mobile-first design — optimized for the 90%+ mobile traffic in LATAM',
+        'Lifetime plan at $499 — no recurring fees ever',
+        'No technical knowledge required — set up in under 5 minutes',
+        'SEO-optimized catalog pages with structured data',
+    ],
+};
+export function register(server) {
+    server.resource('competitors', 'karrito://competitors', {
+        description: 'Competitive analysis: 19 competitors compared with Karrito advantages',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                text: JSON.stringify(COMPETITORS_DATA, null, 2),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+}

package/dist/resources/currencies.d.ts

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

package/dist/resources/currencies.js

@@ -0,0 +1,26 @@
+const CURRENCIES_DATA = {
+    supported: [
+        { code: 'DOP', name: 'Peso dominicano', symbol: 'RD$', country: 'Republica Dominicana', decimalPlaces: 2 },
+        { code: 'MXN', name: 'Peso mexicano', symbol: '$', country: 'Mexico', decimalPlaces: 2 },
+        { code: 'COP', name: 'Peso colombiano', symbol: '$', country: 'Colombia', decimalPlaces: 0 },
+        { code: 'ARS', name: 'Peso argentino', symbol: '$', country: 'Argentina', decimalPlaces: 2 },
+        { code: 'CLP', name: 'Peso chileno', symbol: '$', country: 'Chile', decimalPlaces: 0 },
+        { code: 'USD', name: 'US Dollar', symbol: '$', country: 'United States / International', decimalPlaces: 2 },
+    ],
+    default: 'DOP',
+    notes: 'Currency is set per store. Prices display with the local symbol and formatting. No currency conversion is performed — sellers set prices in their local currency.',
+};
+export function register(server) {
+    server.resource('currencies', 'karrito://currencies', {
+        description: 'Supported currencies in Karrito — 6 LATAM currencies with formatting details',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                text: JSON.stringify(CURRENCIES_DATA, null, 2),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+}

package/dist/resources/features.d.ts

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

package/dist/resources/features.js

@@ -0,0 +1,44 @@
+const FEATURES_DATA = {
+    core: [
+        { name: 'Digital catalog', description: 'Beautiful product catalog with categories, images, and variants' },
+        { name: 'WhatsApp checkout', description: 'Customers order via WhatsApp message — no payment gateway needed' },
+        { name: 'Custom slug', description: 'Your store at karrito.shop/your-name or custom domain' },
+        { name: 'Mobile-first', description: 'Optimized for mobile browsers where 90%+ LATAM traffic comes from' },
+        { name: 'Multi-currency', description: 'DOP, MXN, COP, ARS, CLP, USD supported natively' },
+        { name: 'Product variants', description: 'Size, color, flavor — any variant type (Pro+)' },
+        { name: 'Categories', description: 'Organize products with drag-and-drop categories' },
+        { name: 'Product images', description: 'Up to 5 images per product with automatic optimization' },
+        { name: 'Store customization', description: 'Logo, banner, colors, and social links' },
+        { name: 'SEO optimized', description: 'Each catalog is a fully indexed page with structured data' },
+    ],
+    pro: [
+        { name: 'Analytics dashboard', description: 'Views, clicks, orders, top products, conversion funnel' },
+        { name: 'Custom domain', description: 'Use your own domain (e.g., tienda.tudominio.com)' },
+        { name: 'Remove branding', description: 'No "Powered by Karrito" badge' },
+        { name: 'Priority support', description: 'WhatsApp support with <4h response time' },
+        { name: 'Bulk import', description: 'Import products via CSV' },
+        { name: 'Order history', description: 'Track and manage customer orders' },
+    ],
+    upcoming: [
+        { name: 'AI product descriptions', description: 'Generate compelling product descriptions with AI' },
+        { name: 'Instagram sync', description: 'Import products from Instagram posts' },
+        { name: 'Multi-store', description: 'Manage multiple catalogs from one account' },
+        { name: 'Delivery zones', description: 'Configure delivery areas and fees' },
+        { name: 'Payment links', description: 'Accept card payments via Stripe/MercadoPago' },
+    ],
+    url: 'https://karrito.shop/features',
+};
+export function register(server) {
+    server.resource('features', 'karrito://features', {
+        description: 'Complete list of Karrito features — core, pro, and upcoming',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                text: JSON.stringify(FEATURES_DATA, null, 2),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+}

package/dist/resources/niches.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const NICHES_DATA: {
+    slug: string;
+    name: string;
+    description: string;
+    emoji: string;
+}[];
+export declare function register(server: McpServer): void;

package/dist/resources/niches.js

@@ -0,0 +1,66 @@
+export const NICHES_DATA = [
+    { slug: 'reposteria', name: 'Reposteria', description: 'Cakes, cupcakes, cookies, and custom desserts', emoji: 'cake' },
+    { slug: 'comida-casera', name: 'Comida casera', description: 'Home-cooked meals, meal prep, and lunch delivery', emoji: 'pot' },
+    { slug: 'ropa-mujer', name: 'Ropa de mujer', description: 'Women\'s clothing, dresses, accessories', emoji: 'dress' },
+    { slug: 'ropa-hombre', name: 'Ropa de hombre', description: 'Men\'s clothing, streetwear, casual wear', emoji: 'shirt' },
+    { slug: 'zapatos', name: 'Zapatos', description: 'Sneakers, heels, sandals, boots', emoji: 'shoe' },
+    { slug: 'cosmeticos', name: 'Cosmeticos', description: 'Makeup, skincare, beauty products', emoji: 'lipstick' },
+    { slug: 'joyeria', name: 'Joyeria', description: 'Handmade jewelry, earrings, necklaces, bracelets', emoji: 'ring' },
+    { slug: 'accesorios', name: 'Accesorios', description: 'Phone cases, bags, sunglasses, watches', emoji: 'bag' },
+    { slug: 'plantas', name: 'Plantas', description: 'Indoor plants, succulents, pots, and gardening supplies', emoji: 'plant' },
+    { slug: 'velas-aromas', name: 'Velas y aromas', description: 'Scented candles, essential oils, diffusers', emoji: 'candle' },
+    { slug: 'artesanias', name: 'Artesanias', description: 'Handmade crafts, pottery, macrame, woodwork', emoji: 'art' },
+    { slug: 'mascotas', name: 'Mascotas', description: 'Pet food, accessories, toys, grooming', emoji: 'paw' },
+    { slug: 'fitness', name: 'Fitness', description: 'Supplements, workout gear, activewear', emoji: 'dumbbell' },
+    { slug: 'tecnologia', name: 'Tecnologia', description: 'Gadgets, phone accessories, cables, chargers', emoji: 'phone' },
+    { slug: 'papeleria', name: 'Papeleria', description: 'Stationery, notebooks, planners, stickers', emoji: 'pencil' },
+    { slug: 'jugos-batidos', name: 'Jugos y batidos', description: 'Fresh juices, smoothies, acai bowls', emoji: 'cup' },
+    { slug: 'panaderia', name: 'Panaderia', description: 'Bread, pastries, empanadas, pan de bono', emoji: 'bread' },
+    { slug: 'cafeteria', name: 'Cafeteria', description: 'Specialty coffee, beans, brewing equipment', emoji: 'coffee' },
+    { slug: 'snacks', name: 'Snacks', description: 'Chips, nuts, dried fruit, candy, chocolates', emoji: 'candy' },
+    { slug: 'helados', name: 'Helados', description: 'Ice cream, paletas, frozen yogurt', emoji: 'icecream' },
+    { slug: 'salsas-condimentos', name: 'Salsas y condimentos', description: 'Hot sauce, seasonings, marinades', emoji: 'bottle' },
+    { slug: 'bebidas', name: 'Bebidas', description: 'Craft beverages, kombucha, agua fresca', emoji: 'drink' },
+    { slug: 'bebe', name: 'Bebe', description: 'Baby clothing, toys, accessories, diapers', emoji: 'baby' },
+    { slug: 'hogar', name: 'Hogar', description: 'Home decor, kitchenware, organization', emoji: 'home' },
+    { slug: 'limpieza', name: 'Limpieza', description: 'Eco cleaning products, detergents, supplies', emoji: 'spray' },
+    { slug: 'farmacia', name: 'Farmacia', description: 'OTC medicine, vitamins, health supplies', emoji: 'pill' },
+    { slug: 'electrónica', name: 'Electronica', description: 'Electronics, components, repairs', emoji: 'chip' },
+    { slug: 'ferreteria', name: 'Ferreteria', description: 'Hardware, tools, construction materials', emoji: 'hammer' },
+    { slug: 'libreria', name: 'Libreria', description: 'Books, e-books, educational materials', emoji: 'book' },
+    { slug: 'deportes', name: 'Deportes', description: 'Sports equipment, jerseys, outdoor gear', emoji: 'ball' },
+    { slug: 'musica', name: 'Musica', description: 'Instruments, vinyl, music accessories', emoji: 'guitar' },
+    { slug: 'fotografia', name: 'Fotografia', description: 'Photography prints, frames, camera gear', emoji: 'camera' },
+    { slug: 'flores', name: 'Flores', description: 'Flower arrangements, bouquets, event decor', emoji: 'flower' },
+    { slug: 'eventos', name: 'Eventos', description: 'Party supplies, decorations, invitations', emoji: 'balloon' },
+    { slug: 'regalos', name: 'Regalos', description: 'Gift boxes, personalized gifts, hampers', emoji: 'gift' },
+    { slug: 'imprenta', name: 'Imprenta', description: 'Business cards, flyers, banners, signage', emoji: 'printer' },
+    { slug: 'uniformes', name: 'Uniformes', description: 'Work uniforms, school uniforms, scrubs', emoji: 'vest' },
+    { slug: 'telas', name: 'Telas', description: 'Fabrics, sewing supplies, patterns', emoji: 'scissors' },
+    { slug: 'cuidado-personal', name: 'Cuidado personal', description: 'Shampoo, soap, grooming, natural products', emoji: 'soap' },
+    { slug: 'suplementos', name: 'Suplementos', description: 'Protein, vitamins, health supplements', emoji: 'supplement' },
+    { slug: 'optica', name: 'Optica', description: 'Eyeglasses, contact lenses, sunglasses', emoji: 'glasses' },
+    { slug: 'peluqueria', name: 'Peluqueria', description: 'Hair products, tools, salon supplies', emoji: 'hairdryer' },
+    { slug: 'tatuajes', name: 'Tatuajes', description: 'Tattoo supplies, aftercare, flash designs', emoji: 'needle' },
+    { slug: 'ceramica', name: 'Ceramica', description: 'Handmade ceramics, mugs, plates, vases', emoji: 'vase' },
+    { slug: 'bordados', name: 'Bordados', description: 'Embroidery, patches, custom textile art', emoji: 'thread' },
+    { slug: 'frutas-verduras', name: 'Frutas y verduras', description: 'Fresh produce, organic fruits, vegetables', emoji: 'apple' },
+    { slug: 'carniceria', name: 'Carniceria', description: 'Fresh meat, cuts, sausages, marinated meats', emoji: 'meat' },
+    { slug: 'mariscos', name: 'Mariscos', description: 'Fresh seafood, shrimp, fish, ceviche', emoji: 'shrimp' },
+    { slug: 'lacteos', name: 'Lacteos', description: 'Cheese, yogurt, milk, artisan dairy', emoji: 'cheese' },
+    { slug: 'licores', name: 'Licores', description: 'Wines, spirits, craft beer, mixers', emoji: 'wine' },
+];
+export function register(server) {
+    server.resource('niches', 'karrito://niches', {
+        description: 'All 50 available niches for Karrito stores in LATAM — slug, name, and description',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                text: JSON.stringify({ niches: NICHES_DATA, total: NICHES_DATA.length }, null, 2),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+}

package/dist/resources/pricing.d.ts

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

package/dist/resources/pricing.js

@@ -0,0 +1,56 @@
+const PRICING_DATA = {
+    plans: [
+        {
+            name: 'Free',
+            price: 0,
+            billing: 'forever',
+            products: 10,
+            categories: 3,
+            variants: false,
+            analytics: false,
+            customDomain: false,
+            removeBranding: false,
+        },
+        {
+            name: 'Pro',
+            price: 29,
+            billing: 'monthly',
+            yearlyPrice: 290,
+            products: 500,
+            categories: 50,
+            variants: true,
+            analytics: true,
+            customDomain: true,
+            removeBranding: true,
+        },
+        {
+            name: 'Lifetime',
+            price: 499,
+            billing: 'one-time',
+            products: 'unlimited',
+            categories: 'unlimited',
+            variants: true,
+            analytics: true,
+            customDomain: true,
+            removeBranding: true,
+        },
+    ],
+    commissions: 'Never. 0% on all plans.',
+    trial: '14-day free Pro trial for all new users',
+    refund: '7-day money-back guarantee on Pro and Lifetime',
+    url: 'https://karrito.shop/pricing',
+};
+export function register(server) {
+    server.resource('pricing', 'karrito://pricing', {
+        description: 'Karrito pricing plans, features comparison, and billing details',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                text: JSON.stringify(PRICING_DATA, null, 2),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+}

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

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { NICHES_DATA } from '../resources/niches.js';
+export function register(server, client) {
+    // --- search_catalogs (public, no auth) ---
+    server.tool('search_catalogs', 'Search public Karrito catalogs by keyword. No authentication required.', {
+        query: z.string().min(1).max(100).describe('Search query — store name, product, or niche'),
+    }, async ({ query }) => {
+        try {
+            const data = await client.searchCatalogs(query);
+            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 searching catalogs: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- get_niche_info (public, static data) ---
+    server.tool('get_niche_info', 'Get information about a specific Karrito niche by slug or name. Returns niche details from the 50 available niches. No authentication required.', {
+        niche: z.string().min(1).max(50).describe('Niche slug (e.g., "reposteria") or partial name to search'),
+    }, async ({ niche }) => {
+        const query = niche.toLowerCase();
+        // Busqueda exacta por slug
+        const exactMatch = NICHES_DATA.find((n) => n.slug === query);
+        if (exactMatch) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(exactMatch, null, 2),
+                    },
+                ],
+            };
+        }
+        // Busqueda parcial por nombre o descripcion
+        const partialMatches = NICHES_DATA.filter((n) => n.slug.includes(query) ||
+            n.name.toLowerCase().includes(query) ||
+            n.description.toLowerCase().includes(query));
+        if (partialMatches.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No niches found matching "${niche}". Use the karrito://niches resource to see all 50 available niches.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ matches: partialMatches, total: partialMatches.length }, null, 2),
+                },
+            ],
+        };
+    });
+}

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

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export function register(server, client) {
+    // --- list_my_orders (auth required) ---
+    server.tool('list_my_orders', 'List orders from your Karrito store. Requires KARRITO_API_KEY environment variable.', {
+        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'])
+            .optional()
+            .describe('Filter by order status'),
+    }, async ({ limit, offset, 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.listOrders(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 orders: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

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

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+export function register(server, client) {
+    // --- list_my_products (auth required) ---
+    server.tool('list_my_products', 'List products in your Karrito catalog. Requires KARRITO_API_KEY environment variable.', {
+        limit: z.number().min(1).max(100).default(50).describe('Max products 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.listProducts(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 products: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- create_product (auth required) ---
+    server.tool('create_product', 'Create a new product in your Karrito catalog. Requires KARRITO_API_KEY environment variable.', {
+        name: z.string().min(1).max(200).describe('Product name'),
+        price: z.number().min(0).describe('Product price in store currency'),
+        description: z.string().max(2000).optional().describe('Product description'),
+        categoryId: z.string().optional().describe('Category ID to assign the product to'),
+        imageUrl: z.string().url().optional().describe('Product image URL'),
+    }, async ({ name, price, description, categoryId, imageUrl }) => {
+        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 productData = { name, price };
+            if (description)
+                productData.description = description;
+            if (categoryId)
+                productData.categoryId = categoryId;
+            if (imageUrl)
+                productData.imageUrl = imageUrl;
+            const data = await client.createProduct(productData);
+            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 product: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "karrito-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Karrito — digital catalog builder for WhatsApp sellers in LATAM",
+  "bin": {
+    "karrito-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "karrito",
+    "whatsapp",
+    "catalog",
+    "latam",
+    "ecommerce",
+    "model-context-protocol"
+  ],
+  "author": "Ronaldo Paulino",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/curetcore/karrito-mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}