@open-loyalty/mcp-server 1.1.0 → 1.3.3

package/dist/tools/achievement.js

@@ -4,12 +4,33 @@ import { formatApiError } from "../utils/errors.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)."),
@@ -270,7 +303,10 @@ export const achievementToolDefinitions = [
     {
         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 } } }]",
+        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,

package/dist/tools/admin.d.ts

@@ -87,7 +87,7 @@ 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;
@@ -102,7 +102,7 @@ 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;
@@ -119,7 +119,7 @@ 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;
@@ -128,7 +128,7 @@ export declare const adminToolDefinitions: readonly [{
     };
     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;
@@ -146,7 +146,7 @@ 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;
@@ -156,7 +156,7 @@ export declare const adminToolDefinitions: readonly [{
     };
     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;

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,13 +149,13 @@ 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,
@@ -163,7 +163,7 @@ export const adminToolDefinitions = [
         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,
@@ -171,7 +171,7 @@ export const adminToolDefinitions = [
         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,
@@ -179,7 +179,7 @@ export const adminToolDefinitions = [
         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,
@@ -187,7 +187,7 @@ export const adminToolDefinitions = [
         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,
@@ -195,7 +195,7 @@ export const adminToolDefinitions = [
         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,

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,7 +83,7 @@ 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;
@@ -92,7 +92,7 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     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;
@@ -102,7 +102,7 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     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;
@@ -111,7 +111,7 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     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;
@@ -120,7 +120,7 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     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;
@@ -129,7 +129,7 @@ export declare const analyticsToolDefinitions: readonly [{
     };
     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;
@@ -141,20 +141,20 @@ 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;
@@ -168,7 +168,7 @@ 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;

package/dist/tools/analytics.js

@@ -4,39 +4,39 @@ import { formatApiError } from "../utils/errors.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."),
+    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."),
 };
 export const AnalyticsMembersInputSchema = {
-    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."),
     withTransaction: z.boolean().optional().describe("Filter: true for members with transactions, false for members without, omit for all."),
 };
 export const AnalyticsPointsInputSchema = {
-    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."),
 };
 export const AnalyticsTransactionsInputSchema = {
-    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."),
 };
 export const AnalyticsReferralsInputSchema = {
-    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."),
 };
 export const AnalyticsCampaignsInputSchema = {
-    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: 25)."),
     executedAt: z.string().optional().describe("Filter by execution date (ISO format)."),
 };
 export const AnalyticsDashboardInputSchema = {
-    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."),
     dataType: z.enum([
         "registeredMembers", "activeMembers", "revenue", "avgSpending",
         "transactions", "avgTransactionValue", "avgNumberOfTransactions"
-    ]).optional().describe("Type of data to retrieve."),
+    ]).describe("REQUIRED: Type of data to retrieve. Options: registeredMembers, activeMembers, revenue, avgSpending, transactions, avgTransactionValue, avgNumberOfTransactions."),
     aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
     intervalStartDate: z.string().optional().describe("Start date (YYYY-MM-DD format)."),
     intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
 };
 export const AnalyticsUnitsInputSchema = {
-    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."),
     walletTypeCode: z.string().describe("Wallet type code (e.g., 'default' or 'points')."),
     dataType: z.enum([
         "unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"
@@ -46,7 +46,7 @@ export const AnalyticsUnitsInputSchema = {
     intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
 };
 export const AnalyticsCampaignDetailInputSchema = {
-    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."),
     campaignId: z.string().describe("The campaign ID to get analytics for."),
 };
 // Handler functions
@@ -57,7 +57,7 @@ export async function analyticsTiers(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_tiers");
+        throw formatApiError(error, "ol_analytics_tiers");
     }
 }
 export async function analyticsMembers(input) {
@@ -73,7 +73,7 @@ export async function analyticsMembers(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_members");
+        throw formatApiError(error, "ol_analytics_members");
     }
 }
 export async function analyticsPoints(input) {
@@ -83,7 +83,7 @@ export async function analyticsPoints(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_points");
+        throw formatApiError(error, "ol_analytics_points");
     }
 }
 export async function analyticsTransactions(input) {
@@ -93,7 +93,7 @@ export async function analyticsTransactions(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_transactions");
+        throw formatApiError(error, "ol_analytics_transactions");
     }
 }
 export async function analyticsReferrals(input) {
@@ -103,7 +103,7 @@ export async function analyticsReferrals(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_referrals");
+        throw formatApiError(error, "ol_analytics_referrals");
     }
 }
 export async function analyticsCampaigns(input) {
@@ -122,7 +122,7 @@ export async function analyticsCampaigns(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_campaigns");
+        throw formatApiError(error, "ol_analytics_campaigns");
     }
 }
 export async function analyticsDashboard(input) {
@@ -143,7 +143,7 @@ export async function analyticsDashboard(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_dashboard");
+        throw formatApiError(error, "ol_analytics_dashboard");
     }
 }
 export async function analyticsUnits(input) {
@@ -164,23 +164,24 @@ export async function analyticsUnits(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_units");
+        throw formatApiError(error, "ol_analytics_units");
     }
 }
 export async function analyticsCampaignDetail(input) {
     const storeCode = getStoreCode(input.storeCode);
     try {
-        const response = await apiGet(`/${storeCode}/analytics/campaign/${input.campaignId}`);
+        // API endpoint uses /campaigns (plural) with campaign ID as query param
+        const response = await apiGet(`/${storeCode}/analytics/campaigns?campaignId=${input.campaignId}`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_campaign_detail");
+        throw formatApiError(error, "ol_analytics_campaign_detail");
     }
 }
 // Tool definitions
 export const analyticsToolDefinitions = [
     {
-        name: "openloyalty_analytics_tiers",
+        name: "ol_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,
@@ -188,7 +189,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsTiers,
     },
     {
-        name: "openloyalty_analytics_members",
+        name: "ol_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,
@@ -196,7 +197,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsMembers,
     },
     {
-        name: "openloyalty_analytics_points",
+        name: "ol_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,
@@ -204,7 +205,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsPoints,
     },
     {
-        name: "openloyalty_analytics_transactions",
+        name: "ol_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,
@@ -212,7 +213,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsTransactions,
     },
     {
-        name: "openloyalty_analytics_referrals",
+        name: "ol_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,
@@ -220,7 +221,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsReferrals,
     },
     {
-        name: "openloyalty_analytics_campaigns",
+        name: "ol_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,
@@ -228,7 +229,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsCampaigns,
     },
     {
-        name: "openloyalty_analytics_dashboard",
+        name: "ol_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,
@@ -236,7 +237,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsDashboard,
     },
     {
-        name: "openloyalty_analytics_units",
+        name: "ol_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,
@@ -244,7 +245,7 @@ export const analyticsToolDefinitions = [
         handler: analyticsUnits,
     },
     {
-        name: "openloyalty_analytics_campaign_detail",
+        name: "ol_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,