@open-loyalty/mcp-server 1.0.3 → 1.3.1

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

@@ -0,0 +1,116 @@
+import { z } from "zod";
+export declare const RewardListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodEnum<["static_coupon", "dynamic_coupon", "conversion_coupon", "material", "fortune_wheel"]>>;
+    categoryId: z.ZodOptional<z.ZodString>;
+};
+export declare const RewardCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    translations: z.ZodObject<{
+        en: z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        en: z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        en: z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+    }, z.ZodTypeAny, "passthrough">>;
+    reward: z.ZodEnum<["static_coupon", "dynamic_coupon", "conversion_coupon", "material", "fortune_wheel"]>;
+    activity: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    visibility: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    usageLimit: z.ZodObject<{
+        perUser: z.ZodNumber;
+        general: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        perUser: number;
+        general?: number | undefined;
+    }, {
+        perUser: number;
+        general?: number | undefined;
+    }>;
+    costInPoints: z.ZodOptional<z.ZodNumber>;
+    usageInstruction: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    levels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    target: z.ZodOptional<z.ZodNullable<z.ZodEnum<["level", "segment"]>>>;
+    couponValue: z.ZodOptional<z.ZodNumber>;
+    couponValueType: z.ZodOptional<z.ZodEnum<["money", "percentage"]>>;
+    daysValid: z.ZodOptional<z.ZodNumber>;
+};
+export declare const RewardGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    rewardId: z.ZodString;
+};
+export declare const RewardUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    rewardId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    costInPoints: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    levels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare const RewardIdInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    rewardId: z.ZodString;
+};
+export declare const RewardBuyInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    rewardId: z.ZodString;
+    memberId: z.ZodString;
+    quantity: z.ZodOptional<z.ZodNumber>;
+    couponValue: z.ZodOptional<z.ZodNumber>;
+    withoutPoints: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const RewardRedeemInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    couponCode: z.ZodString;
+};
+export declare const RewardCategoryListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodOptional<z.ZodBoolean>;
+};

package/dist/tools/reward/schemas.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+export const RewardListInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    page: z.number().optional().describe("Page number (default: 1)."),
+    perPage: z.number().optional().describe("Items per page (default: 10)."),
+    active: z.boolean().optional().describe("Filter by active status."),
+    type: z.enum(["static_coupon", "dynamic_coupon", "conversion_coupon", "material", "fortune_wheel"]).optional().describe("Filter by reward type."),
+    categoryId: z.string().optional().describe("Filter by category ID."),
+};
+// Translations schema for rewards (API requires translations.en at minimum)
+// Note: translations.en must ONLY contain name, description is a separate field at top level
+const RewardTranslationsInputSchema = z.object({
+    en: z.object({
+        name: z.string().describe("Reward name in English (required)."),
+    }),
+}).passthrough().describe("Translations object with at least 'en' key containing { name }. Description goes at top level.");
+// Activity period schema (REQUIRED by API)
+// API requires datetime format: YYYY-MM-DD HH:mm (NOT just YYYY-MM-DD)
+const RewardActivityInputSchema = z.object({
+    from: z.string().describe("Start datetime (format: 'YYYY-MM-DD HH:mm', e.g., '2026-01-01 00:00'). REQUIRED."),
+    to: z.string().describe("End datetime (format: 'YYYY-MM-DD HH:mm', e.g., '2026-12-31 23:59'). REQUIRED."),
+});
+// Visibility period schema (REQUIRED by API)
+// API requires datetime format: YYYY-MM-DD HH:mm (NOT just YYYY-MM-DD)
+const RewardVisibilityInputSchema = z.object({
+    from: z.string().describe("Visibility start datetime (format: 'YYYY-MM-DD HH:mm'). REQUIRED."),
+    to: z.string().describe("Visibility end datetime (format: 'YYYY-MM-DD HH:mm'). REQUIRED."),
+});
+// Usage limit schema (REQUIRED by API for coupon types)
+// NOTE: API uses 'general' (not 'total') for total redemptions limit
+const RewardUsageLimitInputSchema = z.object({
+    perUser: z.number().describe("Maximum redemptions per member. REQUIRED for coupon types."),
+    general: z.number().optional().describe("Total redemptions across all members (API calls this 'general')."),
+});
+export const RewardCreateInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    translations: RewardTranslationsInputSchema.describe("Reward name translations. At least 'en' key with { name } is REQUIRED."),
+    reward: z.enum(["static_coupon", "dynamic_coupon", "conversion_coupon", "material", "fortune_wheel"]).describe("Reward type: static_coupon (fixed discount), dynamic_coupon (variable value), " +
+        "conversion_coupon (converts points to coupon), material (physical goods), fortune_wheel (gamified)."),
+    activity: RewardActivityInputSchema.describe("Activity period when reward can be purchased. Use datetime format 'YYYY-MM-DD HH:mm'. REQUIRED."),
+    visibility: RewardVisibilityInputSchema.describe("Visibility period when reward is shown. Use datetime format 'YYYY-MM-DD HH:mm'. REQUIRED."),
+    usageLimit: RewardUsageLimitInputSchema.describe("Usage limits. perUser is REQUIRED for coupon types."),
+    costInPoints: z.number().optional().describe("Points required to redeem this reward."),
+    usageInstruction: z.string().optional().describe("Instructions for using the reward."),
+    active: z.boolean().optional().describe("Whether reward is active (default: false)."),
+    categories: z.array(z.string()).optional().describe("Array of category UUIDs."),
+    levels: z.array(z.string()).optional().describe("Array of tier level UUIDs that can see/redeem."),
+    segments: z.array(z.string()).optional().describe("Array of segment UUIDs that can see/redeem."),
+    target: z.enum(["level", "segment"]).nullable().optional().describe("Target type for visibility: level (tier-based), segment (segment-based), or null (all)."),
+    couponValue: z.number().optional().describe("Coupon value (required for static_coupon)."),
+    couponValueType: z.enum(["money", "percentage"]).optional().describe("Coupon value type: 'money' or 'percentage' (lowercase)."),
+    daysValid: z.number().optional().describe("Days the coupon remains valid after purchase."),
+};
+export const RewardGetInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    rewardId: z.string().describe("The reward ID (UUID) to retrieve."),
+};
+export const RewardUpdateInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    rewardId: z.string().describe("The reward ID (UUID) to update."),
+    name: z.string().optional().describe("Reward name."),
+    costInPoints: z.number().optional().describe("Points required to redeem."),
+    description: z.string().optional().describe("Reward description."),
+    active: z.boolean().optional().describe("Whether reward is active."),
+    categories: z.array(z.string()).optional().describe("Array of category UUIDs."),
+    levels: z.array(z.string()).optional().describe("Array of tier level UUIDs."),
+    segments: z.array(z.string()).optional().describe("Array of segment UUIDs."),
+};
+export const RewardIdInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    rewardId: z.string().describe("The reward ID (UUID)."),
+};
+export const RewardBuyInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    rewardId: z.string().describe("The reward ID (UUID) to purchase."),
+    memberId: z.string().describe("The member ID (UUID) purchasing the reward."),
+    quantity: z.number().optional().describe("Number of rewards to purchase (1-32, default: 1)."),
+    couponValue: z.number().optional().describe("Coupon value (for dynamic coupons)."),
+    withoutPoints: z.boolean().optional().describe("Admin only: skip points deduction."),
+};
+export const RewardRedeemInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    memberId: z.string().describe("The member ID (UUID) redeeming the coupon."),
+    couponCode: z.string().describe("The coupon code to redeem."),
+};
+export const RewardCategoryListInputSchema = {
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    page: z.number().optional().describe("Page number (default: 1)."),
+    perPage: z.number().optional().describe("Items per page (default: 10)."),
+    active: z.boolean().optional().describe("Filter by active status."),
+};

package/dist/tools/reward.d.ts

@@ -158,7 +158,9 @@ export declare function rewardCategoryList(input: {
 }>;
 export declare const rewardToolDefinitions: readonly [{
     readonly name: "openloyalty_reward_list";
+    readonly title: "Browse Rewards";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -170,7 +172,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardList;
 }, {
     readonly name: "openloyalty_reward_create";
+    readonly title: "Create New Reward";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
@@ -190,7 +194,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardCreate;
 }, {
     readonly name: "openloyalty_reward_get";
+    readonly title: "Get Reward Details";
     readonly description: "Get full reward details including configuration, targeting, and coupon settings.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         rewardId: z.ZodString;
@@ -198,7 +204,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardGet;
 }, {
     readonly name: "openloyalty_reward_update";
+    readonly title: "Update Reward";
     readonly description: "Update reward configuration. Cannot change reward type after creation.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         rewardId: z.ZodString;
@@ -213,7 +221,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardUpdate;
 }, {
     readonly name: "openloyalty_reward_activate";
+    readonly title: "Activate Reward";
     readonly description: "Activate a reward, making it available for members to redeem.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         rewardId: z.ZodString;
@@ -221,7 +231,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardActivate;
 }, {
     readonly name: "openloyalty_reward_deactivate";
+    readonly title: "Deactivate Reward";
     readonly description: "Deactivate a reward, hiding it from members. Already purchased rewards remain valid.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         rewardId: z.ZodString;
@@ -229,7 +241,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardDeactivate;
 }, {
     readonly name: "openloyalty_reward_buy";
+    readonly title: "Redeem Reward for Member";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         rewardId: z.ZodString;
@@ -241,7 +255,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardBuy;
 }, {
     readonly name: "openloyalty_reward_redeem";
+    readonly title: "Use Coupon Code";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -250,7 +266,9 @@ export declare const rewardToolDefinitions: readonly [{
     readonly handler: typeof rewardRedeem;
 }, {
     readonly name: "openloyalty_reward_category_list";
+    readonly title: "List Reward Categories";
     readonly description: "List reward categories. Use categoryId when creating or filtering rewards.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;

package/dist/tools/reward.js

@@ -2,7 +2,8 @@ import { z } from "zod";
 import { apiGet, apiPost, apiPut } from "../client/http.js";
 import { RewardSchema, } from "../types/schemas/reward.js";
 import { formatApiError, OpenLoyaltyError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
+import { omitUndefined } from "../utils/payload.js";
 // Input Schemas
 export const RewardListInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -69,8 +70,7 @@ export const RewardCategoryListInputSchema = {
 };
 // Handler functions
 export async function rewardList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -111,34 +111,22 @@ export async function rewardList(input) {
     }
 }
 export async function rewardCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
         name: input.name,
         type: input.type,
-    };
-    if (input.costInPoints !== undefined)
-        payload.costInPoints = input.costInPoints;
-    if (input.description)
-        payload.description = input.description;
-    if (input.usageInstruction)
-        payload.usageInstruction = input.usageInstruction;
-    if (input.active !== undefined)
-        payload.active = input.active;
-    if (input.categories)
-        payload.categories = input.categories;
-    if (input.levels)
-        payload.levels = input.levels;
-    if (input.segments)
-        payload.segments = input.segments;
-    if (input.target !== undefined)
-        payload.target = input.target;
-    if (input.couponValue !== undefined)
-        payload.couponValue = input.couponValue;
-    if (input.couponValueType)
-        payload.couponValueType = input.couponValueType;
-    if (input.daysValid !== undefined)
-        payload.daysValid = input.daysValid;
+        costInPoints: input.costInPoints,
+        description: input.description,
+        usageInstruction: input.usageInstruction,
+        active: input.active,
+        categories: input.categories,
+        levels: input.levels,
+        segments: input.segments,
+        target: input.target,
+        couponValue: input.couponValue,
+        couponValueType: input.couponValueType,
+        daysValid: input.daysValid,
+    });
     try {
         const response = await apiPost(`/${storeCode}/reward`, { reward: payload });
         return {
@@ -152,8 +140,7 @@ export async function rewardCreate(input) {
     }
 }
 export async function rewardGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/reward/${input.rewardId}`);
         return RewardSchema.parse(response);
@@ -163,23 +150,16 @@ export async function rewardGet(input) {
     }
 }
 export async function rewardUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {};
-    if (input.name)
-        payload.name = input.name;
-    if (input.costInPoints !== undefined)
-        payload.costInPoints = input.costInPoints;
-    if (input.description)
-        payload.description = input.description;
-    if (input.active !== undefined)
-        payload.active = input.active;
-    if (input.categories)
-        payload.categories = input.categories;
-    if (input.levels)
-        payload.levels = input.levels;
-    if (input.segments)
-        payload.segments = input.segments;
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
+        name: input.name,
+        costInPoints: input.costInPoints,
+        description: input.description,
+        active: input.active,
+        categories: input.categories,
+        levels: input.levels,
+        segments: input.segments,
+    });
     try {
         await apiPut(`/${storeCode}/reward/${input.rewardId}`, { reward: payload });
     }
@@ -188,8 +168,7 @@ export async function rewardUpdate(input) {
     }
 }
 export async function rewardActivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/reward/${input.rewardId}/activate`);
     }
@@ -198,8 +177,7 @@ export async function rewardActivate(input) {
     }
 }
 export async function rewardDeactivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/reward/${input.rewardId}/deactivate`);
     }
@@ -208,17 +186,13 @@ export async function rewardDeactivate(input) {
     }
 }
 export async function rewardBuy(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
         customerId: input.memberId,
-    };
-    if (input.quantity)
-        payload.quantity = input.quantity;
-    if (input.couponValue !== undefined)
-        payload.couponValue = input.couponValue;
-    if (input.withoutPoints !== undefined)
-        payload.withoutPoints = input.withoutPoints;
+        quantity: input.quantity,
+        couponValue: input.couponValue,
+        withoutPoints: input.withoutPoints,
+    });
     try {
         const response = await apiPost(`/${storeCode}/reward/${input.rewardId}/buy`, payload);
         // API returns array of issued rewards
@@ -242,8 +216,7 @@ export async function rewardBuy(input) {
     }
 }
 export async function rewardRedeem(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiPost(`/${storeCode}/member/${input.memberId}/reward/redeem`, { couponCode: input.couponCode });
         return { code: response.code || input.couponCode, used: true };
@@ -278,8 +251,7 @@ export async function rewardRedeem(input) {
     }
 }
 export async function rewardCategoryList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -310,61 +282,79 @@ export async function rewardCategoryList(input) {
 export const rewardToolDefinitions = [
     {
         name: "openloyalty_reward_list",
+        title: "Browse Rewards",
         description: "List available rewards. Use reward_get for full details or reward_buy to redeem. " +
             "Filter by type, active status, or category.",
+        readOnly: true,
         inputSchema: RewardListInputSchema,
         handler: rewardList,
     },
     {
         name: "openloyalty_reward_create",
+        title: "Create New Reward",
         description: "Create a new reward that members can redeem with points. " +
             "Types: static_coupon (fixed discount), dynamic_coupon (variable value set at purchase), " +
             "material (physical goods), conversion_coupon (converts points), fortune_wheel (gamified). " +
             "Returns rewardId.",
+        readOnly: false,
         inputSchema: RewardCreateInputSchema,
         handler: rewardCreate,
     },
     {
         name: "openloyalty_reward_get",
+        title: "Get Reward Details",
         description: "Get full reward details including configuration, targeting, and coupon settings.",
+        readOnly: true,
         inputSchema: RewardGetInputSchema,
         handler: rewardGet,
     },
     {
         name: "openloyalty_reward_update",
+        title: "Update Reward",
         description: "Update reward configuration. Cannot change reward type after creation.",
+        readOnly: false,
         inputSchema: RewardUpdateInputSchema,
         handler: rewardUpdate,
     },
     {
         name: "openloyalty_reward_activate",
+        title: "Activate Reward",
         description: "Activate a reward, making it available for members to redeem.",
+        readOnly: false,
         inputSchema: RewardIdInputSchema,
         handler: rewardActivate,
     },
     {
         name: "openloyalty_reward_deactivate",
+        title: "Deactivate Reward",
         description: "Deactivate a reward, hiding it from members. Already purchased rewards remain valid.",
+        readOnly: false,
         inputSchema: RewardIdInputSchema,
         handler: rewardDeactivate,
     },
     {
         name: "openloyalty_reward_buy",
+        title: "Redeem Reward for Member",
         description: "Purchase reward for member, deducting points. Returns issuedRewardId and couponCode if applicable. " +
             "Use reward_redeem to mark the coupon as used.",
+        readOnly: false,
         inputSchema: RewardBuyInputSchema,
         handler: rewardBuy,
     },
     {
         name: "openloyalty_reward_redeem",
+        title: "Use Coupon Code",
         description: "Mark coupon as used. Validates coupon exists, belongs to member, and is active. " +
             "Fails if coupon is expired, already used, or doesn't exist.",
+        readOnly: false,
         inputSchema: RewardRedeemInputSchema,
         handler: rewardRedeem,
     },
     {
         name: "openloyalty_reward_category_list",
+        title: "List Reward Categories",
         description: "List reward categories. Use categoryId when creating or filtering rewards.",
+        readOnly: true,
         inputSchema: RewardCategoryListInputSchema,
         handler: rewardCategoryList,
     },

package/dist/tools/role.d.ts

@@ -1,5 +1,10 @@
 import { z } from "zod";
-import { Role, RoleListItem, ACLResource, RolePermissionInput } from "../types/schemas/role.js";
+import { Role, RoleListItem, ACLResource } from "../types/schemas/role.js";
+interface RolePermissionInput {
+    resource: string;
+    access: string;
+    filterQuery?: string;
+}
 export declare const RoleListInputSchema: {
     page: z.ZodOptional<z.ZodNumber>;
     perPage: z.ZodOptional<z.ZodNumber>;
@@ -84,8 +89,10 @@ export declare function aclGetResources(): Promise<{
     total?: Record<string, unknown>;
 }>;
 export declare const roleToolDefinitions: readonly [{
-    readonly name: "openloyalty_role_list";
+    readonly name: "ol_role_list";
+    readonly title: "List Roles";
     readonly description: "List all roles with optional filtering. Returns paginated list of roles with id, name, permissions, master status, and default status.";
+    readonly readOnly: true;
     readonly inputSchema: {
         page: z.ZodOptional<z.ZodNumber>;
         perPage: z.ZodOptional<z.ZodNumber>;
@@ -95,8 +102,10 @@ export declare const roleToolDefinitions: readonly [{
     };
     readonly handler: typeof roleList;
 }, {
-    readonly name: "openloyalty_role_create";
+    readonly name: "ol_role_create";
+    readonly title: "Create Role";
     readonly description: "Create a new role with permissions. Requires name. Optionally specify permissions (array of {resource, access, filterQuery}) and stores. Returns void on success (201 Created).";
+    readonly readOnly: false;
     readonly inputSchema: {
         name: z.ZodString;
         permissions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -117,15 +126,19 @@ export declare const roleToolDefinitions: readonly [{
     };
     readonly handler: typeof roleCreate;
 }, {
-    readonly name: "openloyalty_role_get";
+    readonly name: "ol_role_get";
+    readonly title: "Get Role Details";
     readonly description: "Get full role details by ID. Returns role with name, permissions array, master status, default status, and stores.";
+    readonly readOnly: true;
     readonly inputSchema: {
         roleId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
     };
     readonly handler: typeof roleGet;
 }, {
-    readonly name: "openloyalty_role_update";
+    readonly name: "ol_role_update";
+    readonly title: "Update Role";
     readonly description: "Update a role's name, permissions, or stores. Returns void on success (204 No Content).";
+    readonly readOnly: false;
     readonly inputSchema: {
         roleId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
         name: z.ZodOptional<z.ZodString>;
@@ -147,15 +160,21 @@ export declare const roleToolDefinitions: readonly [{
     };
     readonly handler: typeof roleUpdate;
 }, {
-    readonly name: "openloyalty_role_delete";
+    readonly name: "ol_role_delete";
+    readonly title: "Delete Role (Permanent)";
     readonly description: "Delete a role by ID. Returns void on success (204 No Content). Cannot delete roles that are assigned to admin users.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         roleId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
     };
     readonly handler: typeof roleDelete;
 }, {
-    readonly name: "openloyalty_acl_get_resources";
+    readonly name: "ol_acl_get_resources";
+    readonly title: "Get ACL Resources";
     readonly description: "Get list of available ACL resources. Returns items with code and name for each resource type. Use this to discover available permissions before creating roles.";
+    readonly readOnly: true;
     readonly inputSchema: {};
     readonly handler: typeof aclGetResources;
 }];
+export {};