@open-loyalty/mcp-server 1.0.3 → 1.1.0

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>;
@@ -85,7 +90,9 @@ export declare function aclGetResources(): Promise<{
 }>;
 export declare const roleToolDefinitions: readonly [{
     readonly name: "openloyalty_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>;
@@ -96,7 +103,9 @@ export declare const roleToolDefinitions: readonly [{
     readonly handler: typeof roleList;
 }, {
     readonly name: "openloyalty_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<{
@@ -118,14 +127,18 @@ export declare const roleToolDefinitions: readonly [{
     readonly handler: typeof roleCreate;
 }, {
     readonly name: "openloyalty_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 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>;
@@ -148,14 +161,20 @@ export declare const roleToolDefinitions: readonly [{
     readonly handler: typeof roleUpdate;
 }, {
     readonly name: "openloyalty_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 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 {};

package/dist/tools/role.js

@@ -123,37 +123,50 @@ export async function aclGetResources() {
 export const roleToolDefinitions = [
     {
         name: "openloyalty_role_list",
+        title: "List Roles",
         description: "List all roles with optional filtering. Returns paginated list of roles with id, name, permissions, master status, and default status.",
+        readOnly: true,
         inputSchema: RoleListInputSchema,
         handler: roleList,
     },
     {
         name: "openloyalty_role_create",
+        title: "Create Role",
         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: false,
         inputSchema: RoleCreateInputSchema,
         handler: roleCreate,
     },
     {
         name: "openloyalty_role_get",
+        title: "Get Role Details",
         description: "Get full role details by ID. Returns role with name, permissions array, master status, default status, and stores.",
+        readOnly: true,
         inputSchema: RoleGetInputSchema,
         handler: roleGet,
     },
     {
         name: "openloyalty_role_update",
+        title: "Update Role",
         description: "Update a role's name, permissions, or stores. Returns void on success (204 No Content).",
+        readOnly: false,
         inputSchema: RoleUpdateInputSchema,
         handler: roleUpdate,
     },
     {
         name: "openloyalty_role_delete",
+        title: "Delete Role (Permanent)",
         description: "Delete a role by ID. Returns void on success (204 No Content). Cannot delete roles that are assigned to admin users.",
+        readOnly: false,
+        destructive: true,
         inputSchema: RoleDeleteInputSchema,
         handler: roleDelete,
     },
     {
         name: "openloyalty_acl_get_resources",
+        title: "Get ACL Resources",
         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: true,
         inputSchema: {},
         handler: aclGetResources,
     },

package/dist/tools/segment.d.ts

@@ -423,7 +423,9 @@ export declare function segmentGetResources(input: {
 }>;
 export declare const segmentToolDefinitions: readonly [{
     readonly name: "openloyalty_segment_list";
+    readonly title: "List Segments";
     readonly description: "List customer segments. Segments group members by criteria (purchase behavior, tier, location, etc). Use for campaign targeting and analytics.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -434,7 +436,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentList;
 }, {
     readonly name: "openloyalty_segment_create";
+    readonly title: "Create Segment";
     readonly description: "Create segment to group members. Parts use OR logic (member matches if ANY part matches). Criteria within parts use AND logic (must match ALL criteria in that part). Common criteria: tier, transaction_count, points_balance, country. Example - VIP segment: parts: [{ criteria: [{ type: 'tier', tierIds: ['gold-level-id'] }] }]";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
@@ -589,7 +593,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentCreate;
 }, {
     readonly name: "openloyalty_segment_get";
+    readonly title: "Get Segment Details";
     readonly description: "Get full segment details including all parts and criteria configurations.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -597,7 +603,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentGet;
 }, {
     readonly name: "openloyalty_segment_update";
+    readonly title: "Update Segment";
     readonly description: "Update segment configuration. Requires full segment definition (name, parts with criteria). Use segment_get first to retrieve current configuration.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -753,7 +761,10 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentUpdate;
 }, {
     readonly name: "openloyalty_segment_delete";
+    readonly title: "Delete Segment (Permanent)";
     readonly description: "Permanently delete a segment. Cannot be undone. Check segment_get_resources first to see what uses this segment.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -761,7 +772,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentDelete;
 }, {
     readonly name: "openloyalty_segment_get_members";
+    readonly title: "Get Segment Members";
     readonly description: "Get members belonging to a segment. Returns paginated list of member details. Use for verifying segment criteria or exporting member lists.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -771,7 +784,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentGetMembers;
 }, {
     readonly name: "openloyalty_segment_activate";
+    readonly title: "Activate Segment";
     readonly description: "Activate a segment. Active segments are used for campaign targeting and can be queried for members.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -779,7 +794,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentActivate;
 }, {
     readonly name: "openloyalty_segment_deactivate";
+    readonly title: "Deactivate Segment";
     readonly description: "Deactivate a segment. Deactivated segments are not used for campaign targeting but retain their configuration.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;
@@ -787,7 +804,9 @@ export declare const segmentToolDefinitions: readonly [{
     readonly handler: typeof segmentDeactivate;
 }, {
     readonly name: "openloyalty_segment_get_resources";
+    readonly title: "Get Segment Resources";
     readonly description: "Get resources (campaigns, rewards, etc.) that use this segment for targeting. Check before deleting a segment.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         segmentId: z.ZodString;

package/dist/tools/segment.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { apiGet, apiPost, apiPut, apiDelete } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const SegmentListInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -79,8 +79,7 @@ export const SegmentGetResourcesInputSchema = {
 };
 // Handler functions
 export async function segmentList(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));
@@ -116,8 +115,7 @@ export async function segmentList(input) {
     }
 }
 export async function segmentCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const segmentPayload = {
         name: input.name,
         parts: input.parts,
@@ -136,8 +134,7 @@ export async function segmentCreate(input) {
     }
 }
 export async function segmentGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/segment/${input.segmentId}`);
         return response;
@@ -147,8 +144,7 @@ export async function segmentGet(input) {
     }
 }
 export async function segmentUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const segmentPayload = {
         name: input.name,
         parts: input.parts,
@@ -166,8 +162,7 @@ export async function segmentUpdate(input) {
     }
 }
 export async function segmentDelete(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiDelete(`/${storeCode}/segment/${input.segmentId}`);
     }
@@ -176,8 +171,7 @@ export async function segmentDelete(input) {
     }
 }
 export async function segmentGetMembers(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));
@@ -209,8 +203,7 @@ export async function segmentGetMembers(input) {
     }
 }
 export async function segmentActivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/segment/${input.segmentId}/activate`, {});
     }
@@ -219,8 +212,7 @@ export async function segmentActivate(input) {
     }
 }
 export async function segmentDeactivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/segment/${input.segmentId}/deactivate`, {});
     }
@@ -229,8 +221,7 @@ export async function segmentDeactivate(input) {
     }
 }
 export async function segmentGetResources(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/segment/${input.segmentId}/resources`);
         const resources = response.items || response.resources || [];
@@ -244,55 +235,74 @@ export async function segmentGetResources(input) {
 export const segmentToolDefinitions = [
     {
         name: "openloyalty_segment_list",
+        title: "List Segments",
         description: "List customer segments. Segments group members by criteria (purchase behavior, tier, location, etc). Use for campaign targeting and analytics.",
+        readOnly: true,
         inputSchema: SegmentListInputSchema,
         handler: segmentList,
     },
     {
         name: "openloyalty_segment_create",
+        title: "Create Segment",
         description: "Create segment to group members. Parts use OR logic (member matches if ANY part matches). Criteria within parts use AND logic (must match ALL criteria in that part). Common criteria: tier, transaction_count, points_balance, country. Example - VIP segment: parts: [{ criteria: [{ type: 'tier', tierIds: ['gold-level-id'] }] }]",
+        readOnly: false,
         inputSchema: SegmentCreateInputSchema,
         handler: segmentCreate,
     },
     {
         name: "openloyalty_segment_get",
+        title: "Get Segment Details",
         description: "Get full segment details including all parts and criteria configurations.",
+        readOnly: true,
         inputSchema: SegmentGetInputSchema,
         handler: segmentGet,
     },
     {
         name: "openloyalty_segment_update",
+        title: "Update Segment",
         description: "Update segment configuration. Requires full segment definition (name, parts with criteria). Use segment_get first to retrieve current configuration.",
+        readOnly: false,
         inputSchema: SegmentUpdateInputSchema,
         handler: segmentUpdate,
     },
     {
         name: "openloyalty_segment_delete",
+        title: "Delete Segment (Permanent)",
         description: "Permanently delete a segment. Cannot be undone. Check segment_get_resources first to see what uses this segment.",
+        readOnly: false,
+        destructive: true,
         inputSchema: SegmentDeleteInputSchema,
         handler: segmentDelete,
     },
     {
         name: "openloyalty_segment_get_members",
+        title: "Get Segment Members",
         description: "Get members belonging to a segment. Returns paginated list of member details. Use for verifying segment criteria or exporting member lists.",
+        readOnly: true,
         inputSchema: SegmentGetMembersInputSchema,
         handler: segmentGetMembers,
     },
     {
         name: "openloyalty_segment_activate",
+        title: "Activate Segment",
         description: "Activate a segment. Active segments are used for campaign targeting and can be queried for members.",
+        readOnly: false,
         inputSchema: SegmentActivateInputSchema,
         handler: segmentActivate,
     },
     {
         name: "openloyalty_segment_deactivate",
+        title: "Deactivate Segment",
         description: "Deactivate a segment. Deactivated segments are not used for campaign targeting but retain their configuration.",
+        readOnly: false,
         inputSchema: SegmentDeactivateInputSchema,
         handler: segmentDeactivate,
     },
     {
         name: "openloyalty_segment_get_resources",
+        title: "Get Segment Resources",
         description: "Get resources (campaigns, rewards, etc.) that use this segment for targeting. Check before deleting a segment.",
+        readOnly: true,
         inputSchema: SegmentGetResourcesInputSchema,
         handler: segmentGetResources,
     },