@vendure/mcp-plugin 3.8.0-minor-bootstrap.0

package/lib/tools/built-in/shop/apply-coupon-code.tool.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplyCouponCodeTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const active_order_service_1 = require("../active-order.service");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const applyCouponCodeInput = zod_1.z.strictObject({
+    code: string_schemas_1.shortText.describe('Coupon code.'),
+});
+let ApplyCouponCodeTool = class ApplyCouponCodeTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const order = await this.activeOrder.findEditable(ctx);
+        if ((0, core_1.isGraphQlErrorResult)(order)) {
+            return this.serializer.orderOrError(order);
+        }
+        return this.serializer.orderOrError(await this.orderService.applyCouponCode(order.ctx, order.id, input.code));
+    }
+};
+exports.ApplyCouponCodeTool = ApplyCouponCodeTool;
+exports.ApplyCouponCodeTool = ApplyCouponCodeTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'apply_coupon_code',
+        toolset: 'shop',
+        description: 'Apply a coupon code to the active cart. A valid code can appear in couponCodes without reducing ' +
+            'the total. Compare the returned total and discounts with the previous cart before reporting a discount.',
+        keywords: [
+            'use a promo code',
+            'redeem a discount',
+            'enter my voucher',
+            'apply a discount code',
+            'I have a coupon',
+            'use my promotional code',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: applyCouponCodeInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], ApplyCouponCodeTool);
+//# sourceMappingURL=apply-coupon-code.tool.js.map

package/lib/tools/built-in/shop/apply-coupon-code.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-coupon-code.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/apply-coupon-code.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA+F;AAC/F,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAgE;AAChE,8DAAiE;AACjE,sDAA8C;AAE9C,MAAM,oBAAoB,GAAG,OAAC,CAAC,YAAY,CAAC;IACxC,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC3C,CAAC,CAAC;AAwBI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC5B,YACqB,WAAkC,EAClC,YAA0B,EAC1B,UAAoC;QAFpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAA2B;QAC1D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,IAAA,2BAAoB,EAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAC3E,CAAC;IACN,CAAC;CACJ,CAAA;AAhBY,kDAAmB;8BAAnB,mBAAmB;IApB/B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,MAAM;QACf,WAAW,EACP,kGAAkG;YAClG,yGAAyG;QAC7G,QAAQ,EAAE;YACN,kBAAkB;YAClB,mBAAmB;YACnB,kBAAkB;YAClB,uBAAuB;YACvB,iBAAiB;YACjB,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,oBAAoB;KACpC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,mBAAmB,CAgB/B"}

package/lib/tools/built-in/shop/collection-lookup.d.ts

@@ -0,0 +1,15 @@
+import { Collection, CollectionService, ID, ListQueryOptions, RelationPaths, RequestContext } from '@vendure/core';
+import { type ListInput } from '../list-helpers';
+type CollectionLookup = {
+    kind: 'id';
+    value: ID;
+} | {
+    kind: 'slug';
+    value: string;
+};
+export declare function collectionLookup(id: ID | undefined, slug: string | undefined): CollectionLookup | undefined;
+export declare function findPublicCollection(collectionService: CollectionService, ctx: RequestContext, lookup: CollectionLookup, relations?: RelationPaths<Collection>): Promise<Collection | undefined>;
+/** The one wording every shop tool uses when the lookup found no public collection. */
+export declare function noCollectionMessage(lookup: CollectionLookup): string;
+export declare function publicCollectionListOptions(input: ListInput): ListQueryOptions<Collection>;
+export {};

package/lib/tools/built-in/shop/collection-lookup.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectionLookup = collectionLookup;
+exports.findPublicCollection = findPublicCollection;
+exports.noCollectionMessage = noCollectionMessage;
+exports.publicCollectionListOptions = publicCollectionListOptions;
+const generated_types_1 = require("@vendure/common/lib/generated-types");
+const list_helpers_1 = require("../list-helpers");
+function collectionLookup(id, slug) {
+    if (id != null) {
+        return { kind: 'id', value: id };
+    }
+    if (slug != null) {
+        return { kind: 'slug', value: slug };
+    }
+    return undefined;
+}
+// A private collection is hidden from shoppers, so it counts as unknown here too.
+async function findPublicCollection(collectionService, ctx, lookup, relations = []) {
+    const collection = lookup.kind === 'id'
+        ? await collectionService.findOne(ctx, lookup.value, relations)
+        : await collectionService.findOneBySlug(ctx, lookup.value, relations);
+    return collection && !collection.isPrivate ? collection : undefined;
+}
+/** The one wording every shop tool uses when the lookup found no public collection. */
+function noCollectionMessage(lookup) {
+    return `No collection with ${lookup.kind} ${String(lookup.value)}.`;
+}
+function publicCollectionListOptions(input) {
+    const options = (0, list_helpers_1.listOptions)({ limit: input.limit, offset: input.offset });
+    return Object.assign(Object.assign({}, options), { sort: { position: generated_types_1.SortOrder.ASC, id: generated_types_1.SortOrder.ASC }, filter: {
+            isPrivate: { eq: false },
+        } });
+}
+//# sourceMappingURL=collection-lookup.js.map

package/lib/tools/built-in/shop/collection-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-lookup.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/collection-lookup.ts"],"names":[],"mappings":";;AAcA,4CAQC;AAGD,oDAWC;AAGD,kDAEC;AAED,kEASC;AApDD,yEAAgE;AAUhE,kDAA8D;AAI9D,SAAgB,gBAAgB,CAAC,EAAkB,EAAE,IAAwB;IACzE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,kFAAkF;AAC3E,KAAK,UAAU,oBAAoB,CACtC,iBAAoC,EACpC,GAAmB,EACnB,MAAwB,EACxB,YAAuC,EAAE;IAEzC,MAAM,UAAU,GACZ,MAAM,CAAC,IAAI,KAAK,IAAI;QAChB,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC;QAC/D,CAAC,CAAC,MAAM,iBAAiB,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9E,OAAO,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAED,uFAAuF;AACvF,SAAgB,mBAAmB,CAAC,MAAwB;IACxD,OAAO,sBAAsB,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AACxE,CAAC;AAED,SAAgB,2BAA2B,CAAC,KAAgB;IACxD,MAAM,OAAO,GAAG,IAAA,0BAAW,EAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,uCACO,OAAO,KACV,IAAI,EAAE,EAAE,QAAQ,EAAE,2BAAS,CAAC,GAAG,EAAE,EAAE,EAAE,2BAAS,CAAC,GAAG,EAAE,EACpD,MAAM,EAAE;YACJ,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;SAC3B,IACH;AACN,CAAC"}

package/lib/tools/built-in/shop/get-cart.tool.d.ts

@@ -0,0 +1,94 @@
+import { RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpToolSerializerService } from '../serializer.service';
+export declare class GetCartTool implements McpToolHandler<Record<string, never>> {
+    private readonly activeOrder;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext): Promise<{
+        order: null;
+        message: string;
+    } | {
+        order: {
+            id: import("@vendure/core").ID;
+            code: string;
+            state: import("@vendure/core").OrderState;
+            active: boolean;
+            total: number;
+            totalDecimal: string;
+            totalWithTax: number;
+            totalWithTaxDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            totalQuantity: number;
+            createdAt: string | null;
+            updatedAt: string | null;
+            orderPlacedAt: string | null;
+            couponCodes: string[];
+            discounts: {
+                adjustmentSource: string;
+                type: import("@vendure/core").AdjustmentType;
+                description: string;
+                amount: number;
+                amountDecimal: string;
+                amountWithTax: number;
+                amountWithTaxDecimal: string;
+            }[];
+            lines: {
+                id: import("@vendure/core").ID;
+                quantity: number;
+                linePriceWithTax: number;
+                linePriceWithTaxDecimal: string;
+                productVariant: {
+                    id: import("@vendure/core").ID;
+                    name: import("@vendure/core").LocaleString;
+                    sku: string;
+                } | null;
+            }[];
+            payments: {
+                id: import("@vendure/core").ID;
+                method: string;
+                amount: number;
+                amountDecimal: string;
+                state: import("@vendure/core").PaymentState;
+                transactionId: string;
+                errorMessage: string | undefined;
+                publicMetadata: any;
+                refunds: {
+                    id: import("@vendure/core").ID;
+                    state: import("@vendure/core").RefundState;
+                    total: number;
+                    totalDecimal: string;
+                    reason: string;
+                }[];
+            }[] | undefined;
+            fulfillments: {
+                id: import("@vendure/core").ID;
+                state: import("@vendure/core").FulfillmentState;
+                method: string;
+                trackingCode: string;
+                lines: {
+                    orderLineId: import("@vendure/core").ID;
+                    quantity: number;
+                }[];
+            }[] | undefined;
+            customer: {
+                id: import("@vendure/core").ID;
+                emailAddress: string;
+                firstName: string;
+                lastName: string;
+            } | null | undefined;
+            shippingAddress: Record<string, string> | null;
+            billingAddress: Record<string, string> | null;
+            shippingWithTax: number;
+            shippingWithTaxDecimal: string;
+            shippingLines: {
+                id: import("@vendure/core").ID;
+                shippingMethodId: import("@vendure/core").ID | null;
+                priceWithTax: number;
+                priceWithTaxDecimal: string;
+            }[] | undefined;
+        } | null;
+        message?: undefined;
+    }>;
+}

package/lib/tools/built-in/shop/get-cart.tool.js

@@ -0,0 +1,55 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCartTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const active_order_service_1 = require("../active-order.service");
+const serializer_service_1 = require("../serializer.service");
+const getCartInput = zod_1.z.strictObject({});
+let GetCartTool = class GetCartTool {
+    constructor(activeOrder, serializer) {
+        this.activeOrder = activeOrder;
+        this.serializer = serializer;
+    }
+    async execute(ctx) {
+        const order = await this.activeOrder.findOrderWithLines(ctx);
+        if (!order)
+            return { order: null, message: active_order_service_1.NO_CART_MESSAGE };
+        return { order: this.serializer.order(order) };
+    }
+};
+exports.GetCartTool = GetCartTool;
+exports.GetCartTool = GetCartTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_cart',
+        toolset: 'shop',
+        description: 'Get the active cart. Pass the sessionToken from earlier cart responses to see that cart.',
+        keywords: [
+            "what's in my basket",
+            'show my shopping bag',
+            "view what I'm buying",
+            'my current order so far',
+            'see my cart contents',
+            'how much is in my basket',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        usesActiveOrder: true,
+        inputSchema: getCartInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        serializer_service_1.McpToolSerializerService])
+], GetCartTool);
+//# sourceMappingURL=get-cart.tool.js.map

package/lib/tools/built-in/shop/get-cart.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cart.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-cart.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA2D;AAC3D,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAiF;AACjF,8DAAiE;AAEjE,MAAM,YAAY,GAAG,OAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAoBjC,IAAM,WAAW,GAAjB,MAAM,WAAW;IACpB,YACqB,WAAkC,EAClC,UAAoC;QADpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,sCAAe,EAAE,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,CAAC;CACJ,CAAA;AAXY,kCAAW;sBAAX,WAAW;IAlBvB,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,0FAA0F;QACvG,QAAQ,EAAE;YACN,qBAAqB;YACrB,sBAAsB;YACtB,sBAAsB;YACtB,yBAAyB;YACzB,sBAAsB;YACtB,0BAA0B;SAC7B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,YAAY;KAC5B,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACtB,6CAAwB;GAHhD,WAAW,CAWvB"}

package/lib/tools/built-in/shop/get-collection.tool.d.ts

@@ -0,0 +1,42 @@
+import { CollectionService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const getCollectionInput: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type GetCollectionInput = z.infer<typeof getCollectionInput>;
+export declare class ShopGetCollectionTool implements McpToolHandler<GetCollectionInput> {
+    private readonly collectionService;
+    private readonly serializer;
+    constructor(collectionService: CollectionService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: GetCollectionInput): Promise<{
+        collection: null;
+        message: string;
+    } | {
+        collection: {
+            id: import("@vendure/core").ID;
+            name: import("@vendure/core").LocaleString;
+            slug: import("@vendure/core").LocaleString;
+            description: import("@vendure/core").LocaleString;
+            featuredAsset: {
+                id: import("@vendure/core").ID;
+                name: import("@vendure/core").LocaleString;
+                type: import("@vendure/core").AssetType;
+                mimeType: string;
+                width: number;
+                height: number;
+                fileSize: number;
+                source: string;
+                preview: string;
+                focalPoint: {
+                    x: number;
+                    y: number;
+                } | undefined;
+            } | null;
+        } | null;
+        message?: undefined;
+    }>;
+}
+export {};

package/lib/tools/built-in/shop/get-collection.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopGetCollectionTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const id_schema_1 = require("../id-schema");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const collection_lookup_1 = require("./collection-lookup");
+const getCollectionInput = zod_1.z.strictObject({
+    id: id_schema_1.idSchema.describe('Collection ID.').optional(),
+    slug: string_schemas_1.shortText.describe('Collection slug, used when ID is omitted.').optional(),
+});
+let ShopGetCollectionTool = class ShopGetCollectionTool {
+    constructor(collectionService, serializer) {
+        this.collectionService = collectionService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const lookup = (0, collection_lookup_1.collectionLookup)(input.id, input.slug);
+        if (!lookup) {
+            return { collection: null, message: 'Pass id or slug.' };
+        }
+        const collection = await (0, collection_lookup_1.findPublicCollection)(this.collectionService, ctx, lookup, ['featuredAsset']);
+        if (!collection) {
+            return { collection: null, message: (0, collection_lookup_1.noCollectionMessage)(lookup) };
+        }
+        return { collection: this.serializer.collection(collection) };
+    }
+};
+exports.ShopGetCollectionTool = ShopGetCollectionTool;
+exports.ShopGetCollectionTool = ShopGetCollectionTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_collection',
+        toolset: 'shop',
+        description: 'Get a public collection by ID or slug.',
+        keywords: [
+            'show me this category',
+            'open a product group',
+            'browse this department',
+            'view a category page',
+            'details of a collection',
+            "what's in this category",
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        inputSchema: getCollectionInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CollectionService,
+        serializer_service_1.McpToolSerializerService])
+], ShopGetCollectionTool);
+//# sourceMappingURL=get-collection.tool.js.map

package/lib/tools/built-in/shop/get-collection.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-collection.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-collection.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA8E;AAC9E,8CAA2D;AAC3D,6BAAwB;AAExB,4CAAwC;AACxC,8DAAiE;AACjE,sDAA8C;AAE9C,2DAAkG;AAElG,MAAM,kBAAkB,GAAG,OAAC,CAAC,YAAY,CAAC;IACtC,EAAE,EAAE,oBAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAClD,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC,QAAQ,EAAE;CACnF,CAAC,CAAC;AAqBI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAC9B,YACqB,iBAAoC,EACpC,UAAoC;QADpC,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAyB;QACxD,MAAM,MAAM,GAAG,IAAA,oCAAgB,EAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAC7D,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,IAAA,wCAAoB,EAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QACtG,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAA,uCAAmB,EAAC,MAAM,CAAC,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;IAClE,CAAC;CACJ,CAAA;AAjBY,sDAAqB;gCAArB,qBAAqB;IAjBjC,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE;YACN,uBAAuB;YACvB,sBAAsB;YACtB,wBAAwB;YACxB,sBAAsB;YACtB,yBAAyB;YACzB,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,kBAAkB;KAClC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG+B,wBAAiB;QACxB,6CAAwB;GAHhD,qBAAqB,CAiBjC"}

package/lib/tools/built-in/shop/get-eligible-payment-methods.tool.d.ts

@@ -0,0 +1,26 @@
+import { OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpToolSerializerService } from '../serializer.service';
+export declare class GetEligiblePaymentMethodsTool implements McpToolHandler<Record<string, never>> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext): Promise<{
+        methods: never[];
+        message: string;
+    } | {
+        methods: {
+            customFields: Record<string, unknown> | null | undefined;
+            __typename?: "PaymentMethodQuote";
+            code: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+            description: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+            eligibilityMessage?: import("@vendure/common/lib/generated-types").Maybe<import("@vendure/common/lib/generated-types").Scalars["String"]["output"]>;
+            id: import("@vendure/common/lib/generated-types").Scalars["ID"]["output"];
+            isEligible: import("@vendure/common/lib/generated-types").Scalars["Boolean"]["output"];
+            name: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+        }[];
+        message?: undefined;
+    }>;
+}

package/lib/tools/built-in/shop/get-eligible-payment-methods.tool.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetEligiblePaymentMethodsTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const active_order_service_1 = require("../active-order.service");
+const serializer_service_1 = require("../serializer.service");
+const getEligiblePaymentMethodsInput = zod_1.z.strictObject({});
+let GetEligiblePaymentMethodsTool = class GetEligiblePaymentMethodsTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx) {
+        const order = await this.activeOrder.find(ctx);
+        if (!order)
+            return { methods: [], message: active_order_service_1.NO_CART_MESSAGE };
+        const quotes = await this.orderService.getEligiblePaymentMethods(order.ctx, order.id);
+        return { methods: quotes.map(quote => this.serializer.paymentQuote(quote)) };
+    }
+};
+exports.GetEligiblePaymentMethodsTool = GetEligiblePaymentMethodsTool;
+exports.GetEligiblePaymentMethodsTool = GetEligiblePaymentMethodsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_eligible_payment_methods',
+        toolset: 'shop',
+        description: 'List payment methods eligible for the active cart.',
+        keywords: [
+            'how can I pay',
+            'what payment options do you take',
+            'ways to pay for my order',
+            'do you accept card or paypal',
+            'available payment choices',
+            'which payment types are allowed',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        usesActiveOrder: true,
+        inputSchema: getEligiblePaymentMethodsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], GetEligiblePaymentMethodsTool);
+//# sourceMappingURL=get-eligible-payment-methods.tool.js.map

package/lib/tools/built-in/shop/get-eligible-payment-methods.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-eligible-payment-methods.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-eligible-payment-methods.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAyE;AACzE,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAiF;AACjF,8DAAiE;AAEjE,MAAM,8BAA8B,GAAG,OAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAoBnD,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IACtC,YACqB,WAAkC,EAClC,YAA0B,EAC1B,UAAoC;QAFpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,sCAAe,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,yBAAyB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC;CACJ,CAAA;AAbY,sEAA6B;wCAA7B,6BAA6B;IAlBzC,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE;YACN,eAAe;YACf,kCAAkC;YAClC,0BAA0B;YAC1B,8BAA8B;YAC9B,2BAA2B;YAC3B,iCAAiC;SACpC;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,8BAA8B;KAC9C,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,6BAA6B,CAazC"}

package/lib/tools/built-in/shop/get-eligible-shipping-methods.tool.d.ts

@@ -0,0 +1,30 @@
+import { OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpToolSerializerService } from '../serializer.service';
+export declare class GetEligibleShippingMethodsTool implements McpToolHandler<Record<string, never>> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext): Promise<{
+        methods: never[];
+        message: string;
+    } | {
+        methods: {
+            customFields: Record<string, unknown> | null | undefined;
+            priceDecimal: string;
+            priceWithTaxDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            __typename?: "ShippingMethodQuote";
+            code: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+            description: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+            id: import("@vendure/common/lib/generated-types").Scalars["ID"]["output"];
+            metadata?: import("@vendure/common/lib/generated-types").Maybe<import("@vendure/common/lib/generated-types").Scalars["JSON"]["output"]>;
+            name: import("@vendure/common/lib/generated-types").Scalars["String"]["output"];
+            price: import("@vendure/common/lib/generated-types").Scalars["Money"]["output"];
+            priceWithTax: import("@vendure/common/lib/generated-types").Scalars["Money"]["output"];
+        }[];
+        message?: undefined;
+    }>;
+}

package/lib/tools/built-in/shop/get-eligible-shipping-methods.tool.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetEligibleShippingMethodsTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const active_order_service_1 = require("../active-order.service");
+const serializer_service_1 = require("../serializer.service");
+const getEligibleShippingMethodsInput = zod_1.z.strictObject({});
+let GetEligibleShippingMethodsTool = class GetEligibleShippingMethodsTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx) {
+        const order = await this.activeOrder.find(ctx);
+        if (!order)
+            return { methods: [], message: active_order_service_1.NO_CART_MESSAGE };
+        const quotes = await this.orderService.getEligibleShippingMethods(order.ctx, order.id);
+        // The currency comes from the order because a quote does not carry one.
+        return { methods: quotes.map(quote => this.serializer.shippingQuote(quote, order.currencyCode)) };
+    }
+};
+exports.GetEligibleShippingMethodsTool = GetEligibleShippingMethodsTool;
+exports.GetEligibleShippingMethodsTool = GetEligibleShippingMethodsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_eligible_shipping_methods',
+        toolset: 'shop',
+        description: 'List shipping methods eligible for the active cart.',
+        keywords: [
+            'delivery options',
+            'how will my order ship',
+            'available shipping choices',
+            'postage options for my basket',
+            'ways to get my order delivered',
+            'which couriers can I use',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        usesActiveOrder: true,
+        inputSchema: getEligibleShippingMethodsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], GetEligibleShippingMethodsTool);
+//# sourceMappingURL=get-eligible-shipping-methods.tool.js.map

package/lib/tools/built-in/shop/get-eligible-shipping-methods.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-eligible-shipping-methods.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-eligible-shipping-methods.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAyE;AACzE,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAiF;AACjF,8DAAiE;AAEjE,MAAM,+BAA+B,GAAG,OAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAoBpD,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;IACvC,YACqB,WAAkC,EAClC,YAA0B,EAC1B,UAAoC;QAFpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,sCAAe,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,0BAA0B,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACvF,wEAAwE;QACxE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;IACtG,CAAC;CACJ,CAAA;AAdY,wEAA8B;yCAA9B,8BAA8B;IAlB1C,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE;YACN,kBAAkB;YAClB,wBAAwB;YACxB,4BAA4B;YAC5B,+BAA+B;YAC/B,gCAAgC;YAChC,0BAA0B;SAC7B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,+BAA+B;KAC/C,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,8BAA8B,CAc1C"}

package/lib/tools/built-in/shop/get-my-account.tool.d.ts

@@ -0,0 +1,22 @@
+import { CustomerService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { McpToolSerializerService } from '../serializer.service';
+export declare class GetMyAccountTool implements McpToolHandler<Record<string, never>> {
+    private readonly customerService;
+    private readonly serializer;
+    constructor(customerService: CustomerService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext): Promise<{
+        customer: {
+            id: import("@vendure/core").ID;
+            firstName: string;
+            lastName: string;
+            emailAddress: string;
+            phoneNumber: string;
+            addresses: {
+                defaultShippingAddress: boolean;
+                defaultBillingAddress: boolean;
+                id: import("@vendure/core").ID;
+            }[] | undefined;
+        } | null;
+    }>;
+}