@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/tierset.js

@@ -2,21 +2,22 @@ import { z } from "zod";
 import { apiGet, apiPost, apiPut } from "../client/http.js";
 import { TierSetSchema, TierSetListResponseSchema, TierListResponseSchema, TierSetAttributeEnum, DowngradeModeEnum, } from "../types/schemas/tierset.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 import { buildPaginationQuery } from "../utils/pagination.js";
 export const TierSetListInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     page: z.number().optional().describe("Page number for pagination (starts at 1)."),
     perPage: z.number().optional().describe("Number of items per page."),
 };
 export const TierSetCreateInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     name: z.string().describe("Name of the tier set."),
     description: z.string().optional().describe("Description of the tier set."),
     conditions: z.array(z.object({
-        attribute: TierSetAttributeEnum.describe("The attribute to use for this condition."),
-        walletType: z.string().optional().describe("Wallet type code (required for unit-based attributes like activeUnits). Get this from wallet_type_list."),
-    })).describe("Array of conditions that define tier progression criteria."),
+        attribute: TierSetAttributeEnum.describe("The attribute to use for this condition (use `attribute`, not `type`)."),
+        walletType: z.string().optional().describe("Wallet type CODE (not UUID). Required for unit-based attributes like activeUnits. " +
+            "Use wallet_type_list to find walletType.code (e.g., 'default')."),
+    })).describe("Array of conditions that define tier progression criteria. Each condition uses `attribute` + optional `walletType`."),
     downgrade: z.object({
         mode: DowngradeModeEnum.describe("Downgrade mode."),
         days: z.number().optional().describe("Number of days for x_days mode (required if mode is x_days)."),
@@ -24,11 +25,11 @@ export const TierSetCreateInputSchema = {
     active: z.boolean().optional().describe("Whether the tier set is active. Defaults to true."),
 };
 export const TierSetGetInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     tierSetId: z.string().describe("The tier set ID to retrieve."),
 };
 export const TierSetUpdateInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     tierSetId: z.string().describe("The tier set ID to update."),
     name: z.string().optional().describe("New name for the tier set."),
     description: z.string().optional().describe("New description for the tier set."),
@@ -39,7 +40,7 @@ export const TierSetUpdateInputSchema = {
     }).optional().describe("Downgrade configuration."),
 };
 export const TierSetUpdateTiersInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     tierSetId: z.string().describe("The tier set ID to update tiers for."),
     tiers: z.array(z.object({
         levelId: z.string().optional().describe("Existing level ID (for updates). Omit for new tiers."),
@@ -53,12 +54,11 @@ export const TierSetUpdateTiersInputSchema = {
     })).describe("Array of tier definitions."),
 };
 export const TierSetGetTiersInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     tierSetId: z.string().describe("The tier set ID to get tiers for."),
 };
 export async function tiersetList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const query = buildPaginationQuery({
         page: input.page,
         perPage: input.perPage,
@@ -80,12 +80,11 @@ export async function tiersetList(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_list");
+        throw formatApiError(error, "ol_tierset_list");
     }
 }
 export async function tiersetCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // API requires tierSet wrapper with translations (at least en is required)
     const payload = {
         tierSet: {
@@ -112,24 +111,22 @@ export async function tiersetCreate(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_create");
+        throw formatApiError(error, "ol_tierset_create");
     }
 }
 export async function tiersetGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/tierSet/${input.tierSetId}`);
         const validated = TierSetSchema.parse(response);
         return validated;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_get");
+        throw formatApiError(error, "ol_tierset_get");
     }
 }
 export async function tiersetUpdate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // API requires tierSet wrapper with translations (at least en is required)
     const tierSetPayload = {};
     // If name or description is provided, wrap in translations
@@ -149,12 +146,11 @@ export async function tiersetUpdate(input) {
         await apiPut(`/${storeCode}/tierSet/${input.tierSetId}`, { tierSet: tierSetPayload });
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_update");
+        throw formatApiError(error, "ol_tierset_update");
     }
 }
 export async function tiersetUpdateTiers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // API requires translations (at least en is required)
     const payload = {
         tiers: input.tiers.map((tier) => ({
@@ -176,12 +172,11 @@ export async function tiersetUpdateTiers(input) {
         await apiPut(`/${storeCode}/tierSet/${input.tierSetId}/tiers`, payload);
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_update_tiers");
+        throw formatApiError(error, "ol_tierset_update_tiers");
     }
 }
 export async function tiersetGetTiers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/tierSet/${input.tierSetId}/tiers`);
         const validated = TierListResponseSchema.parse(response);
@@ -194,36 +189,47 @@ export async function tiersetGetTiers(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_tierset_get_tiers");
+        throw formatApiError(error, "ol_tierset_get_tiers");
     }
 }
 export const tiersetToolDefinitions = [
     {
-        name: "openloyalty_tierset_list",
+        name: "ol_tierset_list",
+        title: "List Loyalty Programs",
         description: "List all tier sets. Use tierset_get to fetch conditions needed for defining tiers. Returns tierSetId, name, active status, and tier count for each tier set.",
+        readOnly: true,
         inputSchema: TierSetListInputSchema,
         handler: tiersetList,
     },
     {
-        name: "openloyalty_tierset_create",
-        description: "Create a new tier set (loyalty program structure). After creation, call tierset_get to obtain conditionId values, then tierset_update_tiers to define tier thresholds. Conditions define what metrics are used for tier progression (e.g., activeUnits for points balance).",
+        name: "ol_tierset_create",
+        title: "Create Loyalty Program",
+        description: "Create a new tier set (loyalty program structure). After creation, call tierset_get to obtain conditionId values, then tierset_update_tiers to define tier thresholds. " +
+            "Conditions define what metrics are used for tier progression (e.g., activeUnits for points balance). " +
+            "IMPORTANT: conditions use `attribute` (not `type`). For unit-based attributes, set `walletType` to the wallet CODE (e.g., 'default'), not the UUID.",
+        readOnly: false,
         inputSchema: TierSetCreateInputSchema,
         handler: tiersetCreate,
     },
     {
-        name: "openloyalty_tierset_get",
+        name: "ol_tierset_get",
+        title: "Get Loyalty Program Details",
         description: "Get tier set details including conditionId values needed for tierset_update_tiers. Returns the full tier set with conditions array containing conditionId for each condition.",
+        readOnly: true,
         inputSchema: TierSetGetInputSchema,
         handler: tiersetGet,
     },
     {
-        name: "openloyalty_tierset_update",
+        name: "ol_tierset_update",
+        title: "Update Loyalty Program",
         description: "Update tier set metadata (name, description, active status, downgrade settings). Does not modify tiers - use tierset_update_tiers for that.",
+        readOnly: false,
         inputSchema: TierSetUpdateInputSchema,
         handler: tiersetUpdate,
     },
     {
-        name: "openloyalty_tierset_update_tiers",
+        name: "ol_tierset_update_tiers",
+        title: "Configure Tier Thresholds",
         description: `Define tier thresholds for a tier set. PREREQUISITE: Call tierset_get first to obtain conditionId values. Each tier's conditions array uses conditionId from the parent tier set plus a threshold value.
 
 Example for a 3-tier program with points-based progression:
@@ -232,12 +238,15 @@ Example for a 3-tier program with points-based progression:
 - Gold tier: conditions: [{ conditionId: "xxx", value: 1200 }]
 
 The conditionId must match one from tierset_get response.`,
+        readOnly: false,
         inputSchema: TierSetUpdateTiersInputSchema,
         handler: tiersetUpdateTiers,
     },
     {
-        name: "openloyalty_tierset_get_tiers",
+        name: "ol_tierset_get_tiers",
+        title: "Get Tier Configuration",
         description: "Get all tiers in a tier set. Returns levelId values that can be used for campaign targeting. Includes each tier's name and condition thresholds.",
+        readOnly: true,
         inputSchema: TierSetGetTiersInputSchema,
         handler: tiersetGetTiers,
     },

package/dist/tools/transaction.d.ts

@@ -88,16 +88,16 @@ export declare const TransactionCreateInputSchema: {
         phone: z.ZodOptional<z.ZodString>;
         loyaltyCardNumber: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
+        name?: string | undefined;
         customerId?: string | undefined;
     }, {
-        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
+        name?: string | undefined;
         customerId?: string | undefined;
     }>>;
 };
@@ -214,8 +214,10 @@ export declare function transactionAssignMember(input: {
     pointsEarned?: number;
 }>;
 export declare const transactionToolDefinitions: readonly [{
-    readonly name: "openloyalty_transaction_create";
+    readonly name: "ol_transaction_create";
+    readonly title: "Record Purchase";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         header: z.ZodObject<{
@@ -305,31 +307,35 @@ export declare const transactionToolDefinitions: readonly [{
             phone: z.ZodOptional<z.ZodString>;
             loyaltyCardNumber: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             loyaltyCardNumber?: string | undefined;
+            name?: string | undefined;
             customerId?: string | undefined;
         }, {
-            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             loyaltyCardNumber?: string | undefined;
+            name?: string | undefined;
             customerId?: string | undefined;
         }>>;
     };
     readonly handler: typeof transactionCreate;
 }, {
-    readonly name: "openloyalty_transaction_get";
+    readonly name: "ol_transaction_get";
+    readonly title: "Get Transaction Details";
     readonly description: "Get transaction details including items, customerData, matched status, and pointsEarned.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         transactionId: z.ZodString;
     };
     readonly handler: typeof transactionGet;
 }, {
-    readonly name: "openloyalty_transaction_list";
+    readonly name: "ol_transaction_list";
+    readonly title: "Search Transactions";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodString>;
@@ -344,8 +350,10 @@ export declare const transactionToolDefinitions: readonly [{
     };
     readonly handler: typeof transactionList;
 }, {
-    readonly name: "openloyalty_transaction_assign_member";
+    readonly name: "ol_transaction_assign_member";
+    readonly title: "Link Transaction to Member";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         documentNumber: z.ZodString;

package/dist/tools/transaction.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 { getStoreCode } from "../config.js";
 import { buildPaginationParams, normalizeDateToISO } from "../utils/pagination.js";
 // Input Schemas
 const LabelInputSchema = z.object({
@@ -34,17 +34,17 @@ const CustomerDataInputSchema = z.object({
     loyaltyCardNumber: z.string().optional().describe("Loyalty card for auto-matching."),
 });
 export const TransactionCreateInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     header: TransactionHeaderInputSchema.describe("Transaction header with document info."),
     items: z.array(TransactionItemInputSchema).describe("Array of purchased items (at least 1 required)."),
     customerData: CustomerDataInputSchema.optional().describe("Customer data for auto-matching to member. If provided, triggers point campaigns."),
 };
 export const TransactionGetInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     transactionId: z.string().describe("The transaction ID (UUID) to retrieve."),
 };
 export const TransactionListInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     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().max(50).optional().describe("Items per page (default: 10, max: 50). Use 50 for aggregation queries to reduce API calls."),
@@ -56,7 +56,7 @@ export const TransactionListInputSchema = {
     purchasedAtTo: z.string().optional().describe("Filter transactions purchased on or before this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ssZ)."),
 };
 export const TransactionAssignMemberInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     documentNumber: z.string().describe("Document number of the transaction to assign."),
     customerId: z.string().optional().describe("Member ID (UUID) to assign."),
     loyaltyCardNumber: z.string().optional().describe("Loyalty card number to match member."),
@@ -64,8 +64,7 @@ export const TransactionAssignMemberInputSchema = {
 };
 // Handler functions
 export async function transactionCreate(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const transactionPayload = {
         header: {
             documentNumber: input.header.documentNumber,
@@ -96,12 +95,11 @@ export async function transactionCreate(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_transaction_create");
+        throw formatApiError(error, "ol_transaction_create");
     }
 }
 export async function transactionGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/transaction/${input.transactionId}`);
         const header = response.header;
@@ -118,12 +116,11 @@ export async function transactionGet(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_transaction_get");
+        throw formatApiError(error, "ol_transaction_get");
     }
 }
 export async function transactionList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     // Enforce max perPage of 50 (API limit)
     const perPage = input.perPage ? Math.min(input.perPage, 50) : undefined;
@@ -171,12 +168,11 @@ export async function transactionList(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_transaction_list");
+        throw formatApiError(error, "ol_transaction_list");
     }
 }
 export async function transactionAssignMember(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     // At least one identifier required
     if (!input.customerId && !input.loyaltyCardNumber && !input.phone) {
         throw new Error("At least one member identifier required: customerId, loyaltyCardNumber, or phone.");
@@ -200,27 +196,32 @@ export async function transactionAssignMember(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_transaction_assign_member");
+        throw formatApiError(error, "ol_transaction_assign_member");
     }
 }
 // Tool definitions
 export const transactionToolDefinitions = [
     {
-        name: "openloyalty_transaction_create",
+        name: "ol_transaction_create",
+        title: "Record Purchase",
         description: "Record a purchase transaction. If customerData provided, auto-matches to member and triggers point campaigns. " +
             "For returns, set documentType='return' and provide linkedDocumentNumber referencing original sale. " +
             "Returns transactionId and pointsEarned if campaigns triggered.",
+        readOnly: false,
         inputSchema: TransactionCreateInputSchema,
         handler: transactionCreate,
     },
     {
-        name: "openloyalty_transaction_get",
+        name: "ol_transaction_get",
+        title: "Get Transaction Details",
         description: "Get transaction details including items, customerData, matched status, and pointsEarned.",
+        readOnly: true,
         inputSchema: TransactionGetInputSchema,
         handler: transactionGet,
     },
     {
-        name: "openloyalty_transaction_list",
+        name: "ol_transaction_list",
+        title: "Search Transactions",
         description: "List transactions with optional filters. Filter by customerId, documentNumber, documentType, matched status, or date range (purchasedAtFrom/purchasedAtTo). " +
             "Use ISO date format for date filters (e.g., '2025-07-01' or '2025-07-01T00:00:00Z'). " +
             "Supports cursor pagination: provide 'cursor' from previous response to get next page. " +
@@ -229,13 +230,16 @@ export const transactionToolDefinitions = [
             "Do NOT try to optimize or find shortcuts - the cursor approach is the correct and only way to get accurate results. " +
             "Start with cursor='' (empty string), then use returned cursor for subsequent requests until no more data. " +
             "Use perPage=50 to minimize API calls. Aggregate by customerId in your code, then use member_get for names.",
+        readOnly: true,
         inputSchema: TransactionListInputSchema,
         handler: transactionList,
     },
     {
-        name: "openloyalty_transaction_assign_member",
+        name: "ol_transaction_assign_member",
+        title: "Link Transaction to Member",
         description: "Assign unmatched transaction to member by ID, card number, or phone. Triggers point campaigns. " +
             "Use this to link a transaction that wasn't matched at creation time. Returns transactionId, customerId, and pointsEarned.",
+        readOnly: false,
         inputSchema: TransactionAssignMemberInputSchema,
         handler: transactionAssignMember,
     },

package/dist/tools/wallet-type.d.ts

@@ -15,15 +15,19 @@ export declare function walletTypeGet(input: {
     walletTypeId: string;
 }): Promise<WalletType>;
 export declare const walletTypeToolDefinitions: readonly [{
-    readonly name: "openloyalty_wallet_type_list";
-    readonly description: "List all available wallet types (point currencies). Use this to find walletCode values for tier conditions. Returns walletTypeId, code, and name for each wallet type.";
+    readonly name: "ol_wallet_type_list";
+    readonly title: "List Point Currencies";
+    readonly description: "List all available wallet types (point currencies). Use this to find the walletType CODE (e.g., 'default') for tier conditions. Returns walletTypeId, code, and name for each wallet type.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof walletTypeList;
 }, {
-    readonly name: "openloyalty_wallet_type_get";
+    readonly name: "ol_wallet_type_get";
+    readonly title: "Get Point Currency Details";
     readonly description: "Get details for a specific wallet type by ID. Returns the full wallet type configuration including currency names.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         walletTypeId: z.ZodString;

package/dist/tools/wallet-type.js

@@ -2,17 +2,16 @@ import { z } from "zod";
 import { apiGet } from "../client/http.js";
 import { WalletTypeSchema, WalletTypeListResponseSchema, } from "../types/schemas/wallet-type.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 export const WalletTypeListInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
 };
 export const WalletTypeGetInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     walletTypeId: z.string().describe("The wallet type ID to retrieve."),
 };
 export async function walletTypeList(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/walletType`);
         const validated = WalletTypeListResponseSchema.parse(response);
@@ -27,31 +26,34 @@ export async function walletTypeList(input) {
         }));
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_wallet_type_list");
+        throw formatApiError(error, "ol_wallet_type_list");
     }
 }
 export async function walletTypeGet(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/walletType/${input.walletTypeId}`);
         const validated = WalletTypeSchema.parse(response);
         return validated;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_wallet_type_get");
+        throw formatApiError(error, "ol_wallet_type_get");
     }
 }
 export const walletTypeToolDefinitions = [
     {
-        name: "openloyalty_wallet_type_list",
-        description: "List all available wallet types (point currencies). Use this to find walletCode values for tier conditions. Returns walletTypeId, code, and name for each wallet type.",
+        name: "ol_wallet_type_list",
+        title: "List Point Currencies",
+        description: "List all available wallet types (point currencies). Use this to find the walletType CODE (e.g., 'default') for tier conditions. Returns walletTypeId, code, and name for each wallet type.",
+        readOnly: true,
         inputSchema: WalletTypeListInputSchema,
         handler: walletTypeList,
     },
     {
-        name: "openloyalty_wallet_type_get",
+        name: "ol_wallet_type_get",
+        title: "Get Point Currency Details",
         description: "Get details for a specific wallet type by ID. Returns the full wallet type configuration including currency names.",
+        readOnly: true,
         inputSchema: WalletTypeGetInputSchema,
         handler: walletTypeGet,
     },

package/dist/tools/webhook.d.ts

@@ -31,7 +31,7 @@ export declare const WebhookListInputSchema: {
 export declare const WebhookCreateInputSchema: {
     storeCode: z.ZodOptional<z.ZodString>;
     eventName: z.ZodString;
-    url: z.ZodString;
+    url: z.ZodEffects<z.ZodString, string, string>;
     headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         headerName: z.ZodString;
         headerValue: z.ZodString;
@@ -51,7 +51,7 @@ export declare const WebhookUpdateInputSchema: {
     storeCode: z.ZodOptional<z.ZodString>;
     webhookSubscriptionId: z.ZodString;
     eventName: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         headerName: z.ZodString;
         headerValue: z.ZodString;
@@ -104,8 +104,10 @@ export declare function webhookEvents(input: {
     storeCode?: string;
 }): Promise<WebhookEventTypesResponse>;
 export declare const webhookToolDefinitions: readonly [{
-    readonly name: "openloyalty_webhook_list";
+    readonly name: "ol_webhook_list";
+    readonly title: "List Webhook Subscriptions";
     readonly description: "List webhook subscriptions with optional filtering. Returns paginated list of subscriptions with webhookSubscriptionId, eventName, url, and createdAt.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -115,12 +117,14 @@ export declare const webhookToolDefinitions: readonly [{
     };
     readonly handler: typeof webhookList;
 }, {
-    readonly name: "openloyalty_webhook_create";
+    readonly name: "ol_webhook_create";
+    readonly title: "Create Webhook Subscription";
     readonly description: "Create a new webhook subscription to receive event notifications. Returns webhookSubscriptionId on success. Use webhook_events to discover available event types before creating subscriptions.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         eventName: z.ZodString;
-        url: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
         headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
             headerName: z.ZodString;
             headerValue: z.ZodString;
@@ -134,21 +138,25 @@ export declare const webhookToolDefinitions: readonly [{
     };
     readonly handler: typeof webhookCreate;
 }, {
-    readonly name: "openloyalty_webhook_get";
+    readonly name: "ol_webhook_get";
+    readonly title: "Get Webhook Subscription Details";
     readonly description: "Get full webhook subscription details including headers configuration.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         webhookSubscriptionId: z.ZodString;
     };
     readonly handler: typeof webhookGet;
 }, {
-    readonly name: "openloyalty_webhook_update";
+    readonly name: "ol_webhook_update";
+    readonly title: "Update Webhook Subscription";
     readonly description: "Update a webhook subscription. Can update eventName, url, and headers. Returns void on success (204 No Content).";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         webhookSubscriptionId: z.ZodString;
         eventName: z.ZodOptional<z.ZodString>;
-        url: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
             headerName: z.ZodString;
             headerValue: z.ZodString;
@@ -162,16 +170,21 @@ export declare const webhookToolDefinitions: readonly [{
     };
     readonly handler: typeof webhookUpdate;
 }, {
-    readonly name: "openloyalty_webhook_delete";
+    readonly name: "ol_webhook_delete";
+    readonly title: "Delete Webhook Subscription (Permanent)";
     readonly description: "Delete a webhook subscription. Returns void on success (204 No Content). The subscription will stop receiving events immediately.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         webhookSubscriptionId: z.ZodString;
     };
     readonly handler: typeof webhookDelete;
 }, {
-    readonly name: "openloyalty_webhook_events";
+    readonly name: "ol_webhook_events";
+    readonly title: "List Available Webhook Events";
     readonly description: "Get available webhook event types. Returns list of event names that can be used when creating webhook subscriptions. Use this to discover available events before creating subscriptions.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };