@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/member.d.ts

@@ -200,7 +200,9 @@ export declare function memberRemoveManualTier(input: {
 }): Promise<void>;
 export declare const memberToolDefinitions: readonly [{
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         email: z.ZodString;
@@ -236,7 +238,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberCreate;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -244,7 +248,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberGet;
 }, {
     readonly name: "openloyalty_member_list";
+    readonly title: "Search Members";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodString>;
@@ -260,7 +266,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberList;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -295,7 +303,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberUpdate;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -303,7 +313,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberActivate;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -311,7 +323,10 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberDeactivate;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -319,7 +334,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberDelete;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -327,7 +344,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberGetTierProgress;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -336,7 +355,9 @@ export declare const memberToolDefinitions: readonly [{
     readonly handler: typeof memberAssignTier;
 }, {
     readonly name: "openloyalty_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: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;

package/dist/tools/member.js

@@ -2,8 +2,9 @@ import { z } from "zod";
 import { apiGet, apiPost, apiPut, apiDelete } from "../client/http.js";
 import { MemberSchema, } from "../types/schemas/member.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 import { buildPaginationParams } from "../utils/pagination.js";
+import { omitUndefined } from "../utils/payload.js";
 // Input Schemas
 export const MemberCreateInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -71,31 +72,20 @@ export const MemberAssignTierInputSchema = {
 };
 // Handler functions
 export async function memberCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
         email: input.email,
-    };
-    if (input.firstName)
-        payload.firstName = input.firstName;
-    if (input.lastName)
-        payload.lastName = input.lastName;
-    if (input.phone)
-        payload.phone = input.phone;
-    if (input.birthDate)
-        payload.birthDate = input.birthDate;
-    if (input.gender)
-        payload.gender = input.gender;
-    if (input.loyaltyCardNumber)
-        payload.loyaltyCardNumber = input.loyaltyCardNumber;
-    if (input.agreement1 !== undefined)
-        payload.agreement1 = input.agreement1;
-    if (input.agreement2 !== undefined)
-        payload.agreement2 = input.agreement2;
-    if (input.agreement3 !== undefined)
-        payload.agreement3 = input.agreement3;
-    if (input.address)
-        payload.address = input.address;
+        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 {
@@ -109,8 +99,7 @@ export async function memberCreate(input) {
     }
 }
 export async function memberGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/member/${input.memberId}`);
         // Map API response to our schema
@@ -141,8 +130,7 @@ export async function memberGet(input) {
     }
 }
 export async function memberList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    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);
@@ -188,27 +176,18 @@ export async function memberList(input) {
     }
 }
 export async function memberUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {};
-    if (input.firstName)
-        payload.firstName = input.firstName;
-    if (input.lastName)
-        payload.lastName = input.lastName;
-    if (input.phone)
-        payload.phone = input.phone;
-    if (input.birthDate)
-        payload.birthDate = input.birthDate;
-    if (input.gender)
-        payload.gender = input.gender;
-    if (input.address)
-        payload.address = input.address;
-    if (input.agreement1 !== undefined)
-        payload.agreement1 = input.agreement1;
-    if (input.agreement2 !== undefined)
-        payload.agreement2 = input.agreement2;
-    if (input.agreement3 !== undefined)
-        payload.agreement3 = input.agreement3;
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
+        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 });
     }
@@ -217,8 +196,7 @@ export async function memberUpdate(input) {
     }
 }
 export async function memberActivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/member/${input.memberId}/activate`);
     }
@@ -227,8 +205,7 @@ export async function memberActivate(input) {
     }
 }
 export async function memberDeactivate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/member/${input.memberId}/deactivate`);
     }
@@ -237,8 +214,7 @@ export async function memberDeactivate(input) {
     }
 }
 export async function memberDelete(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiDelete(`/${storeCode}/member/${input.memberId}`);
     }
@@ -247,8 +223,7 @@ export async function memberDelete(input) {
     }
 }
 export async function memberGetTierProgress(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/member/${input.memberId}/tier`);
         const currentLevel = response.currentLevel;
@@ -272,8 +247,7 @@ export async function memberGetTierProgress(input) {
     }
 }
 export async function memberAssignTier(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiPost(`/${storeCode}/member/${input.memberId}/tier`, { levelId: input.levelId });
     }
@@ -282,8 +256,7 @@ export async function memberAssignTier(input) {
     }
 }
 export async function memberRemoveManualTier(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    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`);
@@ -296,62 +269,83 @@ export async function memberRemoveManualTier(input) {
 export const memberToolDefinitions = [
     {
         name: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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: "openloyalty_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/points.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import "../types/schemas/points.js";
 export declare const PointsAddInputSchema: {
     storeCode: z.ZodOptional<z.ZodString>;
     memberId: z.ZodString;
@@ -118,8 +119,10 @@ export declare function pointsGetHistogram(input: {
     balance: number;
 }>>;
 export declare const pointsToolDefinitions: readonly [{
-    readonly name: "openloyalty_points_add";
+    readonly name: "ol_points_add";
+    readonly title: "Add Points to Member";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -131,8 +134,10 @@ export declare const pointsToolDefinitions: readonly [{
     };
     readonly handler: typeof pointsAdd;
 }, {
-    readonly name: "openloyalty_points_spend";
+    readonly name: "ol_points_spend";
+    readonly title: "Spend Member Points";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -142,8 +147,10 @@ export declare const pointsToolDefinitions: readonly [{
     };
     readonly handler: typeof pointsSpend;
 }, {
-    readonly name: "openloyalty_points_transfer";
+    readonly name: "ol_points_transfer";
+    readonly title: "Transfer Points Between Members";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         senderId: z.ZodString;
@@ -152,8 +159,10 @@ export declare const pointsToolDefinitions: readonly [{
     };
     readonly handler: typeof pointsTransfer;
 }, {
-    readonly name: "openloyalty_points_get_balance";
+    readonly name: "ol_points_get_balance";
+    readonly title: "Check Points Balance";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -161,8 +170,10 @@ export declare const pointsToolDefinitions: readonly [{
     };
     readonly handler: typeof pointsGetBalance;
 }, {
-    readonly name: "openloyalty_points_get_history";
+    readonly name: "ol_points_get_history";
+    readonly title: "View Points History";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -173,8 +184,10 @@ export declare const pointsToolDefinitions: readonly [{
     };
     readonly handler: typeof pointsGetHistory;
 }, {
-    readonly name: "openloyalty_points_get_histogram";
+    readonly name: "ol_points_get_histogram";
+    readonly title: "View Points Trends";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;