@open-loyalty/mcp-server 1.0.2 → 1.1.0

package/dist/tools/store.d.ts

@@ -62,7 +62,9 @@ export declare function storeUpdate(input: {
 }): Promise<void>;
 export declare const storeToolDefinitions: readonly [{
     readonly name: "openloyalty_store_list";
+    readonly title: "List Stores";
     readonly description: "List all stores with optional filtering. Returns paginated list of stores with storeId, code, name, currency, and active status. Stores enable multi-tenant loyalty programs. Each store has independent members, campaigns, and settings.";
+    readonly readOnly: true;
     readonly inputSchema: {
         page: z.ZodOptional<z.ZodNumber>;
         perPage: z.ZodOptional<z.ZodNumber>;
@@ -73,7 +75,9 @@ export declare const storeToolDefinitions: readonly [{
     readonly handler: typeof storeList;
 }, {
     readonly name: "openloyalty_store_create";
+    readonly title: "Create Store";
     readonly description: "Create a new store for multi-tenant setup. Requires unique code and name. Returns storeId on success.";
+    readonly readOnly: false;
     readonly inputSchema: {
         code: z.ZodString;
         name: z.ZodString;
@@ -83,14 +87,18 @@ export declare const storeToolDefinitions: readonly [{
     readonly handler: typeof storeCreate;
 }, {
     readonly name: "openloyalty_store_get";
+    readonly title: "Get Store Details";
     readonly description: "Get full store configuration by ID. Returns storeId, code, name, currency, active status, and timestamps.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeId: z.ZodString;
     };
     readonly handler: typeof storeGet;
 }, {
     readonly name: "openloyalty_store_update";
+    readonly title: "Update Store";
     readonly description: "Update store configuration. Can update name, currency, and active status. Returns void on success (204 No Content).";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeId: z.ZodString;
         name: z.ZodOptional<z.ZodString>;

package/dist/tools/store.js

@@ -92,25 +92,33 @@ export async function storeUpdate(input) {
 export const storeToolDefinitions = [
     {
         name: "openloyalty_store_list",
+        title: "List Stores",
         description: "List all stores with optional filtering. Returns paginated list of stores with storeId, code, name, currency, and active status. Stores enable multi-tenant loyalty programs. Each store has independent members, campaigns, and settings.",
+        readOnly: true,
         inputSchema: StoreListInputSchema,
         handler: storeList,
     },
     {
         name: "openloyalty_store_create",
+        title: "Create Store",
         description: "Create a new store for multi-tenant setup. Requires unique code and name. Returns storeId on success.",
+        readOnly: false,
         inputSchema: StoreCreateInputSchema,
         handler: storeCreate,
     },
     {
         name: "openloyalty_store_get",
+        title: "Get Store Details",
         description: "Get full store configuration by ID. Returns storeId, code, name, currency, active status, and timestamps.",
+        readOnly: true,
         inputSchema: StoreGetInputSchema,
         handler: storeGet,
     },
     {
         name: "openloyalty_store_update",
+        title: "Update Store",
         description: "Update store configuration. Can update name, currency, and active status. Returns void on success (204 No Content).",
+        readOnly: false,
         inputSchema: StoreUpdateInputSchema,
         handler: storeUpdate,
     },

package/dist/tools/tierset.d.ts

@@ -168,7 +168,9 @@ export declare function tiersetGetTiers(input: TierSetGetInput): Promise<{
 }>;
 export declare const tiersetToolDefinitions: readonly [{
     readonly name: "openloyalty_tierset_list";
+    readonly title: "List Loyalty Programs";
     readonly 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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -177,7 +179,9 @@ export declare const tiersetToolDefinitions: readonly [{
     readonly handler: typeof tiersetList;
 }, {
     readonly name: "openloyalty_tierset_create";
+    readonly title: "Create Loyalty Program";
     readonly 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).";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
@@ -207,7 +211,9 @@ export declare const tiersetToolDefinitions: readonly [{
     readonly handler: typeof tiersetCreate;
 }, {
     readonly name: "openloyalty_tierset_get";
+    readonly title: "Get Loyalty Program Details";
     readonly 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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         tierSetId: z.ZodString;
@@ -215,7 +221,9 @@ export declare const tiersetToolDefinitions: readonly [{
     readonly handler: typeof tiersetGet;
 }, {
     readonly name: "openloyalty_tierset_update";
+    readonly title: "Update Loyalty Program";
     readonly description: "Update tier set metadata (name, description, active status, downgrade settings). Does not modify tiers - use tierset_update_tiers for that.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         tierSetId: z.ZodString;
@@ -236,7 +244,9 @@ export declare const tiersetToolDefinitions: readonly [{
     readonly handler: typeof tiersetUpdate;
 }, {
     readonly name: "openloyalty_tierset_update_tiers";
+    readonly title: "Configure Tier Thresholds";
     readonly 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.\n\nExample for a 3-tier program with points-based progression:\n- Bronze tier: conditions: [{ conditionId: \"xxx\", value: 400 }]\n- Silver tier: conditions: [{ conditionId: \"xxx\", value: 800 }]\n- Gold tier: conditions: [{ conditionId: \"xxx\", value: 1200 }]\n\nThe conditionId must match one from tierset_get response.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         tierSetId: z.ZodString;
@@ -278,7 +288,9 @@ export declare const tiersetToolDefinitions: readonly [{
     readonly handler: typeof tiersetUpdateTiers;
 }, {
     readonly name: "openloyalty_tierset_get_tiers";
+    readonly title: "Get Tier Configuration";
     readonly 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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         tierSetId: z.ZodString;

package/dist/tools/tierset.js

@@ -2,7 +2,7 @@ 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."),
@@ -57,8 +57,7 @@ export const TierSetGetTiersInputSchema = {
     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,
@@ -84,8 +83,7 @@ export async function tiersetList(input) {
     }
 }
 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: {
@@ -116,8 +114,7 @@ export async function tiersetCreate(input) {
     }
 }
 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);
@@ -128,8 +125,7 @@ export async function tiersetGet(input) {
     }
 }
 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
@@ -153,8 +149,7 @@ export async function tiersetUpdate(input) {
     }
 }
 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) => ({
@@ -180,8 +175,7 @@ export async function tiersetUpdateTiers(input) {
     }
 }
 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);
@@ -200,30 +194,39 @@ export async function tiersetGetTiers(input) {
 export const tiersetToolDefinitions = [
     {
         name: "openloyalty_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",
+        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).",
+        readOnly: false,
         inputSchema: TierSetCreateInputSchema,
         handler: tiersetCreate,
     },
     {
         name: "openloyalty_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",
+        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",
+        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 +235,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",
+        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;
     }>>;
 };
@@ -215,7 +215,9 @@ export declare function transactionAssignMember(input: {
 }>;
 export declare const transactionToolDefinitions: readonly [{
     readonly name: "openloyalty_transaction_create";
+    readonly title: "Record Purchase";
     readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         header: z.ZodObject<{
@@ -305,23 +307,25 @@ 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 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;
@@ -329,7 +333,9 @@ export declare const transactionToolDefinitions: readonly [{
     readonly handler: typeof transactionGet;
 }, {
     readonly name: "openloyalty_transaction_list";
+    readonly title: "Search Transactions";
     readonly description: string;
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodString>;
@@ -345,7 +351,9 @@ export declare const transactionToolDefinitions: readonly [{
     readonly handler: typeof transactionList;
 }, {
     readonly name: "openloyalty_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({
@@ -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,
@@ -100,8 +99,7 @@ export async function transactionCreate(input) {
     }
 }
 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;
@@ -122,8 +120,7 @@ export async function transactionGet(input) {
     }
 }
 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;
@@ -175,8 +172,7 @@ export async function transactionList(input) {
     }
 }
 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.");
@@ -207,20 +203,25 @@ export async function transactionAssignMember(input) {
 export const transactionToolDefinitions = [
     {
         name: "openloyalty_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",
+        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",
+        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",
+        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

@@ -16,14 +16,18 @@ export declare function walletTypeGet(input: {
 }): Promise<WalletType>;
 export declare const walletTypeToolDefinitions: readonly [{
     readonly name: "openloyalty_wallet_type_list";
+    readonly title: "List Point Currencies";
     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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
     };
     readonly handler: typeof walletTypeList;
 }, {
     readonly name: "openloyalty_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,7 +2,7 @@ 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."),
 };
@@ -11,8 +11,7 @@ export const WalletTypeGetInputSchema = {
     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);
@@ -31,8 +30,7 @@ export async function walletTypeList(input) {
     }
 }
 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);
@@ -45,13 +43,17 @@ export async function walletTypeGet(input) {
 export const walletTypeToolDefinitions = [
     {
         name: "openloyalty_wallet_type_list",
+        title: "List Point Currencies",
         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: true,
         inputSchema: WalletTypeListInputSchema,
         handler: walletTypeList,
     },
     {
         name: "openloyalty_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;
@@ -105,7 +105,9 @@ export declare function webhookEvents(input: {
 }): Promise<WebhookEventTypesResponse>;
 export declare const webhookToolDefinitions: readonly [{
     readonly name: "openloyalty_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>;
@@ -116,11 +118,13 @@ export declare const webhookToolDefinitions: readonly [{
     readonly handler: typeof webhookList;
 }, {
     readonly name: "openloyalty_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;
@@ -135,7 +139,9 @@ export declare const webhookToolDefinitions: readonly [{
     readonly handler: typeof webhookCreate;
 }, {
     readonly name: "openloyalty_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;
@@ -143,12 +149,14 @@ export declare const webhookToolDefinitions: readonly [{
     readonly handler: typeof webhookGet;
 }, {
     readonly name: "openloyalty_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;
@@ -163,7 +171,10 @@ export declare const webhookToolDefinitions: readonly [{
     readonly handler: typeof webhookUpdate;
 }, {
     readonly name: "openloyalty_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;
@@ -171,7 +182,9 @@ export declare const webhookToolDefinitions: readonly [{
     readonly handler: typeof webhookDelete;
 }, {
     readonly name: "openloyalty_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>;
     };