@open-loyalty/mcp-server 1.0.3 → 1.3.1

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

@@ -0,0 +1,433 @@
+import { z } from "zod";
+export declare const AchievementListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    name: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+    }>>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    activity: z.ZodOptional<z.ZodObject<{
+        startsAt: z.ZodOptional<z.ZodString>;
+        endsAt: z.ZodOptional<z.ZodString>;
+        operator: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }>>;
+    limit: z.ZodOptional<z.ZodObject<{
+        value: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            value?: number | undefined;
+        }, {
+            type: string;
+            value?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }>>;
+    rules: z.ZodArray<z.ZodObject<{
+        achievementRuleId: z.ZodOptional<z.ZodString>;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>>;
+        trigger: z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "profile_update"]>;
+        type: z.ZodEnum<["direct", "referral"]>;
+        event: z.ZodOptional<z.ZodString>;
+        completeRule: z.ZodObject<{
+            periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            period: z.ZodObject<{
+                type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                value: z.ZodOptional<z.ZodNumber>;
+                consecutive: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            }, {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            }>;
+            uniqueAttribute: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        }, {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        }>;
+        aggregation: z.ZodObject<{
+            type: z.ZodEnum<["quantity"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "quantity";
+        }, {
+            type: "quantity";
+        }>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "direct" | "referral";
+        trigger: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "profile_update";
+        completeRule: {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        };
+        aggregation: {
+            type: "quantity";
+        };
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }, {
+        type: "direct" | "referral";
+        trigger: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "profile_update";
+        completeRule: {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        };
+        aggregation: {
+            type: "quantity";
+        };
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }>, "many">;
+    badgeTypeId: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+};
+export declare const AchievementUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+    translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+    }>>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    activity: z.ZodOptional<z.ZodObject<{
+        startsAt: z.ZodOptional<z.ZodString>;
+        endsAt: z.ZodOptional<z.ZodString>;
+        operator: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }>>;
+    limit: z.ZodOptional<z.ZodObject<{
+        value: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            value?: number | undefined;
+        }, {
+            type: string;
+            value?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }>>;
+    rules: z.ZodArray<z.ZodObject<{
+        achievementRuleId: z.ZodOptional<z.ZodString>;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>>;
+        trigger: z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "profile_update"]>;
+        type: z.ZodEnum<["direct", "referral"]>;
+        event: z.ZodOptional<z.ZodString>;
+        completeRule: z.ZodObject<{
+            periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            period: z.ZodObject<{
+                type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                value: z.ZodOptional<z.ZodNumber>;
+                consecutive: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            }, {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            }>;
+            uniqueAttribute: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        }, {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        }>;
+        aggregation: z.ZodObject<{
+            type: z.ZodEnum<["quantity"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "quantity";
+        }, {
+            type: "quantity";
+        }>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "direct" | "referral";
+        trigger: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "profile_update";
+        completeRule: {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        };
+        aggregation: {
+            type: "quantity";
+        };
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }, {
+        type: "direct" | "referral";
+        trigger: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "profile_update";
+        completeRule: {
+            periodGoal: string | number;
+            period: {
+                type: "day" | "week" | "month" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "year" | "last_day";
+                consecutive: number;
+                value?: number | undefined;
+            };
+            uniqueAttribute?: string | undefined;
+        };
+        aggregation: {
+            type: "quantity";
+        };
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }>, "many">;
+    badgeTypeId: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementPatchInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+    active: z.ZodOptional<z.ZodBoolean>;
+    translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        description?: string | undefined;
+    }, {
+        name?: string | undefined;
+        description?: string | undefined;
+    }>>>;
+};
+export declare const AchievementGetMemberProgressInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    achievementId: z.ZodString;
+};
+export declare const AchievementListMemberAchievementsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodOptional<z.ZodString>;
+};

package/dist/tools/achievement/schemas.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+// 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
+// NOTE: Only "quantity" is currently supported by the API.
+// "sum", "average", "min", "max" are rejected by the API despite being documented.
+const AchievementAggregationTypeEnum = z.enum([
+    "quantity",
+]);
+// Rule input schema
+const AchievementRuleInputSchema = z.object({
+    achievementRuleId: z.string().optional().describe("Rule ID (for updates)."),
+    translations: z.record(z.string(), z.object({
+        name: z.string(),
+        description: z.string().optional(),
+    })).optional().describe("Rule name and description translations."),
+    trigger: z.enum([
+        "transaction",
+        "custom_event",
+        "points_transfer",
+        "reward_redemption",
+        "referral",
+        "achievement",
+        "tier_change",
+        "profile_update",
+    ]).describe("Event type that triggers rule progress. For login tracking, use custom_event with a custom 'app_login' event schema. NOTE: 'registration' and 'login' are NOT supported despite being documented."),
+    type: z.enum(["direct", "referral"]).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 (e.g., 5 for 5 purchases, 100 for 100 points)."),
+        period: z.object({
+            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)."),
+            value: z.number().optional().describe("Period value (e.g., 7 for last 7 days when type='last_day')."),
+            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({
+        type: AchievementAggregationTypeEnum.describe("How to aggregate: 'quantity' (count events). NOTE: Only 'quantity' is supported by the API."),
+    }).describe("Value aggregation. Use type='quantity' for event counting. NOTE: 'sum', 'average', 'min', 'max' are NOT supported by the API."),
+    conditions: z.array(z.record(z.unknown())).optional().describe("Conditions that must be met."),
+    limit: z.object({
+        value: z.number().optional().describe("Max events per interval (e.g., 1 for once-per-day limit)."),
+        interval: z.object({
+            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 AchievementListInputSchema = {
+    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."),
+};
+export const AchievementCreateInputSchema = {
+    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(),
+    })).describe("Achievement name and description. At least 'en' key required."),
+    active: z.boolean().optional().describe("Whether achievement is active (default: false)."),
+    activity: z.object({
+        startsAt: z.string().optional().describe("ISO datetime when achievement becomes active."),
+        endsAt: z.string().optional().describe("ISO datetime when achievement ends."),
+        operator: z.string().optional().describe("Activity condition operator."),
+    }).optional().describe("Time period configuration."),
+    limit: z.object({
+        value: z.number().optional().describe("Maximum completions."),
+        interval: z.object({
+            type: z.string(),
+            value: z.number().optional(),
+        }).optional(),
+    }).optional().describe("Overall limit configuration."),
+    rules: z.array(AchievementRuleInputSchema).describe("Achievement rules defining completion criteria."),
+    badgeTypeId: z.string().optional().describe("Badge type ID to award upon completion. " +
+        "NOTE: This field may cause 'extra fields' validation errors in some API versions. " +
+        "If creation fails, try without badgeTypeId - the system will assign a default badge."),
+};
+export const AchievementGetInputSchema = {
+    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 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(),
+        description: z.string().optional(),
+    })).describe("Achievement name and description."),
+    active: z.boolean().optional().describe("Whether achievement is active."),
+    activity: z.object({
+        startsAt: z.string().optional(),
+        endsAt: z.string().optional(),
+        operator: z.string().optional(),
+    }).optional().describe("Time period configuration."),
+    limit: z.object({
+        value: z.number().optional(),
+        interval: z.object({
+            type: z.string(),
+            value: z.number().optional(),
+        }).optional(),
+    }).optional().describe("Limit configuration."),
+    rules: z.array(AchievementRuleInputSchema).describe("Achievement rules."),
+    badgeTypeId: z.string().optional().describe("Badge type ID to award."),
+};
+export const AchievementPatchInputSchema = {
+    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({
+        name: z.string().optional(),
+        description: z.string().optional(),
+    })).optional().describe("Partial translation updates."),
+};
+export const AchievementGetMemberProgressInputSchema = {
+    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 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)."),
+    name: z.string().optional().describe("Filter by achievement name."),
+    achievementId: z.string().optional().describe("Filter by specific achievement ID."),
+};