@open-loyalty/mcp-server 1.0.2 → 1.1.0

package/dist/tools/achievement.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { apiGet, apiPost, apiPut, apiPatch } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const AchievementListInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -114,8 +114,7 @@ export const AchievementListMemberAchievementsInputSchema = {
 };
 // Handler functions
 export async function achievementList(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));
@@ -150,8 +149,7 @@ export async function achievementList(input) {
     }
 }
 export async function achievementCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const achievementPayload = {
         translations: input.translations,
         rules: input.rules,
@@ -174,8 +172,7 @@ export async function achievementCreate(input) {
     }
 }
 export async function achievementGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/achievement/${input.achievementId}`);
         return response;
@@ -185,8 +182,7 @@ export async function achievementGet(input) {
     }
 }
 export async function achievementUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const achievementPayload = {
         translations: input.translations,
         rules: input.rules,
@@ -208,8 +204,7 @@ export async function achievementUpdate(input) {
     }
 }
 export async function achievementPatch(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const achievementPayload = {};
     if (input.active !== undefined)
         achievementPayload.active = input.active;
@@ -224,8 +219,7 @@ export async function achievementPatch(input) {
     }
 }
 export async function achievementGetMemberProgress(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/member/${input.memberId}/achievement/${input.achievementId}`);
         return response;
@@ -235,8 +229,7 @@ export async function achievementGetMemberProgress(input) {
     }
 }
 export async function achievementListMemberAchievements(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));
@@ -268,43 +261,57 @@ export async function achievementListMemberAchievements(input) {
 export const achievementToolDefinitions = [
     {
         name: "openloyalty_achievement_list",
+        title: "List Achievements",
         description: "List achievements. Achievements gamify member behavior by setting goals (e.g., 'Make 5 purchases this month'). Returns achievementId, name, active status, and associated badge. Use achievement_get for full rules and configuration.",
+        readOnly: true,
         inputSchema: AchievementListInputSchema,
         handler: achievementList,
     },
     {
         name: "openloyalty_achievement_create",
+        title: "Create Achievement",
         description: "Create achievement with rules that track member progress. Triggers: transaction (purchases), custom_event (custom actions), points_transfer, referral, etc. CompleteRule sets the goal: periodGoal (target value) with optional period (consecutive periods). Example - '5 purchases/month': rules: [{ trigger: 'transaction', completeRule: { periodGoal: 5, period: { value: 1, consecutive: 1 } } }]",
+        readOnly: false,
         inputSchema: AchievementCreateInputSchema,
         handler: achievementCreate,
     },
     {
         name: "openloyalty_achievement_get",
+        title: "Get Achievement Details",
         description: "Get achievement details including all rules, conditions, activity period, limits, and completions count.",
+        readOnly: true,
         inputSchema: AchievementGetInputSchema,
         handler: achievementGet,
     },
     {
         name: "openloyalty_achievement_update",
+        title: "Update Achievement",
         description: "Update achievement configuration. Requires full achievement object (translations, rules). Use achievement_get first to retrieve current configuration.",
+        readOnly: false,
         inputSchema: AchievementUpdateInputSchema,
         handler: achievementUpdate,
     },
     {
         name: "openloyalty_achievement_patch",
+        title: "Patch Achievement",
         description: "Partial update of achievement. Use for simple changes like activating/deactivating or updating translations without providing full rules.",
+        readOnly: false,
         inputSchema: AchievementPatchInputSchema,
         handler: achievementPatch,
     },
     {
         name: "openloyalty_achievement_get_member_progress",
+        title: "Get Member Achievement Progress",
         description: "Get member's progress on a specific achievement. Returns completedCount, and for each rule: periodGoal, currentPeriodValue, and consecutive period tracking.",
+        readOnly: true,
         inputSchema: AchievementGetMemberProgressInputSchema,
         handler: achievementGetMemberProgress,
     },
     {
         name: "openloyalty_achievement_list_member_achievements",
+        title: "List Member Achievements",
         description: "List all achievements with member's progress. Returns each achievement's status, completion count, and per-rule progress. Use for displaying gamification dashboard.",
+        readOnly: true,
         inputSchema: AchievementListMemberAchievementsInputSchema,
         handler: achievementListMemberAchievements,
     },

package/dist/tools/admin.d.ts

@@ -88,7 +88,9 @@ export declare function adminChangePassword(input: {
 export declare function adminGetPermissions(): Promise<AdminPermission>;
 export declare const adminToolDefinitions: readonly [{
     readonly name: "openloyalty_admin_list";
+    readonly title: "List Admin Users";
     readonly description: "List admin users with optional filtering. Returns paginated list of admin users with id, email, firstName, lastName, isActive, createdAt.";
+    readonly readOnly: true;
     readonly inputSchema: {
         page: z.ZodOptional<z.ZodNumber>;
         perPage: z.ZodOptional<z.ZodNumber>;
@@ -101,7 +103,9 @@ export declare const adminToolDefinitions: readonly [{
     readonly handler: typeof adminList;
 }, {
     readonly name: "openloyalty_admin_create";
+    readonly title: "Create Admin User";
     readonly description: "Create a new admin user. Requires email and password. Optionally assign roles, set active status, and configure notifications. Returns adminId.";
+    readonly readOnly: false;
     readonly inputSchema: {
         email: z.ZodString;
         password: z.ZodString;
@@ -116,14 +120,18 @@ export declare const adminToolDefinitions: readonly [{
     readonly handler: typeof adminCreate;
 }, {
     readonly name: "openloyalty_admin_get";
+    readonly title: "Get Admin User Details";
     readonly description: "Get full admin user details by ID. Returns profile including email, name, roles, settings, active status, and creation date.";
+    readonly readOnly: true;
     readonly inputSchema: {
         adminId: z.ZodString;
     };
     readonly handler: typeof adminGet;
 }, {
     readonly name: "openloyalty_admin_update";
+    readonly title: "Update Admin User";
     readonly description: "Update admin user profile. Can update email, name, phone, roles, active status, and password. Returns adminId on success.";
+    readonly readOnly: false;
     readonly inputSchema: {
         adminId: z.ZodString;
         email: z.ZodOptional<z.ZodString>;
@@ -139,7 +147,9 @@ export declare const adminToolDefinitions: readonly [{
     readonly handler: typeof adminUpdate;
 }, {
     readonly name: "openloyalty_admin_change_password";
+    readonly title: "Change Admin Password";
     readonly description: "Change the currently logged-in admin's password. Requires current password for verification. Returns void on success.";
+    readonly readOnly: false;
     readonly inputSchema: {
         currentPassword: z.ZodString;
         newPassword: z.ZodString;
@@ -147,7 +157,9 @@ export declare const adminToolDefinitions: readonly [{
     readonly handler: typeof adminChangePassword;
 }, {
     readonly name: "openloyalty_admin_get_permissions";
+    readonly title: "Get Admin Permissions";
     readonly description: "Get the current admin user's permissions. Returns superAdmin flag, list of roles, and list of permission strings. Use to check what actions are available.";
+    readonly readOnly: true;
     readonly inputSchema: {};
     readonly handler: typeof adminGetPermissions;
 }];

package/dist/tools/admin.js

@@ -156,37 +156,49 @@ export async function adminGetPermissions() {
 export const adminToolDefinitions = [
     {
         name: "openloyalty_admin_list",
+        title: "List Admin Users",
         description: "List admin users with optional filtering. Returns paginated list of admin users with id, email, firstName, lastName, isActive, createdAt.",
+        readOnly: true,
         inputSchema: AdminListInputSchema,
         handler: adminList,
     },
     {
         name: "openloyalty_admin_create",
+        title: "Create Admin User",
         description: "Create a new admin user. Requires email and password. Optionally assign roles, set active status, and configure notifications. Returns adminId.",
+        readOnly: false,
         inputSchema: AdminCreateInputSchema,
         handler: adminCreate,
     },
     {
         name: "openloyalty_admin_get",
+        title: "Get Admin User Details",
         description: "Get full admin user details by ID. Returns profile including email, name, roles, settings, active status, and creation date.",
+        readOnly: true,
         inputSchema: AdminGetInputSchema,
         handler: adminGet,
     },
     {
         name: "openloyalty_admin_update",
+        title: "Update Admin User",
         description: "Update admin user profile. Can update email, name, phone, roles, active status, and password. Returns adminId on success.",
+        readOnly: false,
         inputSchema: AdminUpdateInputSchema,
         handler: adminUpdate,
     },
     {
         name: "openloyalty_admin_change_password",
+        title: "Change Admin Password",
         description: "Change the currently logged-in admin's password. Requires current password for verification. Returns void on success.",
+        readOnly: false,
         inputSchema: AdminChangePasswordInputSchema,
         handler: adminChangePassword,
     },
     {
         name: "openloyalty_admin_get_permissions",
+        title: "Get Admin Permissions",
         description: "Get the current admin user's permissions. Returns superAdmin flag, list of roles, and list of permission strings. Use to check what actions are available.",
+        readOnly: true,
         inputSchema: {},
         handler: adminGetPermissions,
     },

package/dist/tools/analytics.d.ts

@@ -84,14 +84,18 @@ export declare function analyticsCampaignDetail(input: {
 }): Promise<Record<string, unknown>>;
 export declare const analyticsToolDefinitions: readonly [{
     readonly name: "openloyalty_analytics_tiers";
+    readonly title: "Get Tier Analytics";
     readonly description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof analyticsTiers;
 }, {
     readonly name: "openloyalty_analytics_members";
+    readonly title: "Get Member Analytics";
     readonly description: "Get member analytics showing registration trends. Returns member counts by time intervals (1 day, 7 days, 30 days, 365 days). Filter by transaction status to see engaged vs unengaged members.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         withTransaction: z.ZodOptional<z.ZodBoolean>;
@@ -99,28 +103,36 @@ export declare const analyticsToolDefinitions: readonly [{
     readonly handler: typeof analyticsMembers;
 }, {
     readonly name: "openloyalty_analytics_points";
+    readonly title: "Get Points Analytics";
     readonly description: "Get points analytics showing program health. Returns total active points, points spent, points issued, expired points, and pending points. Use to monitor points economy.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof analyticsPoints;
 }, {
     readonly name: "openloyalty_analytics_transactions";
+    readonly title: "Get Transaction Analytics";
     readonly description: "Get transaction analytics showing purchase trends. Returns transaction counts by intervals, total count, total amount, and average values. Use to monitor sales performance.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof analyticsTransactions;
 }, {
     readonly name: "openloyalty_analytics_referrals";
+    readonly title: "Get Referral Analytics";
     readonly description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof analyticsReferrals;
 }, {
     readonly name: "openloyalty_analytics_campaigns";
+    readonly title: "Get Campaign Analytics";
     readonly description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -130,7 +142,9 @@ export declare const analyticsToolDefinitions: readonly [{
     readonly handler: typeof analyticsCampaigns;
 }, {
     readonly name: "openloyalty_analytics_dashboard";
+    readonly title: "Get Dashboard Overview";
     readonly description: "Get dashboard overview metrics with time-series data. Returns key metrics (registered members, active members, revenue, avg spending, transactions) with optional date range and aggregation. Use for high-level program dashboards.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         dataType: z.ZodOptional<z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>>;
@@ -141,7 +155,9 @@ export declare const analyticsToolDefinitions: readonly [{
     readonly handler: typeof analyticsDashboard;
 }, {
     readonly name: "openloyalty_analytics_units";
+    readonly title: "Get Units Overview";
     readonly description: "Get wallet-specific analytics (units overview). Returns units issued, spent, expired, pending, active, plus redemption and breakage rates. Requires walletTypeCode parameter. Use for detailed points economy analysis.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         walletTypeCode: z.ZodString;
@@ -153,7 +169,9 @@ export declare const analyticsToolDefinitions: readonly [{
     readonly handler: typeof analyticsUnits;
 }, {
     readonly name: "openloyalty_analytics_campaign_detail";
+    readonly title: "Get Campaign Detail Analytics";
     readonly description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;

package/dist/tools/analytics.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { apiGet } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const AnalyticsTiersInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -51,8 +51,7 @@ export const AnalyticsCampaignDetailInputSchema = {
 };
 // Handler functions
 export async function analyticsTiers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/levels`);
         return response;
@@ -62,8 +61,7 @@ export async function analyticsTiers(input) {
     }
 }
 export async function analyticsMembers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.withTransaction !== undefined) {
         params.append("withTransaction", String(input.withTransaction));
@@ -79,8 +77,7 @@ export async function analyticsMembers(input) {
     }
 }
 export async function analyticsPoints(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/points`);
         return response;
@@ -90,8 +87,7 @@ export async function analyticsPoints(input) {
     }
 }
 export async function analyticsTransactions(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/transactions`);
         return response;
@@ -101,8 +97,7 @@ export async function analyticsTransactions(input) {
     }
 }
 export async function analyticsReferrals(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/referrals`);
         return response;
@@ -112,8 +107,7 @@ export async function analyticsReferrals(input) {
     }
 }
 export async function analyticsCampaigns(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));
@@ -132,8 +126,7 @@ export async function analyticsCampaigns(input) {
     }
 }
 export async function analyticsDashboard(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.dataType)
         params.append("dataType", input.dataType);
@@ -154,8 +147,7 @@ export async function analyticsDashboard(input) {
     }
 }
 export async function analyticsUnits(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.dataType)
         params.append("dataType", input.dataType);
@@ -176,8 +168,7 @@ export async function analyticsUnits(input) {
     }
 }
 export async function analyticsCampaignDetail(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/campaign/${input.campaignId}`);
         return response;
@@ -190,55 +181,73 @@ export async function analyticsCampaignDetail(input) {
 export const analyticsToolDefinitions = [
     {
         name: "openloyalty_analytics_tiers",
+        title: "Get Tier Analytics",
         description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.",
+        readOnly: true,
         inputSchema: AnalyticsTiersInputSchema,
         handler: analyticsTiers,
     },
     {
         name: "openloyalty_analytics_members",
+        title: "Get Member Analytics",
         description: "Get member analytics showing registration trends. Returns member counts by time intervals (1 day, 7 days, 30 days, 365 days). Filter by transaction status to see engaged vs unengaged members.",
+        readOnly: true,
         inputSchema: AnalyticsMembersInputSchema,
         handler: analyticsMembers,
     },
     {
         name: "openloyalty_analytics_points",
+        title: "Get Points Analytics",
         description: "Get points analytics showing program health. Returns total active points, points spent, points issued, expired points, and pending points. Use to monitor points economy.",
+        readOnly: true,
         inputSchema: AnalyticsPointsInputSchema,
         handler: analyticsPoints,
     },
     {
         name: "openloyalty_analytics_transactions",
+        title: "Get Transaction Analytics",
         description: "Get transaction analytics showing purchase trends. Returns transaction counts by intervals, total count, total amount, and average values. Use to monitor sales performance.",
+        readOnly: true,
         inputSchema: AnalyticsTransactionsInputSchema,
         handler: analyticsTransactions,
     },
     {
         name: "openloyalty_analytics_referrals",
+        title: "Get Referral Analytics",
         description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.",
+        readOnly: true,
         inputSchema: AnalyticsReferralsInputSchema,
         handler: analyticsReferrals,
     },
     {
         name: "openloyalty_analytics_campaigns",
+        title: "Get Campaign Analytics",
         description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.",
+        readOnly: true,
         inputSchema: AnalyticsCampaignsInputSchema,
         handler: analyticsCampaigns,
     },
     {
         name: "openloyalty_analytics_dashboard",
+        title: "Get Dashboard Overview",
         description: "Get dashboard overview metrics with time-series data. Returns key metrics (registered members, active members, revenue, avg spending, transactions) with optional date range and aggregation. Use for high-level program dashboards.",
+        readOnly: true,
         inputSchema: AnalyticsDashboardInputSchema,
         handler: analyticsDashboard,
     },
     {
         name: "openloyalty_analytics_units",
+        title: "Get Units Overview",
         description: "Get wallet-specific analytics (units overview). Returns units issued, spent, expired, pending, active, plus redemption and breakage rates. Requires walletTypeCode parameter. Use for detailed points economy analysis.",
+        readOnly: true,
         inputSchema: AnalyticsUnitsInputSchema,
         handler: analyticsUnits,
     },
     {
         name: "openloyalty_analytics_campaign_detail",
+        title: "Get Campaign Detail Analytics",
         description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.",
+        readOnly: true,
         inputSchema: AnalyticsCampaignDetailInputSchema,
         handler: analyticsCampaignDetail,
     },

package/dist/tools/apikey.d.ts

@@ -45,7 +45,9 @@ export declare function apiKeyDelete(input: {
 }): Promise<void>;
 export declare const apiKeyToolDefinitions: readonly [{
     readonly name: "openloyalty_apikey_create";
+    readonly title: "Create API Key";
     readonly description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.";
+    readonly readOnly: false;
     readonly inputSchema: {
         adminId: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -54,7 +56,9 @@ export declare const apiKeyToolDefinitions: readonly [{
     readonly handler: typeof apiKeyCreate;
 }, {
     readonly name: "openloyalty_apikey_list";
+    readonly title: "List API Keys";
     readonly description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.";
+    readonly readOnly: true;
     readonly inputSchema: {
         adminId: z.ZodString;
         page: z.ZodOptional<z.ZodNumber>;
@@ -63,7 +67,10 @@ export declare const apiKeyToolDefinitions: readonly [{
     readonly handler: typeof apiKeyList;
 }, {
     readonly name: "openloyalty_apikey_delete";
+    readonly title: "Delete API Key (Permanent)";
     readonly description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         adminId: z.ZodString;
         apiKeyId: z.ZodString;

package/dist/tools/apikey.js

@@ -59,19 +59,26 @@ export async function apiKeyDelete(input) {
 export const apiKeyToolDefinitions = [
     {
         name: "openloyalty_apikey_create",
+        title: "Create API Key",
         description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.",
+        readOnly: false,
         inputSchema: ApiKeyCreateInputSchema,
         handler: apiKeyCreate,
     },
     {
         name: "openloyalty_apikey_list",
+        title: "List API Keys",
         description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.",
+        readOnly: true,
         inputSchema: ApiKeyListInputSchema,
         handler: apiKeyList,
     },
     {
         name: "openloyalty_apikey_delete",
+        title: "Delete API Key (Permanent)",
         description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.",
+        readOnly: false,
+        destructive: true,
         inputSchema: ApiKeyDeleteInputSchema,
         handler: apiKeyDelete,
     },

package/dist/tools/audit.d.ts

@@ -81,7 +81,9 @@ export declare function auditExport(input: {
 }>;
 export declare const auditToolDefinitions: readonly [{
     readonly name: "openloyalty_audit_list";
+    readonly title: "List Audit Logs";
     readonly description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.";
+    readonly readOnly: true;
     readonly inputSchema: {
         page: z.ZodOptional<z.ZodNumber>;
         perPage: z.ZodOptional<z.ZodNumber>;
@@ -96,7 +98,9 @@ export declare const auditToolDefinitions: readonly [{
     readonly handler: typeof auditList;
 }, {
     readonly name: "openloyalty_audit_export";
+    readonly title: "Export Audit Logs";
     readonly description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.";
+    readonly readOnly: false;
     readonly inputSchema: {
         dateFrom: z.ZodOptional<z.ZodString>;
         dateTo: z.ZodOptional<z.ZodString>;

package/dist/tools/audit.js

@@ -77,13 +77,17 @@ export async function auditExport(input) {
 export const auditToolDefinitions = [
     {
         name: "openloyalty_audit_list",
+        title: "List Audit Logs",
         description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.",
+        readOnly: true,
         inputSchema: AuditListInputSchema,
         handler: auditList,
     },
     {
         name: "openloyalty_audit_export",
+        title: "Export Audit Logs",
         description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.",
+        readOnly: false,
         inputSchema: AuditExportInputSchema,
         handler: auditExport,
     },

package/dist/tools/badge.d.ts

@@ -81,7 +81,9 @@ export declare function badgeGetMemberBadges(input: {
 }>;
 export declare const badgeToolDefinitions: readonly [{
     readonly name: "openloyalty_badge_list";
+    readonly title: "List Badges";
     readonly description: "List badge types. Badges are visual rewards linked to achievements. When a member completes an achievement with a badgeTypeId, they earn that badge. Use for displaying available badges.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -92,7 +94,9 @@ export declare const badgeToolDefinitions: readonly [{
     readonly handler: typeof badgeList;
 }, {
     readonly name: "openloyalty_badge_get";
+    readonly title: "Get Badge Details";
     readonly description: "Get badge type details including name, image URL, and linked achievements count.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         badgeTypeId: z.ZodString;
@@ -100,7 +104,9 @@ export declare const badgeToolDefinitions: readonly [{
     readonly handler: typeof badgeGet;
 }, {
     readonly name: "openloyalty_badge_update";
+    readonly title: "Update Badge";
     readonly description: "Update badge type configuration. Badge types are created automatically when referenced by achievements. Use this to update name, image, or translations.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         badgeTypeId: z.ZodString;
@@ -121,7 +127,9 @@ export declare const badgeToolDefinitions: readonly [{
     readonly handler: typeof badgeUpdate;
 }, {
     readonly name: "openloyalty_badge_get_member_badges";
+    readonly title: "Get Member Badges";
     readonly description: "Get badges earned by a member. Returns each badge with completedCount showing how many times it was earned. Use for displaying member's badge collection.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;