@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/achievement.js

@@ -1,15 +1,36 @@
 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."),
+    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."),
     name: z.string().optional().describe("Filter by achievement name."),
 };
+// Period type enum for achievements
+// NOTE: "forever" is NOT valid - use "day" with consecutive=1 for all-time tracking
+const AchievementPeriodTypeEnum = z.enum([
+    "day",
+    "week",
+    "month",
+    "year",
+    "last_day",
+    "calendarDays",
+    "calendarWeeks",
+    "calendarMonths",
+    "calendarYears",
+]);
+// Aggregation type enum for achievements
+const AchievementAggregationTypeEnum = z.enum([
+    "quantity",
+    "sum",
+    "average",
+    "min",
+    "max",
+]);
 // Rule input schema
 const AchievementRuleInputSchema = z.object({
     achievementRuleId: z.string().optional().describe("Rule ID (for updates)."),
@@ -17,32 +38,44 @@ const AchievementRuleInputSchema = z.object({
         name: z.string(),
         description: z.string().optional(),
     })).optional().describe("Rule name and description translations."),
-    trigger: z.string().optional().describe("Event type: transaction, custom_event, points_transfer, etc."),
-    type: z.string().optional().describe("Rule type."),
-    event: z.string().optional().describe("Custom event code for custom_event trigger."),
+    trigger: z.enum([
+        "transaction",
+        "custom_event",
+        "points_transfer",
+        "reward_redemption",
+        "referral",
+        "achievement",
+        "tier_change",
+        "registration",
+        "profile_update",
+    ]).optional().describe("Event type that triggers rule progress. For login tracking, use custom_event with a custom 'app_login' event schema."),
+    type: z.enum(["direct", "referral"]).optional().describe("Rule type: direct (default) or referral."),
+    event: z.string().optional().describe("Custom event code (required for trigger='custom_event'). Must match an existing custom event schema."),
     completeRule: z.object({
-        periodGoal: z.union([z.number(), z.string()]).describe("Goal value to reach."),
+        periodGoal: z.union([z.number(), z.string()]).describe("Goal value to reach (e.g., 5 for 5 purchases, 100 for 100 points)."),
         period: z.object({
-            consecutive: z.number().optional(),
-            value: z.number().optional(),
-        }).optional(),
-        uniqueAttribute: z.string().optional(),
+            type: AchievementPeriodTypeEnum.describe("Period type: 'day' (all-time when consecutive=1), 'last_day' (rolling N days), " +
+                "'calendarDays' (reset daily), 'calendarWeeks' (reset weekly), 'calendarMonths' (reset monthly)."),
+            consecutive: z.number().min(1).describe("Required consecutive periods. Use 1 for all-time tracking, 7 for weekly streaks, etc."),
+        }).describe("Period configuration. REQUIRED: both type and consecutive must be provided."),
+        uniqueAttribute: z.string().optional().describe("Attribute for unique counting (e.g., 'sku' to count unique products)."),
     }).describe("Completion goal configuration."),
     aggregation: z.object({
-        rule: z.string().optional(),
-    }).optional().describe("Value aggregation."),
+        type: AchievementAggregationTypeEnum.describe("How to aggregate: 'quantity' (count events), 'sum' (add values), etc."),
+        rule: z.string().optional().describe("Expression for value extraction (e.g., 'transaction.grossValue' for sum of transaction values)."),
+    }).optional().describe("Value aggregation. Use type='quantity' for event counting, type='sum' with rule for value-based goals."),
     conditions: z.array(z.record(z.unknown())).optional().describe("Conditions that must be met."),
     limit: z.object({
-        value: z.number().optional(),
+        value: z.number().optional().describe("Max events per interval (e.g., 1 for once-per-day limit)."),
         interval: z.object({
-            type: z.string(),
-            value: z.number().optional(),
-        }).optional(),
-    }).optional().describe("Per-rule limit."),
-    uniqueReferee: z.boolean().optional().describe("Whether referee must be unique."),
+            type: z.string().describe("Interval type: 'calendarDays', 'calendarWeeks', etc."),
+            value: z.number().optional().describe("Interval value."),
+        }).optional().describe("Time interval for the limit."),
+    }).optional().describe("Per-rule execution limit (use for streak patterns: limit 1 per day)."),
+    uniqueReferee: z.boolean().optional().describe("Whether referee must be unique (for referral achievements)."),
 });
 export const AchievementCreateInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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: z.record(z.string(), z.object({
         name: z.string(),
         description: z.string().optional(),
@@ -64,11 +97,11 @@ export const AchievementCreateInputSchema = {
     badgeTypeId: z.string().optional().describe("Badge type ID to award upon completion."),
 };
 export const AchievementGetInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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."),
     achievementId: z.string().describe("The achievement ID (UUID) to retrieve."),
 };
 export const AchievementUpdateInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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."),
     achievementId: z.string().describe("The achievement ID (UUID) to update."),
     translations: z.record(z.string(), z.object({
         name: z.string(),
@@ -91,7 +124,7 @@ export const AchievementUpdateInputSchema = {
     badgeTypeId: z.string().optional().describe("Badge type ID to award."),
 };
 export const AchievementPatchInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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."),
     achievementId: z.string().describe("The achievement ID (UUID) to patch."),
     active: z.boolean().optional().describe("Whether achievement is active."),
     translations: z.record(z.string(), z.object({
@@ -100,12 +133,12 @@ export const AchievementPatchInputSchema = {
     })).optional().describe("Partial translation updates."),
 };
 export const AchievementGetMemberProgressInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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)."),
     achievementId: z.string().describe("The achievement ID (UUID)."),
 };
 export const AchievementListMemberAchievementsInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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)."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
@@ -114,8 +147,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 +182,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 +205,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 +215,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 +237,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 +252,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 +262,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 +294,60 @@ 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",
-        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 } } }]",
+        title: "Create Achievement",
+        description: "Create achievement with rules that track member progress. Triggers: transaction, custom_event, points_transfer, referral, etc. " +
+            "REQUIRED in each rule: type='direct', completeRule with periodGoal and period (type + consecutive). " +
+            "Example - '5 purchases all-time': rules: [{ type: 'direct', trigger: 'transaction', aggregation: { type: 'quantity' }, completeRule: { periodGoal: 5, period: { type: 'day', consecutive: 1 } } }]. " +
+            "For streaks, use consecutive > 1 with limit: { value: 1, interval: { type: 'calendarDays', value: 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

@@ -87,8 +87,10 @@ export declare function adminChangePassword(input: {
 }): Promise<void>;
 export declare function adminGetPermissions(): Promise<AdminPermission>;
 export declare const adminToolDefinitions: readonly [{
-    readonly name: "openloyalty_admin_list";
+    readonly name: "ol_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>;
@@ -100,8 +102,10 @@ export declare const adminToolDefinitions: readonly [{
     };
     readonly handler: typeof adminList;
 }, {
-    readonly name: "openloyalty_admin_create";
+    readonly name: "ol_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;
@@ -115,15 +119,19 @@ export declare const adminToolDefinitions: readonly [{
     };
     readonly handler: typeof adminCreate;
 }, {
-    readonly name: "openloyalty_admin_get";
+    readonly name: "ol_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 name: "ol_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>;
@@ -138,16 +146,20 @@ export declare const adminToolDefinitions: readonly [{
     };
     readonly handler: typeof adminUpdate;
 }, {
-    readonly name: "openloyalty_admin_change_password";
+    readonly name: "ol_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;
     };
     readonly handler: typeof adminChangePassword;
 }, {
-    readonly name: "openloyalty_admin_get_permissions";
+    readonly name: "ol_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

@@ -65,7 +65,7 @@ export async function adminList(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_list");
+        throw formatApiError(error, "ol_admin_list");
     }
 }
 export async function adminCreate(input) {
@@ -92,7 +92,7 @@ export async function adminCreate(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_create");
+        throw formatApiError(error, "ol_admin_create");
     }
 }
 export async function adminGet(input) {
@@ -101,7 +101,7 @@ export async function adminGet(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_get");
+        throw formatApiError(error, "ol_admin_get");
     }
 }
 export async function adminUpdate(input) {
@@ -129,7 +129,7 @@ export async function adminUpdate(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_update");
+        throw formatApiError(error, "ol_admin_update");
     }
 }
 export async function adminChangePassword(input) {
@@ -140,7 +140,7 @@ export async function adminChangePassword(input) {
         });
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_change_password");
+        throw formatApiError(error, "ol_admin_change_password");
     }
 }
 export async function adminGetPermissions() {
@@ -149,44 +149,56 @@ export async function adminGetPermissions() {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_admin_get_permissions");
+        throw formatApiError(error, "ol_admin_get_permissions");
     }
 }
 // Tool definitions
 export const adminToolDefinitions = [
     {
-        name: "openloyalty_admin_list",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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

@@ -24,7 +24,7 @@ export declare const AnalyticsCampaignsInputSchema: {
 };
 export declare const AnalyticsDashboardInputSchema: {
     storeCode: z.ZodOptional<z.ZodString>;
-    dataType: z.ZodOptional<z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>>;
+    dataType: z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>;
     aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
     intervalStartDate: z.ZodOptional<z.ZodString>;
     intervalEndDate: z.ZodOptional<z.ZodString>;
@@ -83,44 +83,56 @@ export declare function analyticsCampaignDetail(input: {
     campaignId: string;
 }): Promise<Record<string, unknown>>;
 export declare const analyticsToolDefinitions: readonly [{
-    readonly name: "openloyalty_analytics_tiers";
+    readonly name: "ol_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 name: "ol_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>;
     };
     readonly handler: typeof analyticsMembers;
 }, {
-    readonly name: "openloyalty_analytics_points";
+    readonly name: "ol_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 name: "ol_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 name: "ol_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 name: "ol_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>;
@@ -129,19 +141,23 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     readonly handler: typeof analyticsCampaigns;
 }, {
-    readonly name: "openloyalty_analytics_dashboard";
+    readonly name: "ol_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"]>>;
+        dataType: z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>;
         aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
         intervalStartDate: z.ZodOptional<z.ZodString>;
         intervalEndDate: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof analyticsDashboard;
 }, {
-    readonly name: "openloyalty_analytics_units";
+    readonly name: "ol_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;
@@ -152,8 +168,10 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     readonly handler: typeof analyticsUnits;
 }, {
-    readonly name: "openloyalty_analytics_campaign_detail";
+    readonly name: "ol_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;