@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/member/handlers.js

@@ -0,0 +1,206 @@
+import { apiGet, apiPost, apiPut, apiDelete } from "../../client/http.js";
+import { MemberSchema } from "../../types/schemas/member.js";
+import { formatApiError } from "../../utils/errors.js";
+import { getStoreCode } from "../../config.js";
+import { buildPaginationParams } from "../../utils/pagination.js";
+import { omitUndefined } from "../../utils/payload.js";
+export async function memberCreate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
+        email: input.email,
+        firstName: input.firstName,
+        lastName: input.lastName,
+        phone: input.phone,
+        birthDate: input.birthDate,
+        gender: input.gender,
+        loyaltyCardNumber: input.loyaltyCardNumber,
+        agreement1: input.agreement1,
+        agreement2: input.agreement2,
+        agreement3: input.agreement3,
+        address: input.address,
+    });
+    try {
+        const response = await apiPost(`/${storeCode}/member`, { customer: payload });
+        return {
+            memberId: response.customerId,
+            loyaltyCardNumber: response.loyaltyCardNumber || "",
+            email: response.email,
+        };
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_create");
+    }
+}
+export async function memberGet(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        const response = await apiGet(`/${storeCode}/member/${input.memberId}`);
+        // Map API response to our schema
+        const data = response;
+        const mapped = {
+            memberId: data.customerId || data.memberId,
+            email: data.email,
+            firstName: data.firstName,
+            lastName: data.lastName,
+            phone: data.phone,
+            birthDate: data.birthDate,
+            gender: data.gender,
+            loyaltyCardNumber: data.loyaltyCardNumber,
+            active: data.active ?? true,
+            createdAt: data.createdAt,
+            address: data.address,
+            agreement1: data.agreement1,
+            agreement2: data.agreement2,
+            agreement3: data.agreement3,
+            levelId: data.levelId || data.level?.levelId,
+            levelName: data.levelName || data.level?.name,
+            points: data.points,
+        };
+        return MemberSchema.parse(mapped);
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_get");
+    }
+}
+export async function memberList(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const params = new URLSearchParams();
+    // Use buildPaginationParams for cursor/page handling
+    buildPaginationParams({ cursor: input.cursor, page: input.page, perPage: input.perPage }, params);
+    if (input.email)
+        params.append("email", input.email);
+    if (input.firstName)
+        params.append("firstName", input.firstName);
+    if (input.lastName)
+        params.append("lastName", input.lastName);
+    if (input.phone)
+        params.append("phone", input.phone);
+    if (input.loyaltyCardNumber)
+        params.append("loyaltyCardNumber", input.loyaltyCardNumber);
+    if (input.active !== undefined)
+        params.append("active", String(input.active));
+    const queryString = params.toString();
+    const url = `/${storeCode}/member${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        const members = (response.items || []).map((c) => {
+            const customer = c;
+            return {
+                memberId: (customer.customerId || customer.memberId),
+                email: customer.email,
+                firstName: customer.firstName,
+                lastName: customer.lastName,
+                loyaltyCardNumber: customer.loyaltyCardNumber,
+                active: (customer.active ?? true),
+            };
+        });
+        const total = response.total || {};
+        return {
+            members,
+            total: {
+                all: typeof total.all === 'number' ? total.all : undefined,
+                filtered: typeof total.filtered === 'number' ? total.filtered : undefined,
+            },
+            cursor: response.scroll,
+        };
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_list");
+    }
+}
+export async function memberUpdate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    // API requires email even for partial updates - fetch existing member to get it
+    const existingResponse = await apiGet(`/${storeCode}/member/${input.memberId}`);
+    const existingEmail = existingResponse.email;
+    const payload = omitUndefined({
+        email: existingEmail, // Required by API even for partial updates
+        firstName: input.firstName,
+        lastName: input.lastName,
+        phone: input.phone,
+        birthDate: input.birthDate,
+        gender: input.gender,
+        address: input.address,
+        agreement1: input.agreement1,
+        agreement2: input.agreement2,
+        agreement3: input.agreement3,
+    });
+    try {
+        await apiPut(`/${storeCode}/member/${input.memberId}`, { customer: payload });
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_update");
+    }
+}
+export async function memberActivate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiPost(`/${storeCode}/member/${input.memberId}/activate`);
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_activate");
+    }
+}
+export async function memberDeactivate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiPost(`/${storeCode}/member/${input.memberId}/deactivate`);
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_deactivate");
+    }
+}
+export async function memberDelete(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiDelete(`/${storeCode}/member/${input.memberId}`);
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_delete");
+    }
+}
+export async function memberGetTierProgress(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        // API uses /level endpoint, not /tier
+        const response = await apiGet(`/${storeCode}/member/${input.memberId}/level`);
+        // Response may have level data directly or nested
+        const currentLevel = (response.currentLevel || response.level);
+        const nextLevel = response.nextLevel;
+        return {
+            currentTier: currentLevel ? {
+                levelId: (currentLevel.levelId || currentLevel.id),
+                name: currentLevel.name,
+            } : undefined,
+            nextTier: nextLevel ? {
+                levelId: (nextLevel.levelId || nextLevel.id),
+                name: nextLevel.name,
+            } : undefined,
+            currentValue: (response.currentValue || response.value || 0),
+            requiredValue: (response.requiredValue || response.conditionValue),
+            progressPercent: (response.progressPercent || response.progress || 0),
+        };
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_get_tier_progress");
+    }
+}
+export async function memberAssignTier(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiPost(`/${storeCode}/member/${input.memberId}/tier`, { levelId: input.levelId });
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_assign_tier");
+    }
+}
+export async function memberRemoveManualTier(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        // API uses POST to /remove-manually-level, not DELETE to /tier
+        await apiPost(`/${storeCode}/member/${input.memberId}/remove-manually-level`);
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_member_remove_manual_tier");
+    }
+}

package/dist/tools/member/index.d.ts

@@ -0,0 +1,169 @@
+export { MemberCreateInputSchema, MemberGetInputSchema, MemberListInputSchema, MemberUpdateInputSchema, MemberIdInputSchema, MemberAssignTierInputSchema, } from "./schemas.js";
+export { memberCreate, memberGet, memberList, memberUpdate, memberActivate, memberDeactivate, memberDelete, memberGetTierProgress, memberAssignTier, memberRemoveManualTier, } from "./handlers.js";
+import { memberCreate, memberGet, memberList, memberUpdate, memberActivate, memberDeactivate, memberDelete, memberGetTierProgress, memberAssignTier, memberRemoveManualTier } from "./handlers.js";
+export declare const memberToolDefinitions: readonly [{
+    readonly name: "ol_member_create";
+    readonly title: "Register New Member";
+    readonly description: "Register a new loyalty program member. Returns memberId for subsequent operations like points_add or member_get. Email must be unique within the store.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        email: import("zod").ZodString;
+        firstName: import("zod").ZodOptional<import("zod").ZodString>;
+        lastName: import("zod").ZodOptional<import("zod").ZodString>;
+        phone: import("zod").ZodOptional<import("zod").ZodString>;
+        birthDate: import("zod").ZodOptional<import("zod").ZodString>;
+        gender: import("zod").ZodOptional<import("zod").ZodEnum<["male", "female", "not_disclosed"]>>;
+        loyaltyCardNumber: import("zod").ZodOptional<import("zod").ZodString>;
+        agreement1: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        agreement2: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        agreement3: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        address: import("zod").ZodOptional<import("zod").ZodObject<{
+            street: import("zod").ZodOptional<import("zod").ZodString>;
+            city: import("zod").ZodOptional<import("zod").ZodString>;
+            postal: import("zod").ZodOptional<import("zod").ZodString>;
+            country: import("zod").ZodOptional<import("zod").ZodString>;
+            province: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            street?: string | undefined;
+            city?: string | undefined;
+            postal?: string | undefined;
+            country?: string | undefined;
+            province?: string | undefined;
+        }, {
+            street?: string | undefined;
+            city?: string | undefined;
+            postal?: string | undefined;
+            country?: string | undefined;
+            province?: string | undefined;
+        }>>;
+    };
+    readonly handler: typeof memberCreate;
+}, {
+    readonly name: "ol_member_get";
+    readonly title: "Get Member Profile";
+    readonly description: "Get member details including profile, points balance, and tier status. Use memberId from member_create or member_list.";
+    readonly readOnly: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberGet;
+}, {
+    readonly name: "ol_member_list";
+    readonly title: "Search Members";
+    readonly description: string;
+    readonly readOnly: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        cursor: import("zod").ZodOptional<import("zod").ZodString>;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        email: import("zod").ZodOptional<import("zod").ZodString>;
+        firstName: import("zod").ZodOptional<import("zod").ZodString>;
+        lastName: import("zod").ZodOptional<import("zod").ZodString>;
+        phone: import("zod").ZodOptional<import("zod").ZodString>;
+        loyaltyCardNumber: import("zod").ZodOptional<import("zod").ZodString>;
+        active: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    readonly handler: typeof memberList;
+}, {
+    readonly name: "ol_member_update";
+    readonly title: "Update Member Profile";
+    readonly description: "Update member profile fields. Cannot change email. Use member_get first to see current values.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+        firstName: import("zod").ZodOptional<import("zod").ZodString>;
+        lastName: import("zod").ZodOptional<import("zod").ZodString>;
+        phone: import("zod").ZodOptional<import("zod").ZodString>;
+        birthDate: import("zod").ZodOptional<import("zod").ZodString>;
+        gender: import("zod").ZodOptional<import("zod").ZodEnum<["male", "female", "not_disclosed"]>>;
+        address: import("zod").ZodOptional<import("zod").ZodObject<{
+            street: import("zod").ZodOptional<import("zod").ZodString>;
+            city: import("zod").ZodOptional<import("zod").ZodString>;
+            postal: import("zod").ZodOptional<import("zod").ZodString>;
+            country: import("zod").ZodOptional<import("zod").ZodString>;
+            province: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            street?: string | undefined;
+            city?: string | undefined;
+            postal?: string | undefined;
+            country?: string | undefined;
+            province?: string | undefined;
+        }, {
+            street?: string | undefined;
+            city?: string | undefined;
+            postal?: string | undefined;
+            country?: string | undefined;
+            province?: string | undefined;
+        }>>;
+        agreement1: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        agreement2: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        agreement3: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    readonly handler: typeof memberUpdate;
+}, {
+    readonly name: "ol_member_activate";
+    readonly title: "Activate Member Account";
+    readonly description: "Activate a member account. Inactive members cannot earn or spend points.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberActivate;
+}, {
+    readonly name: "ol_member_deactivate";
+    readonly title: "Deactivate Member Account";
+    readonly description: "Deactivate a member account. Deactivated members cannot earn or spend points but retain their balance.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberDeactivate;
+}, {
+    readonly name: "ol_member_delete";
+    readonly title: "Delete Member (Permanent)";
+    readonly description: "Permanently removes member and all associated data. Cannot be undone. Use for GDPR compliance or member requests.";
+    readonly readOnly: false;
+    readonly destructive: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberDelete;
+}, {
+    readonly name: "ol_member_get_tier_progress";
+    readonly title: "Check Tier Progress";
+    readonly description: "Get member tier progression status showing current tier and progress to next. Returns currentValue, requiredValue, and progressPercent.";
+    readonly readOnly: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberGetTierProgress;
+}, {
+    readonly name: "ol_member_assign_tier";
+    readonly title: "Assign Tier to Member";
+    readonly description: "Manually assign a tier level to a member, overriding automatic tier calculation. Use tierset_get_tiers to find available levelId values.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+        levelId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberAssignTier;
+}, {
+    readonly name: "ol_member_remove_manual_tier";
+    readonly title: "Remove Manual Tier Assignment";
+    readonly description: "Remove manually assigned tier from member, restoring automatic tier calculation based on conditions.";
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof memberRemoveManualTier;
+}];

package/dist/tools/member/index.js

@@ -0,0 +1,92 @@
+// Re-export schemas
+export { MemberCreateInputSchema, MemberGetInputSchema, MemberListInputSchema, MemberUpdateInputSchema, MemberIdInputSchema, MemberAssignTierInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { memberCreate, memberGet, memberList, memberUpdate, memberActivate, memberDeactivate, memberDelete, memberGetTierProgress, memberAssignTier, memberRemoveManualTier, } from "./handlers.js";
+// Imports for tool definitions
+import { MemberCreateInputSchema, MemberGetInputSchema, MemberListInputSchema, MemberUpdateInputSchema, MemberIdInputSchema, MemberAssignTierInputSchema, } from "./schemas.js";
+import { memberCreate, memberGet, memberList, memberUpdate, memberActivate, memberDeactivate, memberDelete, memberGetTierProgress, memberAssignTier, memberRemoveManualTier, } from "./handlers.js";
+// Tool definitions
+export const memberToolDefinitions = [
+    {
+        name: "ol_member_create",
+        title: "Register New Member",
+        description: "Register a new loyalty program member. Returns memberId for subsequent operations like points_add or member_get. Email must be unique within the store.",
+        readOnly: false,
+        inputSchema: MemberCreateInputSchema,
+        handler: memberCreate,
+    },
+    {
+        name: "ol_member_get",
+        title: "Get Member Profile",
+        description: "Get member details including profile, points balance, and tier status. Use memberId from member_create or member_list.",
+        readOnly: true,
+        inputSchema: MemberGetInputSchema,
+        handler: memberGet,
+    },
+    {
+        name: "ol_member_list",
+        title: "Search Members",
+        description: "Search and list members with optional filters. Use member_get for full details of a specific member. " +
+            "Supports cursor pagination: provide 'cursor' from previous response to get next page.",
+        readOnly: true,
+        inputSchema: MemberListInputSchema,
+        handler: memberList,
+    },
+    {
+        name: "ol_member_update",
+        title: "Update Member Profile",
+        description: "Update member profile fields. Cannot change email. Use member_get first to see current values.",
+        readOnly: false,
+        inputSchema: MemberUpdateInputSchema,
+        handler: memberUpdate,
+    },
+    {
+        name: "ol_member_activate",
+        title: "Activate Member Account",
+        description: "Activate a member account. Inactive members cannot earn or spend points.",
+        readOnly: false,
+        inputSchema: MemberIdInputSchema,
+        handler: memberActivate,
+    },
+    {
+        name: "ol_member_deactivate",
+        title: "Deactivate Member Account",
+        description: "Deactivate a member account. Deactivated members cannot earn or spend points but retain their balance.",
+        readOnly: false,
+        inputSchema: MemberIdInputSchema,
+        handler: memberDeactivate,
+    },
+    {
+        name: "ol_member_delete",
+        title: "Delete Member (Permanent)",
+        description: "Permanently removes member and all associated data. Cannot be undone. Use for GDPR compliance or member requests.",
+        readOnly: false,
+        destructive: true,
+        inputSchema: MemberIdInputSchema,
+        handler: memberDelete,
+    },
+    {
+        name: "ol_member_get_tier_progress",
+        title: "Check Tier Progress",
+        description: "Get member tier progression status showing current tier and progress to next. Returns currentValue, requiredValue, and progressPercent.",
+        readOnly: true,
+        inputSchema: MemberIdInputSchema,
+        handler: memberGetTierProgress,
+    },
+    {
+        name: "ol_member_assign_tier",
+        title: "Assign Tier to Member",
+        description: "Manually assign a tier level to a member, overriding automatic tier calculation. Use tierset_get_tiers to find available levelId values.",
+        readOnly: false,
+        inputSchema: MemberAssignTierInputSchema,
+        handler: memberAssignTier,
+    },
+    {
+        name: "ol_member_remove_manual_tier",
+        title: "Remove Manual Tier Assignment",
+        description: "Remove manually assigned tier from member, restoring automatic tier calculation based on conditions.",
+        readOnly: false,
+        inputSchema: MemberIdInputSchema,
+        handler: memberRemoveManualTier,
+    },
+];

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const MemberCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    email: z.ZodString;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    birthDate: z.ZodOptional<z.ZodString>;
+    gender: z.ZodOptional<z.ZodEnum<["male", "female", "not_disclosed"]>>;
+    loyaltyCardNumber: z.ZodOptional<z.ZodString>;
+    agreement1: z.ZodOptional<z.ZodBoolean>;
+    agreement2: z.ZodOptional<z.ZodBoolean>;
+    agreement3: z.ZodOptional<z.ZodBoolean>;
+    address: z.ZodOptional<z.ZodObject<{
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postal: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        province: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        street?: string | undefined;
+        city?: string | undefined;
+        postal?: string | undefined;
+        country?: string | undefined;
+        province?: string | undefined;
+    }, {
+        street?: string | undefined;
+        city?: string | undefined;
+        postal?: string | undefined;
+        country?: string | undefined;
+        province?: string | undefined;
+    }>>;
+};
+export declare const MemberGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+};
+export declare const MemberListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    email: z.ZodOptional<z.ZodString>;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    loyaltyCardNumber: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const MemberUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    birthDate: z.ZodOptional<z.ZodString>;
+    gender: z.ZodOptional<z.ZodEnum<["male", "female", "not_disclosed"]>>;
+    address: z.ZodOptional<z.ZodObject<{
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postal: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        province: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        street?: string | undefined;
+        city?: string | undefined;
+        postal?: string | undefined;
+        country?: string | undefined;
+        province?: string | undefined;
+    }, {
+        street?: string | undefined;
+        city?: string | undefined;
+        postal?: string | undefined;
+        country?: string | undefined;
+        province?: string | undefined;
+    }>>;
+    agreement1: z.ZodOptional<z.ZodBoolean>;
+    agreement2: z.ZodOptional<z.ZodBoolean>;
+    agreement3: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const MemberIdInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+};
+export declare const MemberAssignTierInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    levelId: z.ZodString;
+};

package/dist/tools/member/schemas.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export const MemberCreateInputSchema = {
+    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."),
+    email: z.string().describe("Member email address (required, must be unique)."),
+    firstName: z.string().optional().describe("Member first name."),
+    lastName: z.string().optional().describe("Member last name."),
+    phone: z.string().optional().describe("Member phone number."),
+    birthDate: z.string().optional().describe("Member birth date (YYYY-MM-DD format)."),
+    gender: z.enum(["male", "female", "not_disclosed"]).optional().describe("Member gender."),
+    loyaltyCardNumber: z.string().optional().describe("Loyalty card number. Auto-generated if not provided."),
+    agreement1: z.boolean().optional().describe("Terms acceptance."),
+    agreement2: z.boolean().optional().describe("Marketing consent."),
+    agreement3: z.boolean().optional().describe("Additional agreement."),
+    address: z.object({
+        street: z.string().optional(),
+        city: z.string().optional(),
+        postal: z.string().optional(),
+        country: z.string().optional(),
+        province: z.string().optional(),
+    }).optional().describe("Member address."),
+};
+export const MemberGetInputSchema = {
+    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) to retrieve."),
+};
+export const MemberListInputSchema = {
+    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."),
+    cursor: z.string().optional().describe("Pagination cursor from previous response. If provided, page/perPage are ignored."),
+    page: z.number().optional().describe("Page number (default: 1)."),
+    perPage: z.number().optional().describe("Items per page (default: 10)."),
+    email: z.string().optional().describe("Filter by email address."),
+    firstName: z.string().optional().describe("Filter by first name."),
+    lastName: z.string().optional().describe("Filter by last name."),
+    phone: z.string().optional().describe("Filter by phone number."),
+    loyaltyCardNumber: z.string().optional().describe("Filter by loyalty card number."),
+    active: z.boolean().optional().describe("Filter by active status."),
+};
+export const MemberUpdateInputSchema = {
+    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) to update."),
+    firstName: z.string().optional().describe("Member first name."),
+    lastName: z.string().optional().describe("Member last name."),
+    phone: z.string().optional().describe("Member phone number."),
+    birthDate: z.string().optional().describe("Member birth date (YYYY-MM-DD format)."),
+    gender: z.enum(["male", "female", "not_disclosed"]).optional().describe("Member gender."),
+    address: z.object({
+        street: z.string().optional(),
+        city: z.string().optional(),
+        postal: z.string().optional(),
+        country: z.string().optional(),
+        province: z.string().optional(),
+    }).optional().describe("Member address."),
+    agreement1: z.boolean().optional().describe("Terms acceptance."),
+    agreement2: z.boolean().optional().describe("Marketing consent."),
+    agreement3: z.boolean().optional().describe("Additional agreement."),
+};
+export const MemberIdInputSchema = {
+    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)."),
+};
+export const MemberAssignTierInputSchema = {
+    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)."),
+    levelId: z.string().describe("The tier level ID (UUID) to assign."),
+};