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

package/lib/tools/built-in/admin/create-product.tool.d.ts

@@ -0,0 +1,52 @@
+import { ProductService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpCustomFieldInputService } from '../custom-field-input.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const createProductInput: z.ZodObject<{
+    input: z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        facetValueIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        assetIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        featuredAssetId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        translations: z.ZodArray<z.ZodObject<{
+            languageCode: z.ZodEnum<typeof import("@vendure/core").LanguageCode>;
+            name: z.ZodOptional<z.ZodString>;
+            slug: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type CreateProductToolInput = z.infer<typeof createProductInput>;
+export declare class CreateProductTool implements McpToolHandler<CreateProductToolInput> {
+    private readonly productService;
+    private readonly customFieldInput;
+    private readonly serializer;
+    constructor(productService: ProductService, customFieldInput: McpCustomFieldInputService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: CreateProductToolInput): Promise<{
+        product: {
+            id: import("@vendure/core").ID;
+            name: import("@vendure/core").LocaleString;
+            slug: import("@vendure/core").LocaleString;
+            description: import("@vendure/core").LocaleString;
+            enabled: boolean;
+            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;
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/create-product.tool.js

@@ -0,0 +1,61 @@
+"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.CreateProductTool = 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 custom_field_input_service_1 = require("../custom-field-input.service");
+const serializer_service_1 = require("../serializer.service");
+const entity_field_schemas_1 = require("./entity-field-schemas");
+const translation_schemas_1 = require("./translation-schemas");
+const createProductInputSchema = entity_field_schemas_1.productFieldsSchema.extend({
+    translations: zod_1.z
+        .array(translation_schemas_1.productTranslationSchema)
+        .describe('Localized product content. At least one entry with a languageCode is required.'),
+});
+const createProductInput = zod_1.z.strictObject({ input: createProductInputSchema });
+let CreateProductTool = class CreateProductTool {
+    constructor(productService, customFieldInput, serializer) {
+        this.productService = productService;
+        this.customFieldInput = customFieldInput;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        await this.customFieldInput.assertWritable(ctx, 'Product', input.input.customFields);
+        return { product: this.serializer.product(await this.productService.create(ctx, input.input)) };
+    }
+};
+exports.CreateProductTool = CreateProductTool;
+exports.CreateProductTool = CreateProductTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'create_product',
+        toolset: 'admin',
+        description: 'Create a new product in the catalog, with its name, slug, description and enabled state.',
+        keywords: [
+            'add a new product',
+            'list a new item for sale',
+            'create a catalog entry',
+            'add product to the store',
+            'make a new listing',
+            'put a new item on sale',
+        ],
+        permissions: [core_1.Permission.CreateProduct],
+        behavior: 'mutating',
+        inputSchema: createProductInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ProductService,
+        custom_field_input_service_1.McpCustomFieldInputService,
+        serializer_service_1.McpToolSerializerService])
+], CreateProductTool);
+//# sourceMappingURL=create-product.tool.js.map

package/lib/tools/built-in/admin/create-product.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-product.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/create-product.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA2E;AAC3E,8CAA2D;AAC3D,6BAAwB;AAExB,8EAA2E;AAC3E,8DAAiE;AAEjE,iEAA6D;AAC7D,+DAAiE;AAEjE,MAAM,wBAAwB,GAAG,0CAAmB,CAAC,MAAM,CAAC;IACxD,YAAY,EAAE,OAAC;SACV,KAAK,CAAC,8CAAwB,CAAC;SAC/B,QAAQ,CAAC,gFAAgF,CAAC;CAClG,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,OAAC,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAqBxE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC1B,YACqB,cAA8B,EAC9B,gBAA4C,EAC5C,UAAoC;QAFpC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAA6B;QAC5D,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACrF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACpG,CAAC;CACJ,CAAA;AAXY,8CAAiB;4BAAjB,iBAAiB;IAjB7B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,0FAA0F;QACvG,QAAQ,EAAE;YACN,mBAAmB;YACnB,0BAA0B;YAC1B,wBAAwB;YACxB,0BAA0B;YAC1B,oBAAoB;YACpB,wBAAwB;SAC3B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,aAAa,CAAC;QACvC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,kBAAkB;KAClC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG4B,qBAAc;QACZ,uDAA0B;QAChC,6CAAwB;GAJhD,iBAAiB,CAW7B"}

package/lib/tools/built-in/admin/create-variant.tool.d.ts

@@ -0,0 +1,48 @@
+import { ProductService, ProductVariantService, RequestContext, StockLevelService } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpCustomFieldInputService } from '../custom-field-input.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const createVariantInput: z.ZodObject<{
+    productId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    input: z.ZodObject<{
+        price: z.ZodOptional<z.ZodNumber>;
+        optionIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        taxCategoryId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        featuredAssetId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        assetIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        trackInventory: z.ZodOptional<z.ZodEnum<typeof import("@vendure/common/lib/generated-types").GlobalFlag>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        sku: z.ZodString;
+        translations: z.ZodArray<z.ZodObject<{
+            languageCode: z.ZodEnum<typeof import("@vendure/core").LanguageCode>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        stockOnHand: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type CreateVariantToolInput = z.infer<typeof createVariantInput>;
+export declare class CreateVariantTool implements McpToolHandler<CreateVariantToolInput> {
+    private readonly productVariantService;
+    private readonly productService;
+    private readonly stockLevelService;
+    private readonly customFieldInput;
+    private readonly serializer;
+    constructor(productVariantService: ProductVariantService, productService: ProductService, stockLevelService: StockLevelService, customFieldInput: McpCustomFieldInputService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: CreateVariantToolInput): Promise<{
+        variant: {
+            stockOnHand: number;
+            id?: import("@vendure/core").ID | undefined;
+            name?: import("@vendure/core").LocaleString | undefined;
+            sku?: string | undefined;
+            enabled?: boolean | undefined;
+            price?: number | undefined;
+            priceDecimal?: string | undefined;
+            priceWithTax?: number | undefined;
+            priceWithTaxDecimal?: string | undefined;
+            currencyCode?: import("@vendure/core").CurrencyCode | undefined;
+        };
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/create-variant.tool.js

@@ -0,0 +1,79 @@
+"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.CreateVariantTool = 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 custom_field_input_service_1 = require("../custom-field-input.service");
+const id_schema_1 = require("../id-schema");
+const int32_schema_1 = require("../int32-schema");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const entity_field_schemas_1 = require("./entity-field-schemas");
+const translation_schemas_1 = require("./translation-schemas");
+const createVariantInputSchema = entity_field_schemas_1.variantFieldsSchema.extend({
+    sku: string_schemas_1.shortText.describe('Stock keeping unit.'),
+    translations: zod_1.z.array(translation_schemas_1.variantTranslationSchema).describe('Localized variant content.'),
+    stockOnHand: int32_schema_1.int32Schema.describe('Initial stock on hand.').optional(),
+});
+const createVariantInput = zod_1.z.strictObject({
+    productId: id_schema_1.idSchema.describe('Parent product ID.'),
+    input: createVariantInputSchema,
+});
+let CreateVariantTool = class CreateVariantTool {
+    constructor(productVariantService, productService, stockLevelService, customFieldInput, serializer) {
+        this.productVariantService = productVariantService;
+        this.productService = productService;
+        this.stockLevelService = stockLevelService;
+        this.customFieldInput = customFieldInput;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        await this.customFieldInput.assertWritable(ctx, 'ProductVariant', input.input.customFields);
+        const product = await this.productService.findOne(ctx, input.productId);
+        if (!product) {
+            throw new core_1.UserInputError(`Product ${input.productId} is not available in the active channel.`);
+        }
+        const [variant] = await this.productVariantService.create(ctx, [
+            Object.assign(Object.assign({}, input.input), { productId: input.productId }),
+        ]);
+        const { stockOnHand } = await this.stockLevelService.getAvailableStock(ctx, variant.id);
+        return { variant: this.serializer.adminVariant(variant, stockOnHand) };
+    }
+};
+exports.CreateVariantTool = CreateVariantTool;
+exports.CreateVariantTool = CreateVariantTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'create_variant',
+        toolset: 'admin',
+        description: 'Create a new variant of an existing product (e.g. a size or color option), with its SKU, price and stock.',
+        keywords: [
+            'add a size or color option',
+            'create a new sku',
+            'add a variant to a product',
+            'make another version of an item',
+            'new product option',
+            'add a variation',
+        ],
+        permissions: [core_1.Permission.UpdateProduct],
+        behavior: 'mutating',
+        inputSchema: createVariantInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ProductVariantService,
+        core_1.ProductService,
+        core_1.StockLevelService,
+        custom_field_input_service_1.McpCustomFieldInputService,
+        serializer_service_1.McpToolSerializerService])
+], CreateVariantTool);
+//# sourceMappingURL=create-variant.tool.js.map

package/lib/tools/built-in/admin/create-variant.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-variant.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/create-variant.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAOuB;AACvB,8CAA2D;AAC3D,6BAAwB;AAExB,8EAA2E;AAC3E,4CAAwC;AACxC,kDAA8C;AAC9C,8DAAiE;AACjE,sDAA8C;AAE9C,iEAA6D;AAC7D,+DAAiE;AAEjE,MAAM,wBAAwB,GAAG,0CAAmB,CAAC,MAAM,CAAC;IACxD,GAAG,EAAE,0BAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC9C,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,8CAAwB,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACtF,WAAW,EAAE,0BAAW,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,OAAC,CAAC,YAAY,CAAC;IACtC,SAAS,EAAE,oBAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAClD,KAAK,EAAE,wBAAwB;CAClC,CAAC,CAAC;AAsBI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC1B,YACqB,qBAA4C,EAC5C,cAA8B,EAC9B,iBAAoC,EACpC,gBAA4C,EAC5C,UAAoC;QAJpC,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,qBAAgB,GAAhB,gBAAgB,CAA4B;QAC5C,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAA6B;QAC5D,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,qBAAc,CAAC,WAAW,KAAK,CAAC,SAAS,0CAA0C,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE;4CACtD,KAAK,CAAC,KAAK,KAAE,SAAS,EAAE,KAAK,CAAC,SAAS;SAC/C,CAAC,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;IAC3E,CAAC;CACJ,CAAA;AArBY,8CAAiB;4BAAjB,iBAAiB;IAlB7B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;QAChB,WAAW,EACP,2GAA2G;QAC/G,QAAQ,EAAE;YACN,4BAA4B;YAC5B,kBAAkB;YAClB,4BAA4B;YAC5B,iCAAiC;YACjC,oBAAoB;YACpB,iBAAiB;SACpB;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,aAAa,CAAC;QACvC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,kBAAkB;KAClC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGmC,4BAAqB;QAC5B,qBAAc;QACX,wBAAiB;QAClB,uDAA0B;QAChC,6CAAwB;GANhD,iBAAiB,CAqB7B"}

package/lib/tools/built-in/admin/entity-field-schemas.d.ts

@@ -0,0 +1,36 @@
+import { GlobalFlag } from '@vendure/common/lib/generated-types';
+import { z } from 'zod';
+/**
+ * Fields shared by create_customer and update_customer. create uses them as is; update makes them all
+ * optional.
+ */
+export declare const customerFieldsSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    emailAddress: z.ZodString;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;
+/** Fields shared by create_product and update_product. Each tool adds its own `translations`. */
+export declare const productFieldsSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    facetValueIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    assetIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    featuredAssetId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;
+/**
+ * Fields shared by create_variant and update_variant. Each tool adds `sku` and `translations`; create
+ * also adds `stockOnHand`.
+ */
+export declare const variantFieldsSchema: z.ZodObject<{
+    price: z.ZodOptional<z.ZodNumber>;
+    optionIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    taxCategoryId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    featuredAssetId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    assetIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    trackInventory: z.ZodOptional<z.ZodEnum<typeof GlobalFlag>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;

package/lib/tools/built-in/admin/entity-field-schemas.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.variantFieldsSchema = exports.productFieldsSchema = exports.customerFieldsSchema = void 0;
+const generated_types_1 = require("@vendure/common/lib/generated-types");
+const zod_1 = require("zod");
+const email_schema_1 = require("../email-schema");
+const id_schema_1 = require("../id-schema");
+const int32_schema_1 = require("../int32-schema");
+const string_schemas_1 = require("../string-schemas");
+/**
+ * Fields shared by create_customer and update_customer. create uses them as is; update makes them all
+ * optional.
+ */
+exports.customerFieldsSchema = zod_1.z.strictObject({
+    firstName: string_schemas_1.shortText.describe('Customer first name.'),
+    lastName: string_schemas_1.shortText.describe('Customer last name.'),
+    emailAddress: email_schema_1.emailAddressSchema,
+    phoneNumber: string_schemas_1.shortText.describe('Customer phone number.').optional(),
+    title: string_schemas_1.shortText.describe('Customer title, e.g. "Mr" or "Ms".').optional(),
+    customFields: zod_1.z.looseObject({}).describe('Customer custom fields.').optional(),
+});
+/** Fields shared by create_product and update_product. Each tool adds its own `translations`. */
+exports.productFieldsSchema = zod_1.z.strictObject({
+    enabled: zod_1.z.boolean().describe('Whether the product is enabled.').optional(),
+    facetValueIds: zod_1.z
+        .array(id_schema_1.idSchema.describe('Vendure ID.'))
+        .max(id_schema_1.MAX_ID_LIST_LENGTH)
+        .describe('Facet value IDs to assign.')
+        .optional(),
+    assetIds: zod_1.z
+        .array(id_schema_1.idSchema.describe('Vendure ID.'))
+        .max(id_schema_1.MAX_ID_LIST_LENGTH)
+        .describe('Asset IDs to attach.')
+        .optional(),
+    featuredAssetId: id_schema_1.idSchema.describe('Featured asset ID.').optional(),
+    customFields: zod_1.z.looseObject({}).describe('Product custom fields.').optional(),
+});
+/**
+ * Fields shared by create_variant and update_variant. Each tool adds `sku` and `translations`; create
+ * also adds `stockOnHand`.
+ */
+exports.variantFieldsSchema = zod_1.z.strictObject({
+    price: int32_schema_1.int32Schema.min(0).describe('Price as a whole number of minor units, e.g. cents.').optional(),
+    optionIds: zod_1.z
+        .array(id_schema_1.idSchema.describe('Vendure ID.'))
+        .max(id_schema_1.MAX_ID_LIST_LENGTH)
+        .describe('Product option IDs for this variant.')
+        .optional(),
+    taxCategoryId: id_schema_1.idSchema.describe('Tax category ID.').optional(),
+    featuredAssetId: id_schema_1.idSchema.describe('Featured asset ID.').optional(),
+    assetIds: zod_1.z
+        .array(id_schema_1.idSchema.describe('Vendure ID.'))
+        .max(id_schema_1.MAX_ID_LIST_LENGTH)
+        .describe('Asset IDs to attach.')
+        .optional(),
+    trackInventory: zod_1.z
+        .enum(generated_types_1.GlobalFlag)
+        .describe('Inventory tracking: "TRUE", "FALSE", or "INHERIT".')
+        .optional(),
+    enabled: zod_1.z.boolean().describe('Whether the variant is enabled.').optional(),
+    customFields: zod_1.z.looseObject({}).describe('Variant custom fields.').optional(),
+});
+//# sourceMappingURL=entity-field-schemas.js.map

package/lib/tools/built-in/admin/entity-field-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-field-schemas.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/entity-field-schemas.ts"],"names":[],"mappings":";;;AAAA,yEAAiE;AACjE,6BAAwB;AAExB,kDAAqD;AACrD,4CAA4D;AAC5D,kDAA8C;AAC9C,sDAA8C;AAE9C;;;GAGG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC/C,SAAS,EAAE,0BAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACrD,QAAQ,EAAE,0BAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACnD,YAAY,EAAE,iCAAkB;IAChC,WAAW,EAAE,0BAAS,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACpE,KAAK,EAAE,0BAAS,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,QAAQ,EAAE;IAC1E,YAAY,EAAE,OAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;CACjF,CAAC,CAAC;AAEH,iGAAiG;AACpF,QAAA,mBAAmB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC9C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC3E,aAAa,EAAE,OAAC;SACX,KAAK,CAAC,oBAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;SACvC,GAAG,CAAC,8BAAkB,CAAC;SACvB,QAAQ,CAAC,4BAA4B,CAAC;SACtC,QAAQ,EAAE;IACf,QAAQ,EAAE,OAAC;SACN,KAAK,CAAC,oBAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;SACvC,GAAG,CAAC,8BAAkB,CAAC;SACvB,QAAQ,CAAC,sBAAsB,CAAC;SAChC,QAAQ,EAAE;IACf,eAAe,EAAE,oBAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACnE,YAAY,EAAE,OAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;CAChF,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC9C,KAAK,EAAE,0BAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC,CAAC,QAAQ,EAAE;IACpG,SAAS,EAAE,OAAC;SACP,KAAK,CAAC,oBAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;SACvC,GAAG,CAAC,8BAAkB,CAAC;SACvB,QAAQ,CAAC,sCAAsC,CAAC;SAChD,QAAQ,EAAE;IACf,aAAa,EAAE,oBAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAC/D,eAAe,EAAE,oBAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACnE,QAAQ,EAAE,OAAC;SACN,KAAK,CAAC,oBAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;SACvC,GAAG,CAAC,8BAAkB,CAAC;SACvB,QAAQ,CAAC,sBAAsB,CAAC;SAChC,QAAQ,EAAE;IACf,cAAc,EAAE,OAAC;SACZ,IAAI,CAAC,4BAAU,CAAC;SAChB,QAAQ,CAAC,oDAAoD,CAAC;SAC9D,QAAQ,EAAE;IACf,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC3E,YAAY,EAAE,OAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;CAChF,CAAC,CAAC"}

package/lib/tools/built-in/admin/get-customer.tool.d.ts

@@ -0,0 +1,28 @@
+import { CustomerService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const getCustomerInput: z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strict>;
+type GetCustomerInput = z.infer<typeof getCustomerInput>;
+export declare class GetCustomerTool implements McpToolHandler<GetCustomerInput> {
+    private readonly customerService;
+    private readonly serializer;
+    constructor(customerService: CustomerService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: GetCustomerInput): 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;
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/get-customer.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.GetCustomerTool = 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 getCustomerInput = zod_1.z.strictObject({
+    id: id_schema_1.idSchema.describe('Customer ID.'),
+});
+let GetCustomerTool = class GetCustomerTool {
+    constructor(customerService, serializer) {
+        this.customerService = customerService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        return {
+            customer: this.serializer.customer(await this.customerService.findOne(ctx, input.id, ['user'])),
+        };
+    }
+};
+exports.GetCustomerTool = GetCustomerTool;
+exports.GetCustomerTool = GetCustomerTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_customer',
+        toolset: 'admin',
+        description: 'Get a customer by id.',
+        keywords: [
+            'look up a customer record',
+            "view a client's profile",
+            'pull up customer details',
+            'find a buyer by id',
+            'inspect a customer account',
+            'open a single customer',
+        ],
+        permissions: [core_1.Permission.ReadCustomer],
+        behavior: 'readonly',
+        inputSchema: getCustomerInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CustomerService,
+        serializer_service_1.McpToolSerializerService])
+], GetCustomerTool);
+//# sourceMappingURL=get-customer.tool.js.map

package/lib/tools/built-in/admin/get-customer.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-customer.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/get-customer.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA4E;AAC5E,8CAA2D;AAC3D,6BAAwB;AAExB,4CAAwC;AACxC,8DAAiE;AAEjE,MAAM,gBAAgB,GAAG,OAAC,CAAC,YAAY,CAAC;IACpC,EAAE,EAAE,oBAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;CACxC,CAAC,CAAC;AAqBI,IAAM,eAAe,GAArB,MAAM,eAAe;IACxB,YACqB,eAAgC,EAChC,UAAoC;QADpC,oBAAe,GAAf,eAAe,CAAiB;QAChC,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAuB;QACtD,OAAO;YACH,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;SAClG,CAAC;IACN,CAAC;CACJ,CAAA;AAXY,0CAAe;0BAAf,eAAe;IAjB3B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,uBAAuB;QACpC,QAAQ,EAAE;YACN,2BAA2B;YAC3B,yBAAyB;YACzB,0BAA0B;YAC1B,oBAAoB;YACpB,4BAA4B;YAC5B,wBAAwB;SAC3B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,YAAY,CAAC;QACtC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,gBAAgB;KAChC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG6B,sBAAe;QACpB,6CAAwB;GAHhD,eAAe,CAW3B"}

package/lib/tools/built-in/admin/get-order.tool.d.ts

@@ -0,0 +1,100 @@
+import { OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const getOrderInput: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type GetOrderInput = z.infer<typeof getOrderInput>;
+export declare class AdminGetOrderTool implements McpToolHandler<GetOrderInput> {
+    private readonly orderService;
+    private readonly serializer;
+    constructor(orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: GetOrderInput): Promise<{
+        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;
+    } | {
+        order: null;
+        message: string;
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/get-order.tool.js

@@ -0,0 +1,68 @@
+"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.AdminGetOrderTool = 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 order_list_helpers_1 = require("../order-list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const getOrderInput = zod_1.z
+    .strictObject({
+    id: id_schema_1.idSchema.describe('Order ID. Pass this or code, not both.').optional(),
+    code: string_schemas_1.shortText.describe('Order code, used when ID is omitted.').optional(),
+})
+    .refine(input => (input.id != null) !== (input.code != null), {
+    message: 'Pass exactly one of id or code.',
+});
+// Named distinctly from the shop version so stack traces and symbol search aren't ambiguous.
+let AdminGetOrderTool = class AdminGetOrderTool {
+    constructor(orderService, serializer) {
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const lookup = input.id != null ? `id ${String(input.id)}` : `code ${String(input.code)}`;
+        const order = input.id != null
+            ? await this.orderService.findOne(ctx, input.id, order_list_helpers_1.ORDER_DETAIL_RELATIONS)
+            : await this.orderService.findOneByCode(ctx, input.code, order_list_helpers_1.ORDER_DETAIL_RELATIONS);
+        if (order) {
+            return { order: this.serializer.order(order) };
+        }
+        return { order: null, message: `No order with ${lookup}` };
+    }
+};
+exports.AdminGetOrderTool = AdminGetOrderTool;
+exports.AdminGetOrderTool = AdminGetOrderTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_order',
+        toolset: 'admin',
+        description: 'Get an order by ID or code, with its lines, customer and payments.',
+        keywords: [
+            'look up an order in the back office',
+            'pull up order details for support',
+            'inspect a single order',
+            'open an order record by id or code',
+            'view an order as staff',
+            'fetch order info for operations',
+        ],
+        permissions: [core_1.Permission.ReadOrder],
+        behavior: 'readonly',
+        inputSchema: getOrderInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], AdminGetOrderTool);
+//# sourceMappingURL=get-order.tool.js.map

package/lib/tools/built-in/admin/get-order.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-order.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/get-order.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAyE;AACzE,8CAA2D;AAC3D,6BAAwB;AAExB,4CAAwC;AACxC,8DAA+D;AAC/D,8DAAiE;AACjE,sDAA8C;AAE9C,MAAM,aAAa,GAAG,OAAC;KAClB,YAAY,CAAC;IACV,EAAE,EAAE,oBAAQ,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC,QAAQ,EAAE;IAC1E,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC,QAAQ,EAAE;CAC9E,CAAC;KACD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE;IAC1D,OAAO,EAAE,iCAAiC;CAC7C,CAAC,CAAC;AAIP,6FAA6F;AAkBtF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC1B,YACqB,YAA0B,EAC1B,UAAoC;QADpC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAoB;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,MAAM,KAAK,GACP,KAAK,CAAC,EAAE,IAAI,IAAI;YACZ,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,2CAAsB,CAAC;YACxE,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,IAAc,EAAE,2CAAsB,CAAC,CAAC;QACnG,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,MAAM,EAAE,EAAE,CAAC;IAC/D,CAAC;CACJ,CAAA;AAjBY,8CAAiB;4BAAjB,iBAAiB;IAjB7B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE;YACN,qCAAqC;YACrC,mCAAmC;YACnC,wBAAwB;YACxB,oCAAoC;YACpC,wBAAwB;YACxB,iCAAiC;SACpC;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,SAAS,CAAC;QACnC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,aAAa;KAC7B,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG0B,mBAAY;QACd,6CAAwB;GAHhD,iBAAiB,CAiB7B"}