@open-loyalty/mcp-server 1.0.2 → 1.1.0

package/dist/tools/badge.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { apiGet, apiPut } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const BadgeListInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -35,8 +35,7 @@ export const BadgeGetMemberBadgesInputSchema = {
 };
 // Handler functions
 export async function badgeList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -70,8 +69,7 @@ export async function badgeList(input) {
     }
 }
 export async function badgeGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/badge-type/${input.badgeTypeId}`);
         return response;
@@ -81,8 +79,7 @@ export async function badgeGet(input) {
     }
 }
 export async function badgeUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const badgePayload = {};
     if (input.name !== undefined)
         badgePayload.name = input.name;
@@ -101,8 +98,7 @@ export async function badgeUpdate(input) {
     }
 }
 export async function badgeGetMemberBadges(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -140,25 +136,33 @@ export async function badgeGetMemberBadges(input) {
 export const badgeToolDefinitions = [
     {
         name: "openloyalty_badge_list",
+        title: "List Badges",
         description: "List badge types. Badges are visual rewards linked to achievements. When a member completes an achievement with a badgeTypeId, they earn that badge. Use for displaying available badges.",
+        readOnly: true,
         inputSchema: BadgeListInputSchema,
         handler: badgeList,
     },
     {
         name: "openloyalty_badge_get",
+        title: "Get Badge Details",
         description: "Get badge type details including name, image URL, and linked achievements count.",
+        readOnly: true,
         inputSchema: BadgeGetInputSchema,
         handler: badgeGet,
     },
     {
         name: "openloyalty_badge_update",
+        title: "Update Badge",
         description: "Update badge type configuration. Badge types are created automatically when referenced by achievements. Use this to update name, image, or translations.",
+        readOnly: false,
         inputSchema: BadgeUpdateInputSchema,
         handler: badgeUpdate,
     },
     {
         name: "openloyalty_badge_get_member_badges",
+        title: "Get Member Badges",
         description: "Get badges earned by a member. Returns each badge with completedCount showing how many times it was earned. Use for displaying member's badge collection.",
+        readOnly: true,
         inputSchema: BadgeGetMemberBadgesInputSchema,
         handler: badgeGetMemberBadges,
     },

package/dist/tools/campaign.d.ts

@@ -356,20 +356,20 @@ export declare const CampaignSimulateInputSchema: {
         firstName: z.ZodOptional<z.ZodString>;
         lastName: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        id?: string | undefined;
         email?: string | undefined;
-        firstName?: string | undefined;
-        lastName?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        id?: string | undefined;
         customerId?: string | undefined;
     }, {
-        id?: string | undefined;
         email?: string | undefined;
-        firstName?: string | undefined;
-        lastName?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        id?: string | undefined;
         customerId?: string | undefined;
     }>;
     referrer: z.ZodOptional<z.ZodObject<{
@@ -377,13 +377,13 @@ export declare const CampaignSimulateInputSchema: {
         email: z.ZodOptional<z.ZodString>;
         loyaltyCardNumber: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        id?: string | undefined;
         email?: string | undefined;
         loyaltyCardNumber?: string | undefined;
-    }, {
         id?: string | undefined;
+    }, {
         email?: string | undefined;
         loyaltyCardNumber?: string | undefined;
+        id?: string | undefined;
     }>>;
 };
 export declare const CampaignGenerateCodesInputSchema: {
@@ -995,7 +995,9 @@ export declare function campaignCreate(input: CampaignCreateInput): Promise<{
 }>;
 export declare const campaignToolDefinitions: readonly [{
     readonly name: "openloyalty_campaign_list";
+    readonly title: "List Campaigns";
     readonly description: "List all campaigns. Filter by type (direct/referral) or trigger (transaction/custom_event/time/etc). Use campaign_get for full configuration including rules and effects.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -1007,7 +1009,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignList;
 }, {
     readonly name: "openloyalty_campaign_create";
+    readonly title: "Create Campaign";
     readonly description: "Create campaign to automate engagement. Triggers: transaction (purchase-based), custom_event (for custom actions), time (scheduled). Effects: give_points, give_reward, deduct_unit. Rules define when/what happens. Example - Double points: trigger=transaction, effect=give_points with pointsRule containing multiplier:2.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<["direct", "referral"]>;
@@ -1322,7 +1326,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignCreate;
 }, {
     readonly name: "openloyalty_campaign_get";
+    readonly title: "Get Campaign Details";
     readonly description: "Get full campaign configuration including all rules, conditions, effects, and targeting.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1330,7 +1336,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignGet;
 }, {
     readonly name: "openloyalty_campaign_update";
+    readonly title: "Update Campaign";
     readonly description: "Full update of campaign configuration. Requires all campaign fields. Use campaign_get first to retrieve current configuration, modify it, then send the complete object.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1545,7 +1553,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignUpdate;
 }, {
     readonly name: "openloyalty_campaign_patch";
+    readonly title: "Patch Campaign";
     readonly description: "Partial update of campaign - only active status and displayOrder can be patched. For full updates, use campaign_update.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1555,7 +1565,10 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignPatch;
 }, {
     readonly name: "openloyalty_campaign_delete";
+    readonly title: "Delete Campaign (Permanent)";
     readonly description: "Permanently delete a campaign. This cannot be undone. Consider deactivating instead if you may need the campaign later.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1563,7 +1576,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignDelete;
 }, {
     readonly name: "openloyalty_campaign_simulate";
+    readonly title: "Simulate Campaign Effects";
     readonly description: "Simulate campaign effects without executing them. Use to preview what points/rewards a transaction would earn. Provide trigger type, transaction/event data, and customer. Returns simulated effects grouped by campaign.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         trigger: z.ZodEnum<["transaction", "custom_event", "time", "achievement", "custom_event_unique_code", "leaderboard", "internal_event", "return_transaction", "challenge", "fortune_wheel"]>;
@@ -1687,20 +1702,20 @@ export declare const campaignToolDefinitions: readonly [{
             firstName: z.ZodOptional<z.ZodString>;
             lastName: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            id?: string | undefined;
             email?: string | undefined;
-            firstName?: string | undefined;
-            lastName?: string | undefined;
             phone?: string | undefined;
             loyaltyCardNumber?: string | undefined;
+            firstName?: string | undefined;
+            lastName?: string | undefined;
+            id?: string | undefined;
             customerId?: string | undefined;
         }, {
-            id?: string | undefined;
             email?: string | undefined;
-            firstName?: string | undefined;
-            lastName?: string | undefined;
             phone?: string | undefined;
             loyaltyCardNumber?: string | undefined;
+            firstName?: string | undefined;
+            lastName?: string | undefined;
+            id?: string | undefined;
             customerId?: string | undefined;
         }>;
         referrer: z.ZodOptional<z.ZodObject<{
@@ -1708,19 +1723,21 @@ export declare const campaignToolDefinitions: readonly [{
             email: z.ZodOptional<z.ZodString>;
             loyaltyCardNumber: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            id?: string | undefined;
             email?: string | undefined;
             loyaltyCardNumber?: string | undefined;
-        }, {
             id?: string | undefined;
+        }, {
             email?: string | undefined;
             loyaltyCardNumber?: string | undefined;
+            id?: string | undefined;
         }>>;
     };
     readonly handler: typeof campaignSimulate;
 }, {
     readonly name: "openloyalty_campaign_generate_codes";
+    readonly title: "Generate Campaign Codes";
     readonly description: "Generate unique redemption codes for a campaign. Use for promotions requiring unique codes. Codes are auto-generated and can be retrieved with campaign_list_codes.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1729,7 +1746,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignGenerateCodes;
 }, {
     readonly name: "openloyalty_campaign_list_codes";
+    readonly title: "List Campaign Codes";
     readonly description: "List redemption codes for a campaign. Filter by status (active/used) or specific code. Returns code details including usage status.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;
@@ -1741,7 +1760,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignListCodes;
 }, {
     readonly name: "openloyalty_campaign_get_available";
+    readonly title: "Get Available Campaigns for Member";
     readonly description: "Get campaigns available to a specific member. Returns campaigns the member can participate in based on their tier, segments, and campaign targeting rules. Includes limitReached indicator.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -1753,7 +1774,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignGetAvailable;
 }, {
     readonly name: "openloyalty_campaign_get_visible";
+    readonly title: "Get Visible Campaigns for Member";
     readonly description: "Get campaigns visible to a specific member. May include campaigns not yet available (e.g., upcoming campaigns or those requiring certain conditions). Use get_available for campaigns the member can currently participate in.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -1764,7 +1787,9 @@ export declare const campaignToolDefinitions: readonly [{
     readonly handler: typeof campaignGetVisible;
 }, {
     readonly name: "openloyalty_campaign_get_leaderboard";
+    readonly title: "Get Campaign Leaderboard";
     readonly description: "Get leaderboard rankings for a campaign. Returns ranked list of members with scores and positions. Use for leaderboard-type campaigns to show competition standings.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         campaignId: z.ZodString;

package/dist/tools/campaign.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { apiGet, apiPost, apiPut, apiPatch, apiDelete } from "../client/http.js";
 import { CampaignTypeEnum, CampaignTriggerEnum, } from "../types/schemas/campaign.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const CampaignListInputSchema = {
     storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
@@ -252,8 +252,7 @@ export const CampaignCreateInputSchema = {
 };
 // Handler functions
 export async function campaignList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -307,8 +306,7 @@ export async function campaignList(input) {
     }
 }
 export async function campaignGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/campaign/${input.campaignId}`);
         return response;
@@ -318,8 +316,7 @@ export async function campaignGet(input) {
     }
 }
 export async function campaignUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const campaignId = input.campaignId;
     // Build campaign payload excluding storeCode and campaignId
     const { storeCode: _sc, campaignId: _cid, ...campaignPayload } = input;
@@ -332,8 +329,7 @@ export async function campaignUpdate(input) {
     }
 }
 export async function campaignPatch(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const patchPayload = {};
     if (input.active !== undefined)
         patchPayload.active = input.active;
@@ -347,8 +343,7 @@ export async function campaignPatch(input) {
     }
 }
 export async function campaignDelete(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         await apiDelete(`/${storeCode}/campaign/${input.campaignId}`);
     }
@@ -357,8 +352,7 @@ export async function campaignDelete(input) {
     }
 }
 export async function campaignSimulate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // Build the simulate payload
     const simulatePayload = {
         trigger: input.trigger,
@@ -453,8 +447,7 @@ export async function campaignSimulate(input) {
     }
 }
 export async function campaignGenerateCodes(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         // Body wrapped as { generate: { numberOfCodes } }
         await apiPost(`/${storeCode}/campaign/${input.campaignId}/codes/generate`, { generate: { numberOfCodes: input.quantity } });
@@ -466,8 +459,7 @@ export async function campaignGenerateCodes(input) {
     }
 }
 export async function campaignListCodes(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -503,8 +495,7 @@ export async function campaignListCodes(input) {
     }
 }
 export async function campaignGetAvailable(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -541,8 +532,7 @@ export async function campaignGetAvailable(input) {
     }
 }
 export async function campaignGetVisible(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -576,8 +566,7 @@ export async function campaignGetVisible(input) {
     }
 }
 export async function campaignGetLeaderboard(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.type)
         params.append("type", input.type);
@@ -614,8 +603,7 @@ export async function campaignGetLeaderboard(input) {
     }
 }
 export async function campaignCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // Build the campaign payload
     const campaignPayload = {
         type: input.type,
@@ -651,73 +639,98 @@ export async function campaignCreate(input) {
 export const campaignToolDefinitions = [
     {
         name: "openloyalty_campaign_list",
+        title: "List Campaigns",
         description: "List all campaigns. Filter by type (direct/referral) or trigger (transaction/custom_event/time/etc). Use campaign_get for full configuration including rules and effects.",
+        readOnly: true,
         inputSchema: CampaignListInputSchema,
         handler: campaignList,
     },
     {
         name: "openloyalty_campaign_create",
+        title: "Create Campaign",
         description: "Create campaign to automate engagement. Triggers: transaction (purchase-based), custom_event (for custom actions), time (scheduled). Effects: give_points, give_reward, deduct_unit. Rules define when/what happens. Example - Double points: trigger=transaction, effect=give_points with pointsRule containing multiplier:2.",
+        readOnly: false,
         inputSchema: CampaignCreateInputSchema,
         handler: campaignCreate,
     },
     {
         name: "openloyalty_campaign_get",
+        title: "Get Campaign Details",
         description: "Get full campaign configuration including all rules, conditions, effects, and targeting.",
+        readOnly: true,
         inputSchema: CampaignGetInputSchema,
         handler: campaignGet,
     },
     {
         name: "openloyalty_campaign_update",
+        title: "Update Campaign",
         description: "Full update of campaign configuration. Requires all campaign fields. Use campaign_get first to retrieve current configuration, modify it, then send the complete object.",
+        readOnly: false,
         inputSchema: CampaignUpdateInputSchema,
         handler: campaignUpdate,
     },
     {
         name: "openloyalty_campaign_patch",
+        title: "Patch Campaign",
         description: "Partial update of campaign - only active status and displayOrder can be patched. For full updates, use campaign_update.",
+        readOnly: false,
         inputSchema: CampaignPatchInputSchema,
         handler: campaignPatch,
     },
     {
         name: "openloyalty_campaign_delete",
+        title: "Delete Campaign (Permanent)",
         description: "Permanently delete a campaign. This cannot be undone. Consider deactivating instead if you may need the campaign later.",
+        readOnly: false,
+        destructive: true,
         inputSchema: CampaignDeleteInputSchema,
         handler: campaignDelete,
     },
     {
         name: "openloyalty_campaign_simulate",
+        title: "Simulate Campaign Effects",
         description: "Simulate campaign effects without executing them. Use to preview what points/rewards a transaction would earn. Provide trigger type, transaction/event data, and customer. Returns simulated effects grouped by campaign.",
+        readOnly: true,
         inputSchema: CampaignSimulateInputSchema,
         handler: campaignSimulate,
     },
     {
         name: "openloyalty_campaign_generate_codes",
+        title: "Generate Campaign Codes",
         description: "Generate unique redemption codes for a campaign. Use for promotions requiring unique codes. Codes are auto-generated and can be retrieved with campaign_list_codes.",
+        readOnly: false,
         inputSchema: CampaignGenerateCodesInputSchema,
         handler: campaignGenerateCodes,
     },
     {
         name: "openloyalty_campaign_list_codes",
+        title: "List Campaign Codes",
         description: "List redemption codes for a campaign. Filter by status (active/used) or specific code. Returns code details including usage status.",
+        readOnly: true,
         inputSchema: CampaignListCodesInputSchema,
         handler: campaignListCodes,
     },
     {
         name: "openloyalty_campaign_get_available",
+        title: "Get Available Campaigns for Member",
         description: "Get campaigns available to a specific member. Returns campaigns the member can participate in based on their tier, segments, and campaign targeting rules. Includes limitReached indicator.",
+        readOnly: true,
         inputSchema: CampaignGetAvailableInputSchema,
         handler: campaignGetAvailable,
     },
     {
         name: "openloyalty_campaign_get_visible",
+        title: "Get Visible Campaigns for Member",
         description: "Get campaigns visible to a specific member. May include campaigns not yet available (e.g., upcoming campaigns or those requiring certain conditions). Use get_available for campaigns the member can currently participate in.",
+        readOnly: true,
         inputSchema: CampaignGetVisibleInputSchema,
         handler: campaignGetVisible,
     },
     {
         name: "openloyalty_campaign_get_leaderboard",
+        title: "Get Campaign Leaderboard",
         description: "Get leaderboard rankings for a campaign. Returns ranked list of members with scores and positions. Use for leaderboard-type campaigns to show competition standings.",
+        readOnly: true,
         inputSchema: CampaignGetLeaderboardInputSchema,
         handler: campaignGetLeaderboard,
     },

package/dist/tools/export.d.ts

@@ -70,7 +70,9 @@ export declare function exportDownload(input: {
 }>;
 export declare const exportToolDefinitions: readonly [{
     readonly name: "openloyalty_export_create";
+    readonly title: "Create Data Export";
     readonly description: "Create a new data export. Returns exportId for async tracking. Export types: campaignCode (campaign redemption codes), member (member data), memberTier (member tier assignments), memberSegment (member segment membership), rewardFulfillment (reward fulfillment records). The export runs asynchronously - use export_get to check status and export_download when status is 'done'.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<["campaignCode", "member", "memberTier", "memberSegment", "rewardFulfillment"]>;
@@ -81,7 +83,9 @@ export declare const exportToolDefinitions: readonly [{
     readonly handler: typeof exportCreate;
 }, {
     readonly name: "openloyalty_export_list";
+    readonly title: "List Exports";
     readonly description: "List exports with optional filtering. Returns paginated list of exports with exportId, type, status, createdAt, and finishedAt. Status values: pending, done, failed, error.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -93,7 +97,9 @@ export declare const exportToolDefinitions: readonly [{
     readonly handler: typeof exportList;
 }, {
     readonly name: "openloyalty_export_get";
+    readonly title: "Get Export Details";
     readonly description: "Get export details and status. Returns exportId, type, status, createdAt, finishedAt, exportedRows, and message. Check status before downloading - export must have status 'done'.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         exportId: z.ZodString;
@@ -101,7 +107,9 @@ export declare const exportToolDefinitions: readonly [{
     readonly handler: typeof exportGet;
 }, {
     readonly name: "openloyalty_export_download";
+    readonly title: "Download Export File";
     readonly description: "Download export file content. Returns CSV content. IMPORTANT: Only available when export status is 'done'. Check status with export_get first.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         exportId: z.ZodString;

package/dist/tools/export.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { apiGet, apiPost } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getConfig, getStoreCode } from "../config.js";
 import axios from "axios";
 // Input Schemas
 export const ExportCreateInputSchema = {
@@ -41,8 +41,7 @@ export const ExportDownloadInputSchema = {
 };
 // Handler functions
 export async function exportCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // Build the payload with type-specific wrapper
     // The API expects { [type]: { ...filters, _page?, _itemsOnPage? } }
     const innerPayload = {
@@ -64,8 +63,7 @@ export async function exportCreate(input) {
     }
 }
 export async function exportList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.page)
         params.append("_page", String(input.page));
@@ -88,8 +86,7 @@ export async function exportList(input) {
     }
 }
 export async function exportGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/export/${input.exportId}`);
         return response;
@@ -100,7 +97,7 @@ export async function exportGet(input) {
 }
 export async function exportDownload(input) {
     const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await axios.get(`${config.apiUrl}/${storeCode}/export/${input.exportId}/download`, {
             headers: {
@@ -122,25 +119,33 @@ export async function exportDownload(input) {
 export const exportToolDefinitions = [
     {
         name: "openloyalty_export_create",
+        title: "Create Data Export",
         description: "Create a new data export. Returns exportId for async tracking. Export types: campaignCode (campaign redemption codes), member (member data), memberTier (member tier assignments), memberSegment (member segment membership), rewardFulfillment (reward fulfillment records). The export runs asynchronously - use export_get to check status and export_download when status is 'done'.",
+        readOnly: false,
         inputSchema: ExportCreateInputSchema,
         handler: exportCreate,
     },
     {
         name: "openloyalty_export_list",
+        title: "List Exports",
         description: "List exports with optional filtering. Returns paginated list of exports with exportId, type, status, createdAt, and finishedAt. Status values: pending, done, failed, error.",
+        readOnly: true,
         inputSchema: ExportListInputSchema,
         handler: exportList,
     },
     {
         name: "openloyalty_export_get",
+        title: "Get Export Details",
         description: "Get export details and status. Returns exportId, type, status, createdAt, finishedAt, exportedRows, and message. Check status before downloading - export must have status 'done'.",
+        readOnly: true,
         inputSchema: ExportGetInputSchema,
         handler: exportGet,
     },
     {
         name: "openloyalty_export_download",
+        title: "Download Export File",
         description: "Download export file content. Returns CSV content. IMPORTANT: Only available when export status is 'done'. Check status with export_get first.",
+        readOnly: true,
         inputSchema: ExportDownloadInputSchema,
         handler: exportDownload,
     },

package/dist/tools/import.d.ts

@@ -78,7 +78,9 @@ export declare function importGet(input: {
 }): Promise<ImportDetailsResponse>;
 export declare const importToolDefinitions: readonly [{
     readonly name: "openloyalty_import_create";
+    readonly title: "Create Bulk Import";
     readonly description: "Create a new bulk import from CSV content. Returns importId for async tracking. Import types: member (member data), groupValue (group values), segmentMembers (segment membership), unitTransferAdding (add points), unitTransferSpending (spend points), transaction (transactions), campaignCode (campaign codes), rewardCoupon (reward coupons). CSV format required - provide plain text CSV content.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<["member", "groupValue", "segmentMembers", "unitTransferAdding", "unitTransferSpending", "transaction", "campaignCode", "rewardCoupon"]>;
@@ -88,7 +90,9 @@ export declare const importToolDefinitions: readonly [{
     readonly handler: typeof importCreate;
 }, {
     readonly name: "openloyalty_import_list";
+    readonly title: "List Imports";
     readonly description: "List imports with optional filtering. Returns paginated list of imports with importId, type, uploadedDate, fileName, and status information.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -99,7 +103,9 @@ export declare const importToolDefinitions: readonly [{
     readonly handler: typeof importList;
 }, {
     readonly name: "openloyalty_import_get";
+    readonly title: "Get Import Details";
     readonly description: "Get import details and individual item statuses. Returns paginated list of import items with their success/failure status and error messages.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         importId: z.ZodString;