@unchainedshop/api 5.0.0-alpha.2 → 5.0.0-alpha.3

package/lib/mcp/resources/localization.d.ts

@@ -1,3 +1,7 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../context.ts';
+export declare function getShopLanguagesText(context: Context): Promise<string>;
+export declare function getShopCurrenciesText(context: Context): Promise<string>;
+export declare function getShopCountriesText(context: Context): Promise<string>;
+export declare function buildChatResourceContext(context: Context | undefined): Promise<string>;
 export declare const registerLocalizationResources: (server: McpServer, context: Context) => void;

package/lib/mcp/resources/localization.js

@@ -1,77 +1,101 @@
+import { createLogger } from '@unchainedshop/logger';
+const logger = createLogger('unchained:api:mcp');
+export async function getShopLanguagesText(context) {
+    const [languages, countries] = await Promise.all([
+        context.modules.languages.findLanguages({ includeInactive: false }),
+        context.modules.countries.findCountries({ includeInactive: false }),
+    ]);
+    const baseLanguageCodes = languages.map((l) => l.isoCode.toLowerCase());
+    const availableCountryCodes = countries.map((c) => c.isoCode.toUpperCase());
+    return JSON.stringify({
+        baseLanguages: languages.map((l) => ({
+            isoCode: l.isoCode,
+            name: l.isoCode,
+            isActive: l.isActive,
+        })),
+        availableCountries: availableCountryCodes,
+        localeFormat: 'Use base language codes (e.g., "en", "fr", "de") or language-country combinations (e.g., "en-US", "fr-CH") following BCP 47 format',
+        validationRule: `Any combination of base languages [${baseLanguageCodes.join(', ')}] with available countries [${availableCountryCodes.join(', ')}] is acceptable for locale codes, as long as it makes contextual sense (e.g., "en-US" , "de-CH" , but "ja-DE" would be unusual)`,
+        note: 'If a required base language is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
+    }, null, 2);
+}
+export async function getShopCurrenciesText(context) {
+    const currencies = await context.modules.currencies.findCurrencies({ includeInactive: false });
+    return JSON.stringify({
+        currencies: currencies.map((c) => ({
+            isoCode: c.isoCode,
+            name: c.isoCode,
+            isActive: c.isActive,
+            decimals: c.decimals,
+        })),
+        note: 'If a required currency is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
+    }, null, 2);
+}
+export async function getShopCountriesText(context) {
+    const countries = await context.modules.countries.findCountries({ includeInactive: false });
+    return JSON.stringify({
+        countries: countries.map((c) => ({
+            isoCode: c.isoCode,
+            name: c.isoCode,
+            isActive: c.isActive,
+        })),
+        note: 'If a required country is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
+    }, null, 2);
+}
+export async function buildChatResourceContext(context) {
+    if (!context?.user?.roles?.includes('admin'))
+        return '';
+    const sections = await Promise.all([
+        ['shop-languages', getShopLanguagesText],
+        ['shop-currencies', getShopCurrenciesText],
+        ['shop-countries', getShopCountriesText],
+    ].map(async ([name, getText]) => {
+        try {
+            return `${name}:\n${await getText(context)}`;
+        }
+        catch (error) {
+            logger.error(`Failed to read resource ${name}: ${error.message}`);
+            return null;
+        }
+    }));
+    const body = sections.filter(Boolean).join('\n\n');
+    return body ? `\n\nAVAILABLE SHOP CONFIGURATION:\n${body}` : '';
+}
 export const registerLocalizationResources = (server, context) => {
-    server.resource('shop-languages', 'unchained://shop/languages', {
+    server.registerResource('shop-languages', 'unchained://shop/languages', {
         description: 'Available languages configured in the shop. Use these ISO codes when creating or updating products, filters, and assortments. Includes valid language-country dialect combinations.',
         mimeType: 'application/json',
-    }, async () => {
-        const [languages, countries] = await Promise.all([
-            context.modules.languages.findLanguages({ includeInactive: false }),
-            context.modules.countries.findCountries({ includeInactive: false }),
-        ]);
-        const baseLanguageCodes = languages.map((l) => l.isoCode.toLowerCase());
-        const availableCountryCodes = countries.map((c) => c.isoCode.toUpperCase());
-        return {
-            contents: [
-                {
-                    uri: 'unchained://shop/languages',
-                    mimeType: 'application/json',
-                    text: JSON.stringify({
-                        baseLanguages: languages.map((l) => ({
-                            isoCode: l.isoCode,
-                            name: l.isoCode,
-                            isActive: l.isActive,
-                        })),
-                        availableCountries: availableCountryCodes,
-                        localeFormat: 'Use base language codes (e.g., "en", "fr", "de") or language-country combinations (e.g., "en-US", "fr-CH") following BCP 47 format',
-                        validationRule: `Any combination of base languages [${baseLanguageCodes.join(', ')}] with available countries [${availableCountryCodes.join(', ')}] is acceptable for locale codes, as long as it makes contextual sense (e.g., "en-US" , "de-CH" , but "ja-DE" would be unusual)`,
-                        note: 'If a required base language is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
-                    }, null, 2),
-                },
-            ],
-        };
-    });
-    server.resource('shop-currencies', 'unchained://shop/currencies', {
+    }, async () => ({
+        contents: [
+            {
+                uri: 'unchained://shop/languages',
+                mimeType: 'application/json',
+                text: await getShopLanguagesText(context),
+            },
+        ],
+    }));
+    server.registerResource('shop-currencies', 'unchained://shop/currencies', {
         description: 'Available currencies configured in the shop. Check decimal points for price conversions. All prices are stored as integers.',
         mimeType: 'application/json',
-    }, async () => {
-        const currencies = await context.modules.currencies.findCurrencies({ includeInactive: false });
-        return {
-            contents: [
-                {
-                    uri: 'unchained://shop/currencies',
-                    mimeType: 'application/json',
-                    text: JSON.stringify({
-                        currencies: currencies.map((c) => ({
-                            isoCode: c.isoCode,
-                            name: c.isoCode,
-                            isActive: c.isActive,
-                            decimals: c.decimals,
-                        })),
-                        note: 'If a required currency is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
-                    }, null, 2),
-                },
-            ],
-        };
-    });
-    server.resource('shop-countries', 'unchained://shop/countries', {
+    }, async () => ({
+        contents: [
+            {
+                uri: 'unchained://shop/currencies',
+                mimeType: 'application/json',
+                text: await getShopCurrenciesText(context),
+            },
+        ],
+    }));
+    server.registerResource('shop-countries', 'unchained://shop/countries', {
         description: 'Available countries configured in the shop. Use these ISO codes for geographic operations.',
         mimeType: 'application/json',
-    }, async () => {
-        const countries = await context.modules.countries.findCountries({ includeInactive: false });
-        return {
-            contents: [
-                {
-                    uri: 'unchained://shop/countries',
-                    mimeType: 'application/json',
-                    text: JSON.stringify({
-                        countries: countries.map((c) => ({
-                            isoCode: c.isoCode,
-                            name: c.isoCode,
-                            isActive: c.isActive,
-                        })),
-                        note: 'If a required country is missing, ask the user if they want to add it using localization_management tool with action: CREATE',
-                    }, null, 2),
-                },
-            ],
-        };
-    });
+    }, async () => ({
+        contents: [
+            {
+                uri: 'unchained://shop/countries',
+                mimeType: 'application/json',
+                text: await getShopCountriesText(context),
+            },
+        ],
+    }));
 };

package/lib/mcp/tools/assortment/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerAssortmentTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/assortment/index.js

@@ -1,4 +1,7 @@
 import { assortmentManagement, AssortmentManagementSchema } from "./assortmentManagement.js";
 export const registerAssortmentTools = (server, context) => {
-    server.tool('assortment_management', 'Unified assortment management system with comprehensive action-based operations: CREATE/UPDATE/REMOVE/GET/LIST/COUNT assortments, UPDATE_STATUS (activate/deactivate), ADD_MEDIA/REMOVE_MEDIA/REORDER_MEDIA/GET_MEDIA/UPDATE_MEDIA_TEXTS, ADD_PRODUCT/REMOVE_PRODUCT/GET_PRODUCTS/REORDER_PRODUCTS, ADD_FILTER/REMOVE_FILTER/GET_FILTERS/REORDER_FILTERS, ADD_LINK/REMOVE_LINK/GET_LINKS/REORDER_LINKS, GET_CHILDREN/SET_BASE, SEARCH_PRODUCTS, GET_TEXTS/GET_MEDIA_TEXTS. Supports comprehensive assortment management with type-specific validations and error handling.', AssortmentManagementSchema, async (params) => assortmentManagement(context, params));
+    server.registerTool('assortment_management', {
+        description: 'Unified assortment management system with comprehensive action-based operations: CREATE/UPDATE/REMOVE/GET/LIST/COUNT assortments, UPDATE_STATUS (activate/deactivate), ADD_MEDIA/REMOVE_MEDIA/REORDER_MEDIA/GET_MEDIA/UPDATE_MEDIA_TEXTS, ADD_PRODUCT/REMOVE_PRODUCT/GET_PRODUCTS/REORDER_PRODUCTS, ADD_FILTER/REMOVE_FILTER/GET_FILTERS/REORDER_FILTERS, ADD_LINK/REMOVE_LINK/GET_LINKS/REORDER_LINKS, GET_CHILDREN/SET_BASE, SEARCH_PRODUCTS, GET_TEXTS/GET_MEDIA_TEXTS. Supports comprehensive assortment management with type-specific validations and error handling.',
+        inputSchema: AssortmentManagementSchema,
+    }, async (params) => assortmentManagement(context, params));
 };

package/lib/mcp/tools/assortment/schemas.d.ts

@@ -193,11 +193,11 @@ export declare const AssortmentManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         GET_TEXTS: "GET_TEXTS";
         UPDATE_STATUS: "UPDATE_STATUS";
@@ -285,11 +285,11 @@ export declare const AssortmentManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         GET_TEXTS: "GET_TEXTS";
         UPDATE_STATUS: "UPDATE_STATUS";

package/lib/mcp/tools/filter/handlers/createFilter.js

@@ -1,16 +1,14 @@
-import { FilterDirector } from '@unchainedshop/core';
 import { getNormalizedFilterDetails } from "../../../utils/getNormalizedFilterDetails.js";
 export default async function createFilter(context, params) {
-    const { modules } = context;
+    const { modules, services } = context;
     const { filter, texts } = params;
     const { key, type, options = [] } = filter;
-    const newFilter = await modules.filters.create({
+    const newFilter = await services.filters.createFilter({
         key,
         type,
         options,
         isActive: true,
     });
-    await FilterDirector.invalidateProductIdCache(newFilter, context);
     if (texts && texts.length > 0) {
         await modules.filters.texts.updateTexts({ filterId: newFilter._id }, texts);
     }

package/lib/mcp/tools/filter/handlers/createFilterOption.js

@@ -1,16 +1,14 @@
-import { FilterDirector } from '@unchainedshop/core';
 import { FilterNotFoundError } from "../../../../errors.js";
 import { getNormalizedFilterDetails } from "../../../utils/getNormalizedFilterDetails.js";
 export default async function createFilterOption(context, params) {
-    const { modules } = context;
+    const { modules, services } = context;
     const { filterId, option, optionTexts } = params;
     if (!(await modules.filters.filterExists({ filterId }))) {
         throw new FilterNotFoundError({ filterId });
     }
-    const newOption = await modules.filters.createFilterOption(filterId, { value: option });
+    const newOption = await services.filters.createFilterOption(filterId, { value: option });
     if (!newOption)
         return { filter: null };
-    await FilterDirector.invalidateProductIdCache(newOption, context);
     if (optionTexts && optionTexts.length > 0) {
         await modules.filters.texts.updateTexts({ filterId, filterOptionValue: option }, optionTexts);
     }

package/lib/mcp/tools/filter/handlers/removeFilterOption.js

@@ -1,19 +1,17 @@
-import { FilterDirector } from '@unchainedshop/core';
 import { FilterNotFoundError } from "../../../../errors.js";
 import { getNormalizedFilterDetails } from "../../../utils/getNormalizedFilterDetails.js";
 export default async function removeFilterOption(context, params) {
-    const { modules } = context;
+    const { modules, services } = context;
     const { filterId, option } = params;
     if (!(await modules.filters.filterExists({ filterId }))) {
         throw new FilterNotFoundError({ filterId });
     }
-    const removedFilterOption = await modules.filters.removeFilterOption({
+    const removedFilterOption = await services.filters.removeFilterOption({
         filterId,
         filterOptionValue: option,
     });
     if (!removedFilterOption)
         return { filter: null };
-    await FilterDirector.invalidateProductIdCache(removedFilterOption, context);
     const normalizedFilter = await getNormalizedFilterDetails(filterId, context);
     return { filter: normalizedFilter };
 }

package/lib/mcp/tools/filter/handlers/updateFilter.js

@@ -1,12 +1,12 @@
 import { FilterNotFoundError } from "../../../../errors.js";
 import { getNormalizedFilterDetails } from "../../../utils/getNormalizedFilterDetails.js";
 export default async function updateFilter(context, params) {
-    const { modules } = context;
+    const { modules, services } = context;
     const { filterId, updateData } = params;
     if (!(await modules.filters.filterExists({ filterId }))) {
         throw new FilterNotFoundError({ filterId });
     }
-    await modules.filters.update(filterId, updateData);
+    await services.filters.updateFilter(filterId, updateData);
     const normalizedFilter = await getNormalizedFilterDetails(filterId, context);
     return { filter: normalizedFilter };
 }

package/lib/mcp/tools/filter/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerFilterTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/filter/index.js

@@ -1,4 +1,7 @@
 import { filterManagement, FilterManagementSchema } from "./filterManagement.js";
 export const registerFilterTools = (server, context) => {
-    server.tool('filter_management', 'Comprehensive filter management system with unified CRUD operations. Supports: CREATE (new filters with localized texts), UPDATE (modify filter properties), REMOVE (delete with assortment cleanup), GET (retrieve single filter), LIST (paginated search with sorting), COUNT (total counts), CREATE_OPTION/REMOVE_OPTION (manage filter options), UPDATE_TEXTS/GET_TEXTS (localization management). Action-based routing with proper validation and error handling.', FilterManagementSchema, async (params) => filterManagement(context, params));
+    server.registerTool('filter_management', {
+        description: 'Comprehensive filter management system with unified CRUD operations. Supports: CREATE (new filters with localized texts), UPDATE (modify filter properties), REMOVE (delete with assortment cleanup), GET (retrieve single filter), LIST (paginated search with sorting), COUNT (total counts), CREATE_OPTION/REMOVE_OPTION (manage filter options), UPDATE_TEXTS/GET_TEXTS (localization management). Action-based routing with proper validation and error handling.',
+        inputSchema: FilterManagementSchema,
+    }, async (params) => filterManagement(context, params));
 };

package/lib/mcp/tools/filter/schemas.d.ts

@@ -133,11 +133,11 @@ export declare const FilterManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         CREATE_OPTION: "CREATE_OPTION";
         REMOVE_OPTION: "REMOVE_OPTION";
@@ -189,11 +189,11 @@ export declare const FilterManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         CREATE_OPTION: "CREATE_OPTION";
         REMOVE_OPTION: "REMOVE_OPTION";

package/lib/mcp/tools/localization/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerLocalizationTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/localization/index.js

@@ -1,4 +1,7 @@
 import { localizationManagement, LocalizationManagementSchema } from "./localizationManagement.js";
 export const registerLocalizationTools = (server, context) => {
-    server.tool('localization_management', 'Unified localization management tool for localization operations across geographic, monetary, and language entities. Countries use 2-letter codes (US, DE, FR), currencies use 3-letter codes (USD, EUR, CHF) with optional blockchain support, languages use locale codes (en, de-CH).. Actions: CREATE (add new), UPDATE (modify existing), REMOVE (delete).', LocalizationManagementSchema, async (params) => localizationManagement(context, params));
+    server.registerTool('localization_management', {
+        description: 'Unified localization management tool for localization operations across geographic, monetary, and language entities. Countries use 2-letter codes (US, DE, FR), currencies use 3-letter codes (USD, EUR, CHF) with optional blockchain support, languages use locale codes (en, de-CH).. Actions: CREATE (add new), UPDATE (modify existing), REMOVE (delete).',
+        inputSchema: LocalizationManagementSchema,
+    }, async (params) => localizationManagement(context, params));
 };

package/lib/mcp/tools/localization/schemas.d.ts

@@ -132,11 +132,11 @@ export declare const LocalizationManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
     }>;
     localizationType: z.ZodEnum<{
@@ -165,11 +165,11 @@ export declare const LocalizationManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
     }>;
     localizationType: z.ZodEnum<{

package/lib/mcp/tools/order/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerOrderTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/order/index.js

@@ -1,4 +1,7 @@
 import { orderManagement, OrderManagementSchema } from "./orderManagement.js";
 export const registerOrderTools = (server, context) => {
-    server.tool('order_management', 'Unified order management and analytics system. Supports: LIST (get orders with filters and pagination), SALES_SUMMARY (daily sales analytics), MONTHLY_BREAKDOWN (12-month sales analysis), TOP_CUSTOMERS (highest spending customers), TOP_PRODUCTS (best-selling products). All actions support date filtering and provider-based segmentation with proper aggregation and normalization.', OrderManagementSchema, async (params) => orderManagement(context, params));
+    server.registerTool('order_management', {
+        description: 'Unified order management and analytics system. Supports: LIST (get orders with filters and pagination), SALES_SUMMARY (daily sales analytics), MONTHLY_BREAKDOWN (12-month sales analysis), TOP_CUSTOMERS (highest spending customers), TOP_PRODUCTS (best-selling products). All actions support date filtering and provider-based segmentation with proper aggregation and normalization.',
+        inputSchema: OrderManagementSchema,
+    }, async (params) => orderManagement(context, params));
 };

package/lib/mcp/tools/order/schemas.d.ts

@@ -178,8 +178,8 @@ export declare const OrderManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
-        GET: "GET";
         LIST: "LIST";
+        GET: "GET";
         SALES_SUMMARY: "SALES_SUMMARY";
         MONTHLY_BREAKDOWN: "MONTHLY_BREAKDOWN";
         TOP_CUSTOMERS: "TOP_CUSTOMERS";
@@ -234,8 +234,8 @@ export declare const OrderManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
-        GET: "GET";
         LIST: "LIST";
+        GET: "GET";
         SALES_SUMMARY: "SALES_SUMMARY";
         MONTHLY_BREAKDOWN: "MONTHLY_BREAKDOWN";
         TOP_CUSTOMERS: "TOP_CUSTOMERS";

package/lib/mcp/tools/product/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerProductTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/product/index.js

@@ -1,4 +1,7 @@
 import { productManagement, ProductManagementSchema } from "./productManagement.js";
 export const registerProductTools = (server, context) => {
-    server.tool('product_management', 'Unified product management system with comprehensive action-based operations: CREATE/UPDATE/REMOVE/GET/LIST/COUNT products, UPDATE_STATUS (publish/unpublish), ADD_MEDIA/REMOVE_MEDIA/REORDER_MEDIA/GET_MEDIA/UPDATE_MEDIA_TEXTS, CREATE_VARIATION/REMOVE_VARIATION/ADD_VARIATION_OPTION/REMOVE_VARIATION_OPTION/UPDATE_VARIATION_TEXTS, ADD_ASSIGNMENT/REMOVE_ASSIGNMENT/GET_ASSIGNMENTS/GET_VARIATION_PRODUCTS, ADD_BUNDLE_ITEM/REMOVE_BUNDLE_ITEM/GET_BUNDLE_ITEMS, SIMULATE_PRICE/SIMULATE_PRICE_RANGE/GET_CATALOG_PRICE, GET_PRODUCT_TEXTS/GET_MEDIA_TEXTS/GET_VARIATION_TEXTS, GET_REVIEWS/COUNT_REVIEWS, GET_SIBLINGS. Supports all product types (SIMPLE, CONFIGURABLE, BUNDLE, PLAN, TOKENIZED) with type-specific validations and comprehensive error handling.', ProductManagementSchema, async (params) => productManagement(context, params));
+    server.registerTool('product_management', {
+        description: 'Unified product management system with comprehensive action-based operations: CREATE/UPDATE/REMOVE/GET/LIST/COUNT products, UPDATE_STATUS (publish/unpublish), ADD_MEDIA/REMOVE_MEDIA/REORDER_MEDIA/GET_MEDIA/UPDATE_MEDIA_TEXTS, CREATE_VARIATION/REMOVE_VARIATION/ADD_VARIATION_OPTION/REMOVE_VARIATION_OPTION/UPDATE_VARIATION_TEXTS, ADD_ASSIGNMENT/REMOVE_ASSIGNMENT/GET_ASSIGNMENTS/GET_VARIATION_PRODUCTS, ADD_BUNDLE_ITEM/REMOVE_BUNDLE_ITEM/GET_BUNDLE_ITEMS, SIMULATE_PRICE/SIMULATE_PRICE_RANGE/GET_CATALOG_PRICE, GET_PRODUCT_TEXTS/GET_MEDIA_TEXTS/GET_VARIATION_TEXTS, GET_REVIEWS/COUNT_REVIEWS, GET_SIBLINGS. Supports all product types (SIMPLE, CONFIGURABLE, BUNDLE, PLAN, TOKENIZED) with type-specific validations and comprehensive error handling.',
+        inputSchema: ProductManagementSchema,
+    }, async (params) => productManagement(context, params));
 };

package/lib/mcp/tools/product/schemas.d.ts

@@ -108,7 +108,7 @@ export declare const ProductSchema: z.ZodObject<{
     commerce: z.ZodOptional<z.ZodObject<{
         pricing: z.ZodArray<z.ZodObject<{
             amount: z.ZodNumber;
-            maxQuantity: z.ZodOptional<z.ZodNumber>;
+            minQuantity: z.ZodOptional<z.ZodNumber>;
             isTaxable: z.ZodOptional<z.ZodBoolean>;
             isNetPrice: z.ZodOptional<z.ZodBoolean>;
             currencyCode: z.ZodString;
@@ -164,7 +164,7 @@ export declare const actionValidators: {
             commerce: z.ZodOptional<z.ZodObject<{
                 pricing: z.ZodArray<z.ZodObject<{
                     amount: z.ZodNumber;
-                    maxQuantity: z.ZodOptional<z.ZodNumber>;
+                    minQuantity: z.ZodOptional<z.ZodNumber>;
                     isTaxable: z.ZodOptional<z.ZodBoolean>;
                     isNetPrice: z.ZodOptional<z.ZodBoolean>;
                     currencyCode: z.ZodString;
@@ -237,7 +237,7 @@ export declare const actionValidators: {
             commerce: z.ZodOptional<z.ZodObject<{
                 pricing: z.ZodArray<z.ZodObject<{
                     amount: z.ZodNumber;
-                    maxQuantity: z.ZodOptional<z.ZodNumber>;
+                    minQuantity: z.ZodOptional<z.ZodNumber>;
                     isTaxable: z.ZodOptional<z.ZodBoolean>;
                     isNetPrice: z.ZodOptional<z.ZodBoolean>;
                     currencyCode: z.ZodString;
@@ -476,11 +476,11 @@ export declare const ProductManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         UPDATE_STATUS: "UPDATE_STATUS";
         ADD_MEDIA: "ADD_MEDIA";
@@ -565,7 +565,7 @@ export declare const ProductManagementSchema: {
         commerce: z.ZodOptional<z.ZodObject<{
             pricing: z.ZodArray<z.ZodObject<{
                 amount: z.ZodNumber;
-                maxQuantity: z.ZodOptional<z.ZodNumber>;
+                minQuantity: z.ZodOptional<z.ZodNumber>;
                 isTaxable: z.ZodOptional<z.ZodBoolean>;
                 isNetPrice: z.ZodOptional<z.ZodBoolean>;
                 currencyCode: z.ZodString;
@@ -640,11 +640,11 @@ export declare const ProductManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         COUNT: "COUNT";
         UPDATE_STATUS: "UPDATE_STATUS";
         ADD_MEDIA: "ADD_MEDIA";
@@ -729,7 +729,7 @@ export declare const ProductManagementZodSchema: z.ZodObject<{
         commerce: z.ZodOptional<z.ZodObject<{
             pricing: z.ZodArray<z.ZodObject<{
                 amount: z.ZodNumber;
-                maxQuantity: z.ZodOptional<z.ZodNumber>;
+                minQuantity: z.ZodOptional<z.ZodNumber>;
                 isTaxable: z.ZodOptional<z.ZodBoolean>;
                 isNetPrice: z.ZodOptional<z.ZodBoolean>;
                 currencyCode: z.ZodString;

package/lib/mcp/tools/product/schemas.js

@@ -73,11 +73,12 @@ export const ProductSchema = z.object({
         pricing: z
             .array(z.object({
             amount: z.number().int().describe('Price amount in smallest currency unit.'),
-            maxQuantity: z
+            minQuantity: z
                 .number()
                 .int()
+                .min(0)
                 .optional()
-                .describe('Optional maximum quantity for this price tier'),
+                .describe('Optional inclusive minimum quantity (tier floor) this price applies to; defaults to the base tier (0).'),
             isTaxable: z.boolean().optional().describe('Whether tax applies to this price'),
             isNetPrice: z.boolean().optional().describe('Whether this is a net price (without tax)'),
             currencyCode: z

package/lib/mcp/tools/provider/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerProviderTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/provider/index.js

@@ -1,4 +1,7 @@
 import { providerManagement, ProviderManagementSchema } from "./providerManagement.js";
 export const registerProviderTools = (server, context) => {
-    server.tool('provider_management', 'Unified provider management tool for all provider operations (CREATE, UPDATE, REMOVE, GET, LIST, INTERFACES) across payment processing (Stripe, PayPal), delivery services (FedEx, UPS), and warehousing systems. Use action parameter to specify operation type.', ProviderManagementSchema, async (params) => providerManagement(context, params));
+    server.registerTool('provider_management', {
+        description: 'Unified provider management tool for all provider operations (CREATE, UPDATE, REMOVE, GET, LIST, INTERFACES) across payment processing (Stripe, PayPal), delivery services (FedEx, UPS), and warehousing systems. Use action parameter to specify operation type.',
+        inputSchema: ProviderManagementSchema,
+    }, async (params) => providerManagement(context, params));
 };

package/lib/mcp/tools/provider/schemas.d.ts

@@ -133,11 +133,11 @@ export declare const ProviderManagementSchema: {
     queryString: z.ZodOptional<z.ZodString>;
     includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         INTERFACES: "INTERFACES";
     }>;
     providerType: z.ZodEnum<{
@@ -182,11 +182,11 @@ export declare const ProviderManagementZodSchema: z.ZodObject<{
     queryString: z.ZodOptional<z.ZodString>;
     includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     action: z.ZodEnum<{
+        LIST: "LIST";
         GET: "GET";
         CREATE: "CREATE";
         UPDATE: "UPDATE";
         REMOVE: "REMOVE";
-        LIST: "LIST";
         INTERFACES: "INTERFACES";
     }>;
     providerType: z.ZodEnum<{

package/lib/mcp/tools/quotation/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerQuotationTools: (server: McpServer, context: Context) => void;

package/lib/mcp/tools/quotation/index.js

@@ -1,4 +1,7 @@
 import { quotationManagement, QuotationManagementSchema } from "./quotationManagement.js";
 export const registerQuotationTools = (server, context) => {
-    server.tool('quotation_management', 'Unified quotation management system. Supports: LIST (get quotations with filters and pagination), GET (single quotation by ID), COUNT (count quotations), REQUEST (create new quotation request for a product), VERIFY (verify a REQUESTED quotation), MAKE_PROPOSAL (create proposal for PROCESSING quotation), REJECT (reject any quotation except FULFILLED). Quotations go through lifecycle: REQUESTED → PROCESSING → PROPOSED → FULFILLED/REJECTED.', QuotationManagementSchema, async (params) => quotationManagement(context, params));
+    server.registerTool('quotation_management', {
+        description: 'Unified quotation management system. Supports: LIST (get quotations with filters and pagination), GET (single quotation by ID), COUNT (count quotations), VERIFY (verify a REQUESTED quotation), MAKE_PROPOSAL (create proposal for PROCESSING quotation), REJECT (reject any quotation except FULFILLED). Quotations go through lifecycle: REQUESTED → PROCESSING → PROPOSED → FULFILLED/REJECTED.',
+        inputSchema: QuotationManagementSchema,
+    }, async (params) => quotationManagement(context, params));
 };

package/lib/mcp/tools/quotation/schemas.d.ts

@@ -94,8 +94,8 @@ export declare const QuotationManagementSchema: {
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
-        GET: "GET";
         LIST: "LIST";
+        GET: "GET";
         COUNT: "COUNT";
         VERIFY: "VERIFY";
         MAKE_PROPOSAL: "MAKE_PROPOSAL";
@@ -131,8 +131,8 @@ export declare const QuotationManagementZodSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     action: z.ZodEnum<{
-        GET: "GET";
         LIST: "LIST";
+        GET: "GET";
         COUNT: "COUNT";
         VERIFY: "VERIFY";
         MAKE_PROPOSAL: "MAKE_PROPOSAL";

package/lib/mcp/tools/system/index.d.ts

@@ -1,3 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import type { Context } from '../../../context.ts';
 export declare const registerSystemTools: (server: McpServer, context: Context) => void;