medusa-plugin-mcp 0.1.0

package/.medusa/server/src/mcp/tools/inventory.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInventoryTools = registerInventoryTools;
+const utils_1 = require("@medusajs/framework/utils");
+const zod_1 = require("zod");
+function registerInventoryTools(server, scope) {
+    const query = scope.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    server.registerTool('low_stock_items', {
+        description: 'Find inventory items with stock levels at or below a threshold.',
+        inputSchema: {
+            threshold: zod_1.z.coerce.number().int().min(0).optional().default(10),
+            limit: zod_1.z.coerce.number().int().min(1).max(100).optional().default(20)
+        }
+    }, async ({ threshold, limit }) => {
+        const { data } = await query.graph({
+            entity: 'inventory_item',
+            fields: [
+                'id',
+                'sku',
+                'title',
+                'location_levels.id',
+                'location_levels.stocked_quantity',
+                'location_levels.reserved_quantity',
+                'location_levels.stock_location.id',
+                'location_levels.stock_location.name'
+            ],
+            filters: {
+                location_levels: {
+                    stocked_quantity: { $lte: threshold }
+                }
+            },
+            pagination: { take: limit }
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }]
+        };
+    });
+    server.registerTool('get_inventory_item', {
+        description: 'Fetch a single inventory item by ID with stock levels across locations.',
+        inputSchema: {
+            inventory_item_id: zod_1.z.string().describe('The inventory item ID')
+        }
+    }, async ({ inventory_item_id }) => {
+        const { data: [item] } = await query.graph({
+            entity: 'inventory_item',
+            fields: [
+                'id',
+                'sku',
+                'title',
+                'requires_shipping',
+                'location_levels.id',
+                'location_levels.stocked_quantity',
+                'location_levels.reserved_quantity',
+                'location_levels.incoming_quantity',
+                'location_levels.stock_location.id',
+                'location_levels.stock_location.name',
+                'created_at',
+                'updated_at'
+            ],
+            filters: { id: inventory_item_id }
+        });
+        if (!item) {
+            return { content: [{ type: 'text', text: 'Inventory item not found.' }] };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(item, null, 2) }]
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52ZW50b3J5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL21jcC90b29scy9pbnZlbnRvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFLQSx3REE4RUM7QUFqRkQscURBQXFFO0FBQ3JFLDZCQUF1QjtBQUV2QixTQUFnQixzQkFBc0IsQ0FBQyxNQUFpQixFQUFFLEtBQXNCO0lBQy9FLE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsaUNBQXlCLENBQUMsS0FBSyxDQUFDLENBQUE7SUFFNUQsTUFBTSxDQUFDLFlBQVksQ0FDbEIsaUJBQWlCLEVBQ2pCO1FBQ0MsV0FBVyxFQUFFLGlFQUFpRTtRQUM5RSxXQUFXLEVBQUU7WUFDWixTQUFTLEVBQUUsT0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUNoRSxLQUFLLEVBQUUsT0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7U0FDckU7S0FDRCxFQUNELEtBQUssRUFBRSxFQUFFLFNBQVMsRUFBRSxLQUFLLEVBQUUsRUFBRSxFQUFFO1FBQzlCLE1BQU0sRUFBRSxJQUFJLEVBQUUsR0FBRyxNQUFNLEtBQUssQ0FBQyxLQUFLLENBQUM7WUFDbEMsTUFBTSxFQUFFLGdCQUFnQjtZQUN4QixNQUFNLEVBQUU7Z0JBQ1AsSUFBSTtnQkFDSixLQUFLO2dCQUNMLE9BQU87Z0JBQ1Asb0JBQW9CO2dCQUNwQixrQ0FBa0M7Z0JBQ2xDLG1DQUFtQztnQkFDbkMsbUNBQW1DO2dCQUNuQyxxQ0FBcUM7YUFDckM7WUFDRCxPQUFPLEVBQUU7Z0JBQ1IsZUFBZSxFQUFFO29CQUNoQixnQkFBZ0IsRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUU7aUJBQ3JDO2FBQ007WUFDUixVQUFVLEVBQUUsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFO1NBQzNCLENBQUMsQ0FBQTtRQUVGLE9BQU87WUFDTixPQUFPLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFlLEVBQUUsSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDO1NBQ3pFLENBQUE7SUFDRixDQUFDLENBQ0QsQ0FBQTtJQUVELE1BQU0sQ0FBQyxZQUFZLENBQ2xCLG9CQUFvQixFQUNwQjtRQUNDLFdBQVcsRUFBRSx5RUFBeUU7UUFDdEYsV0FBVyxFQUFFO1lBQ1osaUJBQWlCLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQztTQUMvRDtLQUNELEVBQ0QsS0FBSyxFQUFFLEVBQUUsaUJBQWlCLEVBQUUsRUFBRSxFQUFFO1FBQy9CLE1BQU0sRUFDTCxJQUFJLEVBQUUsQ0FBQyxJQUFJLENBQUMsRUFDWixHQUFHLE1BQU0sS0FBSyxDQUFDLEtBQUssQ0FBQztZQUNyQixNQUFNLEVBQUUsZ0JBQWdCO1lBQ3hCLE1BQU0sRUFBRTtnQkFDUCxJQUFJO2dCQUNKLEtBQUs7Z0JBQ0wsT0FBTztnQkFDUCxtQkFBbUI7Z0JBQ25CLG9CQUFvQjtnQkFDcEIsa0NBQWtDO2dCQUNsQyxtQ0FBbUM7Z0JBQ25DLG1DQUFtQztnQkFDbkMsbUNBQW1DO2dCQUNuQyxxQ0FBcUM7Z0JBQ3JDLFlBQVk7Z0JBQ1osWUFBWTthQUNaO1lBQ0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLGlCQUFpQixFQUFFO1NBQ2xDLENBQUMsQ0FBQTtRQUVGLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNYLE9BQU8sRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFlLEVBQUUsSUFBSSxFQUFFLDJCQUEyQixFQUFFLENBQUMsRUFBRSxDQUFBO1FBQ25GLENBQUM7UUFFRCxPQUFPO1lBQ04sT0FBTyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBZSxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUN6RSxDQUFBO0lBQ0YsQ0FBQyxDQUNELENBQUE7QUFDRixDQUFDIn0=

package/.medusa/server/src/mcp/tools/orders.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MedusaContainer } from '@medusajs/framework/types';
+export declare function registerOrderTools(server: McpServer, scope: MedusaContainer): void;

package/.medusa/server/src/mcp/tools/orders.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOrderTools = registerOrderTools;
+const utils_1 = require("@medusajs/framework/utils");
+const zod_1 = require("zod");
+function registerOrderTools(server, scope) {
+    const query = scope.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    server.registerTool('recent_orders', {
+        description: 'Fetch recent orders with status, totals, and customer info.',
+        inputSchema: {
+            limit: zod_1.z.coerce.number().int().min(1).max(50).optional().default(10),
+            status: zod_1.z.string().optional().describe('Filter by order status')
+        }
+    }, async ({ limit, status }) => {
+        const { data } = await query.graph({
+            entity: 'order',
+            fields: [
+                'id',
+                'display_id',
+                'status',
+                'email',
+                'total',
+                'subtotal',
+                'tax_total',
+                'shipping_total',
+                'customer.first_name',
+                'customer.last_name',
+                'created_at'
+            ],
+            filters: (status ? { status } : {}),
+            pagination: { take: limit, order: { created_at: 'DESC' } }
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }]
+        };
+    });
+    server.registerTool('get_order', {
+        description: 'Fetch a single order by ID with full details including items, fulfillments, and customer.',
+        inputSchema: {
+            order_id: zod_1.z.string().describe('The order ID')
+        }
+    }, async ({ order_id }) => {
+        const { data: [order] } = await query.graph({
+            entity: 'order',
+            fields: [
+                'id',
+                'display_id',
+                'status',
+                'email',
+                'total',
+                'subtotal',
+                'tax_total',
+                'shipping_total',
+                'discount_total',
+                'customer.id',
+                'customer.first_name',
+                'customer.last_name',
+                'customer.email',
+                'items.id',
+                'items.title',
+                'items.quantity',
+                'items.unit_price',
+                'shipping_address.*',
+                'billing_address.*',
+                'fulfillments.id',
+                'fulfillments.status',
+                'created_at',
+                'updated_at'
+            ],
+            filters: { id: order_id }
+        });
+        if (!order) {
+            return { content: [{ type: 'text', text: 'Order not found.' }] };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(order, null, 2) }]
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JkZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL21jcC90b29scy9vcmRlcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFLQSxnREF3RkM7QUEzRkQscURBQXFFO0FBQ3JFLDZCQUF1QjtBQUV2QixTQUFnQixrQkFBa0IsQ0FBQyxNQUFpQixFQUFFLEtBQXNCO0lBQzNFLE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsaUNBQXlCLENBQUMsS0FBSyxDQUFDLENBQUE7SUFFNUQsTUFBTSxDQUFDLFlBQVksQ0FDbEIsZUFBZSxFQUNmO1FBQ0MsV0FBVyxFQUFFLDZEQUE2RDtRQUMxRSxXQUFXLEVBQUU7WUFDWixLQUFLLEVBQUUsT0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDcEUsTUFBTSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsd0JBQXdCLENBQUM7U0FDaEU7S0FDRCxFQUNELEtBQUssRUFBRSxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFO1FBQzNCLE1BQU0sRUFBRSxJQUFJLEVBQUUsR0FBRyxNQUFNLEtBQUssQ0FBQyxLQUFLLENBQUM7WUFDbEMsTUFBTSxFQUFFLE9BQU87WUFDZixNQUFNLEVBQUU7Z0JBQ1AsSUFBSTtnQkFDSixZQUFZO2dCQUNaLFFBQVE7Z0JBQ1IsT0FBTztnQkFDUCxPQUFPO2dCQUNQLFVBQVU7Z0JBQ1YsV0FBVztnQkFDWCxnQkFBZ0I7Z0JBQ2hCLHFCQUFxQjtnQkFDckIsb0JBQW9CO2dCQUNwQixZQUFZO2FBQ1o7WUFDRCxPQUFPLEVBQUUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBUTtZQUMxQyxVQUFVLEVBQUUsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxFQUFFLFVBQVUsRUFBRSxNQUFNLEVBQUUsRUFBRTtTQUMxRCxDQUFDLENBQUE7UUFFRixPQUFPO1lBQ04sT0FBTyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBZSxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUN6RSxDQUFBO0lBQ0YsQ0FBQyxDQUNELENBQUE7SUFFRCxNQUFNLENBQUMsWUFBWSxDQUNsQixXQUFXLEVBQ1g7UUFDQyxXQUFXLEVBQUUsMkZBQTJGO1FBQ3hHLFdBQVcsRUFBRTtZQUNaLFFBQVEsRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBQztTQUM3QztLQUNELEVBQ0QsS0FBSyxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLEVBQ0wsSUFBSSxFQUFFLENBQUMsS0FBSyxDQUFDLEVBQ2IsR0FBRyxNQUFNLEtBQUssQ0FBQyxLQUFLLENBQUM7WUFDckIsTUFBTSxFQUFFLE9BQU87WUFDZixNQUFNLEVBQUU7Z0JBQ1AsSUFBSTtnQkFDSixZQUFZO2dCQUNaLFFBQVE7Z0JBQ1IsT0FBTztnQkFDUCxPQUFPO2dCQUNQLFVBQVU7Z0JBQ1YsV0FBVztnQkFDWCxnQkFBZ0I7Z0JBQ2hCLGdCQUFnQjtnQkFDaEIsYUFBYTtnQkFDYixxQkFBcUI7Z0JBQ3JCLG9CQUFvQjtnQkFDcEIsZ0JBQWdCO2dCQUNoQixVQUFVO2dCQUNWLGFBQWE7Z0JBQ2IsZ0JBQWdCO2dCQUNoQixrQkFBa0I7Z0JBQ2xCLG9CQUFvQjtnQkFDcEIsbUJBQW1CO2dCQUNuQixpQkFBaUI7Z0JBQ2pCLHFCQUFxQjtnQkFDckIsWUFBWTtnQkFDWixZQUFZO2FBQ1o7WUFDRCxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsUUFBUSxFQUFFO1NBQ3pCLENBQUMsQ0FBQTtRQUVGLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNaLE9BQU8sRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFlLEVBQUUsSUFBSSxFQUFFLGtCQUFrQixFQUFFLENBQUMsRUFBRSxDQUFBO1FBQzFFLENBQUM7UUFFRCxPQUFPO1lBQ04sT0FBTyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBZSxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUMxRSxDQUFBO0lBQ0YsQ0FBQyxDQUNELENBQUE7QUFDRixDQUFDIn0=

package/.medusa/server/src/mcp/tools/products.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MedusaContainer } from '@medusajs/framework/types';
+export declare function registerProductTools(server: McpServer, scope: MedusaContainer): void;

package/.medusa/server/src/mcp/tools/products.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProductTools = registerProductTools;
+const utils_1 = require("@medusajs/framework/utils");
+const zod_1 = require("zod");
+function registerProductTools(server, scope) {
+    const query = scope.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    server.registerTool('search_products', {
+        description: 'Search products by title.',
+        inputSchema: {
+            q: zod_1.z.string().describe('Search term (matches title)'),
+            limit: zod_1.z.coerce.number().int().min(1).max(50).optional().default(10)
+        }
+    }, async ({ q, limit }) => {
+        const { data } = await query.graph({
+            entity: 'product',
+            fields: [
+                'id',
+                'title',
+                'handle',
+                'status',
+                'variants.id',
+                'variants.title',
+                'variants.sku',
+                'created_at'
+            ],
+            filters: { title: { $ilike: `%${q}%` } },
+            pagination: { take: limit }
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }]
+        };
+    });
+    server.registerTool('get_product', {
+        description: 'Fetch a single product by ID with variants and pricing.',
+        inputSchema: {
+            product_id: zod_1.z.string().describe('The product ID')
+        }
+    }, async ({ product_id }) => {
+        const { data: [product] } = await query.graph({
+            entity: 'product',
+            fields: [
+                'id',
+                'title',
+                'handle',
+                'subtitle',
+                'description',
+                'status',
+                'variants.id',
+                'variants.title',
+                'variants.sku',
+                'variants.prices.amount',
+                'variants.prices.currency_code',
+                'options.id',
+                'options.title',
+                'options.values.value',
+                'tags.id',
+                'tags.value',
+                'created_at',
+                'updated_at'
+            ],
+            filters: { id: product_id }
+        });
+        if (!product) {
+            return { content: [{ type: 'text', text: 'Product not found.' }] };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(product, null, 2) }]
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZHVjdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvbWNwL3Rvb2xzL3Byb2R1Y3RzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBS0Esb0RBZ0ZDO0FBbkZELHFEQUFxRTtBQUNyRSw2QkFBdUI7QUFFdkIsU0FBZ0Isb0JBQW9CLENBQUMsTUFBaUIsRUFBRSxLQUFzQjtJQUM3RSxNQUFNLEtBQUssR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLGlDQUF5QixDQUFDLEtBQUssQ0FBQyxDQUFBO0lBRTVELE1BQU0sQ0FBQyxZQUFZLENBQ2xCLGlCQUFpQixFQUNqQjtRQUNDLFdBQVcsRUFBRSwyQkFBMkI7UUFDeEMsV0FBVyxFQUFFO1lBQ1osQ0FBQyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLENBQUMsNkJBQTZCLENBQUM7WUFDckQsS0FBSyxFQUFFLE9BQUMsQ0FBQyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1NBQ3BFO0tBQ0QsRUFDRCxLQUFLLEVBQUUsRUFBRSxDQUFDLEVBQUUsS0FBSyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLEVBQUUsSUFBSSxFQUFFLEdBQUcsTUFBTSxLQUFLLENBQUMsS0FBSyxDQUFDO1lBQ2xDLE1BQU0sRUFBRSxTQUFTO1lBQ2pCLE1BQU0sRUFBRTtnQkFDUCxJQUFJO2dCQUNKLE9BQU87Z0JBQ1AsUUFBUTtnQkFDUixRQUFRO2dCQUNSLGFBQWE7Z0JBQ2IsZ0JBQWdCO2dCQUNoQixjQUFjO2dCQUNkLFlBQVk7YUFDWjtZQUNELE9BQU8sRUFBRSxFQUFFLEtBQUssRUFBRSxFQUFFLE1BQU0sRUFBRSxJQUFJLENBQUMsR0FBRyxFQUFFLEVBQUU7WUFDeEMsVUFBVSxFQUFFLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRTtTQUMzQixDQUFDLENBQUE7UUFFRixPQUFPO1lBQ04sT0FBTyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBZSxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUN6RSxDQUFBO0lBQ0YsQ0FBQyxDQUNELENBQUE7SUFFRCxNQUFNLENBQUMsWUFBWSxDQUNsQixhQUFhLEVBQ2I7UUFDQyxXQUFXLEVBQUUseURBQXlEO1FBQ3RFLFdBQVcsRUFBRTtZQUNaLFVBQVUsRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLGdCQUFnQixDQUFDO1NBQ2pEO0tBQ0QsRUFDRCxLQUFLLEVBQUUsRUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFO1FBQ3hCLE1BQU0sRUFDTCxJQUFJLEVBQUUsQ0FBQyxPQUFPLENBQUMsRUFDZixHQUFHLE1BQU0sS0FBSyxDQUFDLEtBQUssQ0FBQztZQUNyQixNQUFNLEVBQUUsU0FBUztZQUNqQixNQUFNLEVBQUU7Z0JBQ1AsSUFBSTtnQkFDSixPQUFPO2dCQUNQLFFBQVE7Z0JBQ1IsVUFBVTtnQkFDVixhQUFhO2dCQUNiLFFBQVE7Z0JBQ1IsYUFBYTtnQkFDYixnQkFBZ0I7Z0JBQ2hCLGNBQWM7Z0JBQ2Qsd0JBQXdCO2dCQUN4QiwrQkFBK0I7Z0JBQy9CLFlBQVk7Z0JBQ1osZUFBZTtnQkFDZixzQkFBc0I7Z0JBQ3RCLFNBQVM7Z0JBQ1QsWUFBWTtnQkFDWixZQUFZO2dCQUNaLFlBQVk7YUFDWjtZQUNELE9BQU8sRUFBRSxFQUFFLEVBQUUsRUFBRSxVQUFVLEVBQUU7U0FDM0IsQ0FBQyxDQUFBO1FBRUYsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ2QsT0FBTyxFQUFFLE9BQU8sRUFBRSxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQWUsRUFBRSxJQUFJLEVBQUUsb0JBQW9CLEVBQUUsQ0FBQyxFQUFFLENBQUE7UUFDNUUsQ0FBQztRQUVELE9BQU87WUFDTixPQUFPLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFlLEVBQUUsSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDO1NBQzVFLENBQUE7SUFDRixDQUFDLENBQ0QsQ0FBQTtBQUNGLENBQUMifQ==

package/.medusa/server/src/mcp/tools/query.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MedusaContainer } from '@medusajs/framework/types';
+export declare function registerQueryTool(server: McpServer, scope: MedusaContainer): void;

package/.medusa/server/src/mcp/tools/query.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQueryTool = registerQueryTool;
+const utils_1 = require("@medusajs/framework/utils");
+const zod_1 = require("zod");
+const ALLOWED_ENTITIES = [
+    'order', 'product', 'product_variant', 'customer', 'inventory_item',
+    'fulfillment', 'cart', 'shipping_option', 'sales_channel', 'store',
+    'form', 'form_submission', 'review', 'complaint', 'complaint_tag',
+    'content_item', 'content_collection', 'stock_lot', 'serial_number',
+    'veeqo_order', 'veeqo_shipment', 'webhook_trigger', 'webhook_action',
+    'barcode', 'order_note', 'customer_tag'
+];
+function registerQueryTool(server, scope) {
+    server.registerTool('query', {
+        description: `Run a query against any Medusa entity using query.graph(). Allowed entities: ${ALLOWED_ENTITIES.join(', ')}. ` +
+            'Use dot notation for relations (e.g. "customer.first_name"). ' +
+            'Filters support operators: $eq, $ne, $in, $nin, $like, $ilike, $gt, $gte, $lt, $lte.',
+        inputSchema: {
+            entity: zod_1.z.enum(ALLOWED_ENTITIES),
+            fields: zod_1.z.array(zod_1.z.string()).min(1).describe('Fields to return, e.g. ["id", "email", "orders.id"]'),
+            filters: zod_1.z.record(zod_1.z.unknown()).optional().describe('Filter conditions, e.g. { status: "completed" }'),
+            limit: zod_1.z.coerce.number().int().min(1).max(100).optional().default(20),
+            offset: zod_1.z.coerce.number().int().min(0).optional().default(0)
+        }
+    }, async ({ entity, fields, filters, limit, offset }) => {
+        const query = scope.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+        const { data, metadata } = await query.graph({
+            entity,
+            fields,
+            filters: filters ?? {},
+            pagination: { take: limit, skip: offset }
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ data, count: metadata?.count ?? data.length, limit, offset }, null, 2)
+                }]
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicXVlcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvbWNwL3Rvb2xzL3F1ZXJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBY0EsOENBa0NDO0FBOUNELHFEQUFxRTtBQUNyRSw2QkFBdUI7QUFFdkIsTUFBTSxnQkFBZ0IsR0FBRztJQUN4QixPQUFPLEVBQUUsU0FBUyxFQUFFLGlCQUFpQixFQUFFLFVBQVUsRUFBRSxnQkFBZ0I7SUFDbkUsYUFBYSxFQUFFLE1BQU0sRUFBRSxpQkFBaUIsRUFBRSxlQUFlLEVBQUUsT0FBTztJQUNsRSxNQUFNLEVBQUUsaUJBQWlCLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxlQUFlO0lBQ2pFLGNBQWMsRUFBRSxvQkFBb0IsRUFBRSxXQUFXLEVBQUUsZUFBZTtJQUNsRSxhQUFhLEVBQUUsZ0JBQWdCLEVBQUUsaUJBQWlCLEVBQUUsZ0JBQWdCO0lBQ3BFLFNBQVMsRUFBRSxZQUFZLEVBQUUsY0FBYztDQUN2QyxDQUFBO0FBRUQsU0FBZ0IsaUJBQWlCLENBQUMsTUFBaUIsRUFBRSxLQUFzQjtJQUMxRSxNQUFNLENBQUMsWUFBWSxDQUNsQixPQUFPLEVBQ1A7UUFDQyxXQUFXLEVBQ1YsZ0ZBQWdGLGdCQUFnQixDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSTtZQUMvRywrREFBK0Q7WUFDL0Qsc0ZBQXNGO1FBQ3ZGLFdBQVcsRUFBRTtZQUNaLE1BQU0sRUFBRSxPQUFDLENBQUMsSUFBSSxDQUFDLGdCQUF5QyxDQUFDO1lBQ3pELE1BQU0sRUFBRSxPQUFDLENBQUMsS0FBSyxDQUFDLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMscURBQXFELENBQUM7WUFDbEcsT0FBTyxFQUFFLE9BQUMsQ0FBQyxNQUFNLENBQUMsT0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxDQUFDLGlEQUFpRCxDQUFDO1lBQ3JHLEtBQUssRUFBRSxPQUFDLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUNyRSxNQUFNLEVBQUUsT0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQztTQUM1RDtLQUNELEVBQ0QsS0FBSyxFQUFFLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUU7UUFDcEQsTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxpQ0FBeUIsQ0FBQyxLQUFLLENBQUMsQ0FBQTtRQUU1RCxNQUFNLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxHQUFHLE1BQU0sS0FBSyxDQUFDLEtBQUssQ0FBQztZQUM1QyxNQUFNO1lBQ04sTUFBTTtZQUNOLE9BQU8sRUFBRSxPQUFPLElBQUksRUFBRTtZQUN0QixVQUFVLEVBQUUsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUU7U0FDekMsQ0FBQyxDQUFBO1FBRUYsT0FBTztZQUNOLE9BQU8sRUFBRSxDQUFDO29CQUNULElBQUksRUFBRSxNQUFlO29CQUNyQixJQUFJLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxFQUFFLElBQUksRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFLEtBQUssSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO2lCQUM3RixDQUFDO1NBQ0YsQ0FBQTtJQUNGLENBQUMsQ0FDRCxDQUFBO0FBQ0YsQ0FBQyJ9

package/.medusa/server/src/mcp/tools/statistics.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MedusaContainer } from '@medusajs/framework/types';
+export declare function registerStatisticsTools(_server: McpServer, _scope: MedusaContainer, _moduleKey: string): void;

package/.medusa/server/src/mcp/tools/statistics.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatisticsTools = registerStatisticsTools;
+function registerStatisticsTools(_server, _scope, _moduleKey) {
+    // Future: register tools that query statistics_daily data
+    // e.g. get_revenue_trend, get_order_stats, compare_periods
+    // These tools will return structured data that the chat UI
+    // can render as Recharts charts.
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhdGlzdGljcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9tY3AvdG9vbHMvc3RhdGlzdGljcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUdBLDBEQVNDO0FBVEQsU0FBZ0IsdUJBQXVCLENBQ3RDLE9BQWtCLEVBQ2xCLE1BQXVCLEVBQ3ZCLFVBQWtCO0lBRWxCLDBEQUEwRDtJQUMxRCwyREFBMkQ7SUFDM0QsMkRBQTJEO0lBQzNELGlDQUFpQztBQUNsQyxDQUFDIn0=

package/.medusa/server/src/modules/mcp/index.d.ts

@@ -0,0 +1,7 @@
+import { McpService } from './service';
+export declare const MCP_MODULE = "mcp";
+declare const _default: import("@medusajs/types").ModuleExports<typeof McpService> & {
+    linkable: Record<string, any>;
+};
+export default _default;
+export * from './service';

package/.medusa/server/src/modules/mcp/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_MODULE = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const service_1 = require("./service");
+exports.MCP_MODULE = 'mcp';
+exports.default = (0, utils_1.Module)(exports.MCP_MODULE, {
+    service: service_1.McpService
+});
+__exportStar(require("./service"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9tY3AvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxxREFBa0Q7QUFDbEQsdUNBQXNDO0FBRXpCLFFBQUEsVUFBVSxHQUFHLEtBQUssQ0FBQTtBQUUvQixrQkFBZSxJQUFBLGNBQU0sRUFBQyxrQkFBVSxFQUFFO0lBQ2pDLE9BQU8sRUFBRSxvQkFBVTtDQUNuQixDQUFDLENBQUE7QUFFRiw0Q0FBeUIifQ==

package/.medusa/server/src/modules/mcp/service.d.ts

@@ -0,0 +1,8 @@
+import type { McpPluginOptions } from '../../types';
+declare const McpService_base: import("@medusajs/framework/utils").MedusaServiceReturnType<import("@medusajs/framework/utils").ModelConfigurationsToConfigTemplate<{}>>;
+export declare class McpService extends McpService_base {
+    protected readonly options_: McpPluginOptions;
+    constructor(_container: object, options: McpPluginOptions);
+    getOptions(): McpPluginOptions;
+}
+export {};

package/.medusa/server/src/modules/mcp/service.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpService = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+class McpService extends (0, utils_1.MedusaService)({}) {
+    constructor(_container, options) {
+        super(...arguments);
+        this.options_ = options;
+    }
+    getOptions() {
+        return this.options_;
+    }
+}
+exports.McpService = McpService;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL21jcC9zZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFEQUF5RDtBQUd6RCxNQUFhLFVBQVcsU0FBUSxJQUFBLHFCQUFhLEVBQUMsRUFBRSxDQUFDO0lBR2hELFlBQVksVUFBa0IsRUFBRSxPQUF5QjtRQUN4RCxLQUFLLENBQUMsR0FBRyxTQUFTLENBQUMsQ0FBQTtRQUNuQixJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQTtJQUN4QixDQUFDO0lBRUQsVUFBVTtRQUNULE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQTtJQUNyQixDQUFDO0NBQ0Q7QUFYRCxnQ0FXQyJ9

package/.medusa/server/src/types.d.ts

@@ -0,0 +1,7 @@
+export type McpPluginOptions = {
+    provider: 'anthropic' | 'openai' | 'ollama';
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    systemPrompt?: string;
+};

package/.medusa/server/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/LICENSE.md

@@ -0,0 +1,73 @@
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes or for non-commercial or
+personal use. You may distribute the software or provide it to others only if you do so free of charge for
+non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
+the licensor in the software. Any use of the licensor’s trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
+license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
+subject to the limitations and conditions in this license. This license does not cover any patent claims that
+you cause to be infringed by modifications or additions to the software. If you or your company make any
+written claim that the software infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+### Definitions
+
+The “licensor” is the entity offering these terms.
+
+The “software” is the software the licensor makes available under these terms, including any portion of it.
+
+“You” refers to the individual or entity agreeing to these terms.
+
+“Your company” is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+“Your license” is the license granted to you for the software under these terms.
+
+“Use” means anything you do with the software requiring your license.
+
+“Trademark” means trademarks, service marks, and similar rights.

package/package.json

@@ -0,0 +1,98 @@
+{
+	"name": "medusa-plugin-mcp",
+	"version": "0.1.0",
+	"description": "MCP server and LLM chat plugin for Medusa v2",
+	"author": "Lacey Pevey",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/pevey/medusa-plugins"
+	},
+	"homepage": "https://pevey.com/medusa-plugin-mcp",
+	"files": [
+		".medusa/server"
+	],
+	"exports": {
+		"./package.json": "./package.json",
+		"./admin": {
+			"import": "./.medusa/server/src/admin/index.mjs",
+			"require": "./.medusa/server/src/admin/index.js",
+			"default": "./.medusa/server/src/admin/index.js"
+		},
+		"./.medusa/server/src/modules/*": {
+			"types": "./.medusa/server/src/modules/*/index.d.ts",
+			"default": "./.medusa/server/src/modules/*/index.js"
+		},
+		"./modules/*": {
+			"types": "./.medusa/server/src/modules/*/index.d.ts",
+			"default": "./.medusa/server/src/modules/*/index.js"
+		},
+		"./providers/*": {
+			"types": "./.medusa/server/src/providers/*/index.d.ts",
+			"default": "./.medusa/server/src/providers/*/index.js"
+		},
+		"./*": {
+			"types": "./.medusa/server/src/*.d.ts",
+			"default": "./.medusa/server/src/*.js"
+		},
+		".": {
+			"types": "./.medusa/server/src/modules/mcp/index.d.ts",
+			"default": "./.medusa/server/src/modules/mcp/index.js"
+		}
+	},
+	"keywords": [
+		"medusa-v2",
+		"medusa",
+		"mcp",
+		"chat",
+		"ai",
+		"llm",
+		"model-context-protocol"
+	],
+	"scripts": {
+		"build": "medusa plugin:build",
+		"dev": "medusa plugin:develop",
+		"prepublishOnly": "medusa plugin:build"
+	},
+	"dependencies": {
+		"@anthropic-ai/sdk": "^0.51.0",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"ollama": "^0.6.3",
+		"openai": "^4.98.0",
+		"recharts": "^2.15.3"
+	},
+	"devDependencies": {
+		"@medusajs/admin-sdk": "2.13.6",
+		"@medusajs/cli": "2.13.6",
+		"@medusajs/framework": "2.13.6",
+		"@medusajs/icons": "2.13.6",
+		"@medusajs/ui": "4.0.25",
+		"@types/node": "^20.0.0",
+		"@types/react": "^18.3.2",
+		"@types/react-dom": "^18.2.25",
+		"medusa-plugin-automation": "workspace:*",
+		"medusa-plugin-statistics": "workspace:*",
+		"prop-types": "^15.8.1",
+		"react": "^18.2.0",
+		"react-dom": "^18.2.0",
+		"typescript": "^5.6.2",
+		"vite": "^5.2.11"
+	},
+	"peerDependencies": {
+		"@medusajs/framework": "2.13.6",
+		"@medusajs/js-sdk": "2.13.6",
+		"@medusajs/medusa": "2.13.6",
+		"medusa-plugin-automation": "*",
+		"medusa-plugin-statistics": "*"
+	},
+	"peerDependenciesMeta": {
+		"medusa-plugin-automation": {
+			"optional": true
+		},
+		"medusa-plugin-statistics": {
+			"optional": true
+		}
+	},
+	"engines": {
+		"node": ">=20"
+	}
+}