@open-loyalty/mcp-server 1.7.0 → 1.12.0

package/dist/tools/store/index.js

@@ -1,10 +1,10 @@
 // Re-export schemas and types
-export { StoreListInputSchema, StoreCreateInputSchema, StoreGetInputSchema, StoreUpdateInputSchema, } from "./schemas.js";
+export { StoreListInputSchema, StoreCreateInputSchema, StoreGetInputSchema, StoreUpdateInputSchema, StoreGetSettingsInputSchema, StoreUpdateSettingsInputSchema, } from "./schemas.js";
 // Re-export handlers
-export { storeList, storeCreate, storeGet, storeUpdate, } from "./handlers.js";
+export { storeList, storeCreate, storeGet, storeUpdate, storeGetSettings, storeUpdateSettings, } from "./handlers.js";
 // Imports for tool definitions
-import { StoreListInputSchema, StoreCreateInputSchema, StoreGetInputSchema, StoreUpdateInputSchema, } from "./schemas.js";
-import { storeList, storeCreate, storeGet, storeUpdate, } from "./handlers.js";
+import { StoreListInputSchema, StoreCreateInputSchema, StoreGetInputSchema, StoreUpdateInputSchema, StoreGetSettingsInputSchema, StoreUpdateSettingsInputSchema, } from "./schemas.js";
+import { storeList, storeCreate, storeGet, storeUpdate, storeGetSettings, storeUpdateSettings, } from "./handlers.js";
 // Tool definitions
 export const storeToolDefinitions = [
     {
@@ -43,4 +43,27 @@ export const storeToolDefinitions = [
         inputSchema: StoreUpdateInputSchema,
         handler: storeUpdate,
     },
+    {
+        name: "ol_store_get_settings",
+        title: "Get Store Settings",
+        description: "Get the loyalty program settings for the current store. Returns configuration such as tier assignment type, " +
+            "wallet codes, downgrade mode, account activation requirements, member identification method, timezone, " +
+            "notification settings, and active member criteria. Use before ol_store_update_settings to see current values.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: StoreGetSettingsInputSchema,
+        handler: storeGetSettings,
+    },
+    {
+        name: "ol_store_update_settings",
+        title: "Update Store Settings",
+        description: "Update loyalty program settings via PATCH (partial update — only provided fields are changed). " +
+            "KEY SETTINGS: tierAssignType ('points'|'transactions'), tierWalletCode, levelDowngradeMode ('none'|'automatic'|'after_x_days'), " +
+            "accountActivationRequired, identificationMethod ('email'|'phone'|'loyaltyCardNumber'), timezone. " +
+            "Use ol_store_get_settings first to see current values before making changes.",
+        readOnly: false,
+        idempotent: true,
+        inputSchema: StoreUpdateSettingsInputSchema,
+        handler: storeUpdateSettings,
+    },
 ];

package/dist/tools/store/schemas.d.ts

@@ -36,3 +36,27 @@ export declare const StoreUpdateInputSchema: {
     active: z.ZodOptional<z.ZodBoolean>;
     currency: z.ZodOptional<z.ZodString>;
 };
+export declare const StoreGetSettingsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const StoreUpdateSettingsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    programName: z.ZodOptional<z.ZodString>;
+    allowCustomersProfileEdits: z.ZodOptional<z.ZodBoolean>;
+    tierAssignType: z.ZodOptional<z.ZodEnum<["points", "transactions"]>>;
+    tierWalletCode: z.ZodOptional<z.ZodString>;
+    excludeDeliveryCostsFromTierAssignment: z.ZodOptional<z.ZodBoolean>;
+    excludedLevelCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    levelDowngradeMode: z.ZodOptional<z.ZodEnum<["none", "automatic", "after_x_days"]>>;
+    levelDowngradeDays: z.ZodOptional<z.ZodNumber>;
+    levelDowngradeBase: z.ZodOptional<z.ZodEnum<["none", "active_points", "earned_points", "earned_points_since_last_level_change"]>>;
+    levelResetPointsOnDowngrade: z.ZodOptional<z.ZodBoolean>;
+    accountActivationRequired: z.ZodOptional<z.ZodBoolean>;
+    identificationMethod: z.ZodOptional<z.ZodEnum<["email", "phone", "loyaltyCardNumber"]>>;
+    timezone: z.ZodOptional<z.ZodString>;
+    timezoneStrategy: z.ZodOptional<z.ZodEnum<["none", "default", "localtime"]>>;
+    rewardWalletCode: z.ZodOptional<z.ZodString>;
+    expirePointsNotificationDays: z.ZodOptional<z.ZodNumber>;
+    expireCouponsNotificationDays: z.ZodOptional<z.ZodNumber>;
+    expireLevelsNotificationDays: z.ZodOptional<z.ZodNumber>;
+};

package/dist/tools/store/schemas.js

@@ -21,3 +21,27 @@ export const StoreUpdateInputSchema = {
     active: z.boolean().optional().describe("Whether the store is active."),
     currency: z.string().optional().describe("Currency code."),
 };
+export const StoreGetSettingsInputSchema = {
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
+};
+export const StoreUpdateSettingsInputSchema = {
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
+    programName: z.string().optional().describe("Program/loyalty program name."),
+    allowCustomersProfileEdits: z.boolean().optional().describe("Whether members can edit their own profiles."),
+    tierAssignType: z.enum(["points", "transactions"]).optional().describe("How tier assignment is calculated: 'points' (based on wallet balance) or 'transactions' (based on purchase count)."),
+    tierWalletCode: z.string().optional().describe("Wallet used for tier assignment (wallet type code)."),
+    excludeDeliveryCostsFromTierAssignment: z.boolean().optional().describe("Exclude delivery costs from tier calculations."),
+    excludedLevelCategories: z.array(z.string()).optional().describe("Product categories excluded from tier assignment."),
+    levelDowngradeMode: z.enum(["none", "automatic", "after_x_days"]).optional().describe("Tier downgrade mode: 'none' (never downgrade), 'automatic' (downgrade when criteria unmet), 'after_x_days' (downgrade after N inactive days)."),
+    levelDowngradeDays: z.number().optional().describe("Days before tier downgrade (used with levelDowngradeMode: 'after_x_days')."),
+    levelDowngradeBase: z.enum(["none", "active_points", "earned_points", "earned_points_since_last_level_change"]).optional().describe("Point basis for downgrade recalculation."),
+    levelResetPointsOnDowngrade: z.boolean().optional().describe("Reset points when member is downgraded."),
+    accountActivationRequired: z.boolean().optional().describe("Whether new accounts require email activation before participating."),
+    identificationMethod: z.enum(["email", "phone", "loyaltyCardNumber"]).optional().describe("Primary member identification method."),
+    timezone: z.string().optional().describe("Store timezone (e.g., 'Europe/Warsaw', 'America/New_York')."),
+    timezoneStrategy: z.enum(["none", "default", "localtime"]).optional().describe("Timezone handling strategy."),
+    rewardWalletCode: z.string().optional().describe("Wallet used for reward purchases (wallet type code)."),
+    expirePointsNotificationDays: z.number().optional().describe("Days before point expiry to send notification email."),
+    expireCouponsNotificationDays: z.number().optional().describe("Days before coupon expiry to send notification email."),
+    expireLevelsNotificationDays: z.number().optional().describe("Days before tier expiry to send notification email."),
+};