@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/analytics.js

@@ -1,42 +1,42 @@
 import { z } from "zod";
 import { apiGet } from "../client/http.js";
 import { formatApiError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 // Input Schemas
 export const AnalyticsTiersInputSchema = {
-    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 AnalyticsMembersInputSchema = {
-    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."),
     withTransaction: z.boolean().optional().describe("Filter: true for members with transactions, false for members without, omit for all."),
 };
 export const AnalyticsPointsInputSchema = {
-    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 AnalyticsTransactionsInputSchema = {
-    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 AnalyticsReferralsInputSchema = {
-    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 AnalyticsCampaignsInputSchema = {
-    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 (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
     executedAt: z.string().optional().describe("Filter by execution date (ISO format)."),
 };
 export const AnalyticsDashboardInputSchema = {
-    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."),
     dataType: z.enum([
         "registeredMembers", "activeMembers", "revenue", "avgSpending",
         "transactions", "avgTransactionValue", "avgNumberOfTransactions"
-    ]).optional().describe("Type of data to retrieve."),
+    ]).describe("REQUIRED: Type of data to retrieve. Options: registeredMembers, activeMembers, revenue, avgSpending, transactions, avgTransactionValue, avgNumberOfTransactions."),
     aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
     intervalStartDate: z.string().optional().describe("Start date (YYYY-MM-DD format)."),
     intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
 };
 export const AnalyticsUnitsInputSchema = {
-    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."),
     walletTypeCode: z.string().describe("Wallet type code (e.g., 'default' or 'points')."),
     dataType: z.enum([
         "unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"
@@ -46,24 +46,22 @@ export const AnalyticsUnitsInputSchema = {
     intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
 };
 export const AnalyticsCampaignDetailInputSchema = {
-    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."),
     campaignId: z.string().describe("The campaign ID to get analytics for."),
 };
 // Handler functions
 export async function analyticsTiers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/levels`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_tiers");
+        throw formatApiError(error, "ol_analytics_tiers");
     }
 }
 export async function analyticsMembers(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.withTransaction !== undefined) {
         params.append("withTransaction", String(input.withTransaction));
@@ -75,45 +73,41 @@ export async function analyticsMembers(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_members");
+        throw formatApiError(error, "ol_analytics_members");
     }
 }
 export async function analyticsPoints(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/points`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_points");
+        throw formatApiError(error, "ol_analytics_points");
     }
 }
 export async function analyticsTransactions(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/transactions`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_transactions");
+        throw formatApiError(error, "ol_analytics_transactions");
     }
 }
 export async function analyticsReferrals(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
         const response = await apiGet(`/${storeCode}/analytics/referrals`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_referrals");
+        throw formatApiError(error, "ol_analytics_referrals");
     }
 }
 export async function analyticsCampaigns(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));
@@ -128,12 +122,11 @@ export async function analyticsCampaigns(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_campaigns");
+        throw formatApiError(error, "ol_analytics_campaigns");
     }
 }
 export async function analyticsDashboard(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.dataType)
         params.append("dataType", input.dataType);
@@ -150,12 +143,11 @@ export async function analyticsDashboard(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_dashboard");
+        throw formatApiError(error, "ol_analytics_dashboard");
     }
 }
 export async function analyticsUnits(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.dataType)
         params.append("dataType", input.dataType);
@@ -172,73 +164,91 @@ export async function analyticsUnits(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_units");
+        throw formatApiError(error, "ol_analytics_units");
     }
 }
 export async function analyticsCampaignDetail(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     try {
-        const response = await apiGet(`/${storeCode}/analytics/campaign/${input.campaignId}`);
+        // API endpoint uses /campaigns (plural) with campaign ID as query param
+        const response = await apiGet(`/${storeCode}/analytics/campaigns?campaignId=${input.campaignId}`);
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_analytics_campaign_detail");
+        throw formatApiError(error, "ol_analytics_campaign_detail");
     }
 }
 // Tool definitions
 export const analyticsToolDefinitions = [
     {
-        name: "openloyalty_analytics_tiers",
+        name: "ol_analytics_tiers",
+        title: "Get Tier Analytics",
         description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.",
+        readOnly: true,
         inputSchema: AnalyticsTiersInputSchema,
         handler: analyticsTiers,
     },
     {
-        name: "openloyalty_analytics_members",
+        name: "ol_analytics_members",
+        title: "Get Member Analytics",
         description: "Get member analytics showing registration trends. Returns member counts by time intervals (1 day, 7 days, 30 days, 365 days). Filter by transaction status to see engaged vs unengaged members.",
+        readOnly: true,
         inputSchema: AnalyticsMembersInputSchema,
         handler: analyticsMembers,
     },
     {
-        name: "openloyalty_analytics_points",
+        name: "ol_analytics_points",
+        title: "Get Points Analytics",
         description: "Get points analytics showing program health. Returns total active points, points spent, points issued, expired points, and pending points. Use to monitor points economy.",
+        readOnly: true,
         inputSchema: AnalyticsPointsInputSchema,
         handler: analyticsPoints,
     },
     {
-        name: "openloyalty_analytics_transactions",
+        name: "ol_analytics_transactions",
+        title: "Get Transaction Analytics",
         description: "Get transaction analytics showing purchase trends. Returns transaction counts by intervals, total count, total amount, and average values. Use to monitor sales performance.",
+        readOnly: true,
         inputSchema: AnalyticsTransactionsInputSchema,
         handler: analyticsTransactions,
     },
     {
-        name: "openloyalty_analytics_referrals",
+        name: "ol_analytics_referrals",
+        title: "Get Referral Analytics",
         description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.",
+        readOnly: true,
         inputSchema: AnalyticsReferralsInputSchema,
         handler: analyticsReferrals,
     },
     {
-        name: "openloyalty_analytics_campaigns",
+        name: "ol_analytics_campaigns",
+        title: "Get Campaign Analytics",
         description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.",
+        readOnly: true,
         inputSchema: AnalyticsCampaignsInputSchema,
         handler: analyticsCampaigns,
     },
     {
-        name: "openloyalty_analytics_dashboard",
+        name: "ol_analytics_dashboard",
+        title: "Get Dashboard Overview",
         description: "Get dashboard overview metrics with time-series data. Returns key metrics (registered members, active members, revenue, avg spending, transactions) with optional date range and aggregation. Use for high-level program dashboards.",
+        readOnly: true,
         inputSchema: AnalyticsDashboardInputSchema,
         handler: analyticsDashboard,
     },
     {
-        name: "openloyalty_analytics_units",
+        name: "ol_analytics_units",
+        title: "Get Units Overview",
         description: "Get wallet-specific analytics (units overview). Returns units issued, spent, expired, pending, active, plus redemption and breakage rates. Requires walletTypeCode parameter. Use for detailed points economy analysis.",
+        readOnly: true,
         inputSchema: AnalyticsUnitsInputSchema,
         handler: analyticsUnits,
     },
     {
-        name: "openloyalty_analytics_campaign_detail",
+        name: "ol_analytics_campaign_detail",
+        title: "Get Campaign Detail Analytics",
         description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.",
+        readOnly: true,
         inputSchema: AnalyticsCampaignDetailInputSchema,
         handler: analyticsCampaignDetail,
     },

package/dist/tools/apikey.d.ts

@@ -44,8 +44,10 @@ export declare function apiKeyDelete(input: {
     apiKeyId: string;
 }): Promise<void>;
 export declare const apiKeyToolDefinitions: readonly [{
-    readonly name: "openloyalty_apikey_create";
+    readonly name: "ol_apikey_create";
+    readonly title: "Create API Key";
     readonly description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.";
+    readonly readOnly: false;
     readonly inputSchema: {
         adminId: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -53,8 +55,10 @@ export declare const apiKeyToolDefinitions: readonly [{
     };
     readonly handler: typeof apiKeyCreate;
 }, {
-    readonly name: "openloyalty_apikey_list";
+    readonly name: "ol_apikey_list";
+    readonly title: "List API Keys";
     readonly description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.";
+    readonly readOnly: true;
     readonly inputSchema: {
         adminId: z.ZodString;
         page: z.ZodOptional<z.ZodNumber>;
@@ -62,8 +66,11 @@ export declare const apiKeyToolDefinitions: readonly [{
     };
     readonly handler: typeof apiKeyList;
 }, {
-    readonly name: "openloyalty_apikey_delete";
+    readonly name: "ol_apikey_delete";
+    readonly title: "Delete API Key (Permanent)";
     readonly description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.";
+    readonly readOnly: false;
+    readonly destructive: true;
     readonly inputSchema: {
         adminId: z.ZodString;
         apiKeyId: z.ZodString;

package/dist/tools/apikey.js

@@ -28,7 +28,7 @@ export async function apiKeyCreate(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_apikey_create");
+        throw formatApiError(error, "ol_apikey_create");
     }
 }
 export async function apiKeyList(input) {
@@ -44,7 +44,7 @@ export async function apiKeyList(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_apikey_list");
+        throw formatApiError(error, "ol_apikey_list");
     }
 }
 export async function apiKeyDelete(input) {
@@ -52,26 +52,33 @@ export async function apiKeyDelete(input) {
         await apiDelete(`/admin/${input.adminId}/api-key/${input.apiKeyId}`);
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_apikey_delete");
+        throw formatApiError(error, "ol_apikey_delete");
     }
 }
 // Tool definitions
 export const apiKeyToolDefinitions = [
     {
-        name: "openloyalty_apikey_create",
+        name: "ol_apikey_create",
+        title: "Create API Key",
         description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.",
+        readOnly: false,
         inputSchema: ApiKeyCreateInputSchema,
         handler: apiKeyCreate,
     },
     {
-        name: "openloyalty_apikey_list",
+        name: "ol_apikey_list",
+        title: "List API Keys",
         description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.",
+        readOnly: true,
         inputSchema: ApiKeyListInputSchema,
         handler: apiKeyList,
     },
     {
-        name: "openloyalty_apikey_delete",
+        name: "ol_apikey_delete",
+        title: "Delete API Key (Permanent)",
         description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.",
+        readOnly: false,
+        destructive: true,
         inputSchema: ApiKeyDeleteInputSchema,
         handler: apiKeyDelete,
     },

package/dist/tools/audit.d.ts

@@ -80,8 +80,10 @@ export declare function auditExport(input: {
     exportId: string;
 }>;
 export declare const auditToolDefinitions: readonly [{
-    readonly name: "openloyalty_audit_list";
+    readonly name: "ol_audit_list";
+    readonly title: "List Audit Logs";
     readonly description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.";
+    readonly readOnly: true;
     readonly inputSchema: {
         page: z.ZodOptional<z.ZodNumber>;
         perPage: z.ZodOptional<z.ZodNumber>;
@@ -95,8 +97,10 @@ export declare const auditToolDefinitions: readonly [{
     };
     readonly handler: typeof auditList;
 }, {
-    readonly name: "openloyalty_audit_export";
+    readonly name: "ol_audit_export";
+    readonly title: "Export Audit Logs";
     readonly description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.";
+    readonly readOnly: false;
     readonly inputSchema: {
         dateFrom: z.ZodOptional<z.ZodString>;
         dateTo: z.ZodOptional<z.ZodString>;

package/dist/tools/audit.js

@@ -47,7 +47,7 @@ export async function auditList(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_audit_list");
+        throw formatApiError(error, "ol_audit_list");
     }
 }
 export async function auditExport(input) {
@@ -70,20 +70,24 @@ export async function auditExport(input) {
         return response;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_audit_export");
+        throw formatApiError(error, "ol_audit_export");
     }
 }
 // Tool definitions
 export const auditToolDefinitions = [
     {
-        name: "openloyalty_audit_list",
+        name: "ol_audit_list",
+        title: "List Audit Logs",
         description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.",
+        readOnly: true,
         inputSchema: AuditListInputSchema,
         handler: auditList,
     },
     {
-        name: "openloyalty_audit_export",
+        name: "ol_audit_export",
+        title: "Export Audit Logs",
         description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.",
+        readOnly: false,
         inputSchema: AuditExportInputSchema,
         handler: auditExport,
     },

package/dist/tools/badge.d.ts

@@ -14,7 +14,7 @@ export declare const BadgeGetInputSchema: {
 export declare const BadgeUpdateInputSchema: {
     storeCode: z.ZodOptional<z.ZodString>;
     badgeTypeId: z.ZodString;
-    name: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
     translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -80,8 +80,10 @@ export declare function badgeGetMemberBadges(input: {
     };
 }>;
 export declare const badgeToolDefinitions: readonly [{
-    readonly name: "openloyalty_badge_list";
+    readonly name: "ol_badge_list";
+    readonly title: "List Badges";
     readonly 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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -91,20 +93,24 @@ export declare const badgeToolDefinitions: readonly [{
     };
     readonly handler: typeof badgeList;
 }, {
-    readonly name: "openloyalty_badge_get";
+    readonly name: "ol_badge_get";
+    readonly title: "Get Badge Details";
     readonly description: "Get badge type details including name, image URL, and linked achievements count.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         badgeTypeId: z.ZodString;
     };
     readonly handler: typeof badgeGet;
 }, {
-    readonly name: "openloyalty_badge_update";
+    readonly name: "ol_badge_update";
+    readonly title: "Update Badge";
     readonly description: "Update badge type configuration. Badge types are created automatically when referenced by achievements. Use this to update name, image, or translations.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         badgeTypeId: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
         translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
@@ -120,8 +126,10 @@ export declare const badgeToolDefinitions: readonly [{
     };
     readonly handler: typeof badgeUpdate;
 }, {
-    readonly name: "openloyalty_badge_get_member_badges";
+    readonly name: "ol_badge_get_member_badges";
+    readonly title: "Get Member Badges";
     readonly 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 readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;

package/dist/tools/badge.js

@@ -1,32 +1,32 @@
 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."),
+    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 (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 10)."),
     name: z.string().optional().describe("Filter by badge name."),
     badgeTypeId: z.string().optional().describe("Filter by specific badge type ID."),
 };
 export const BadgeGetInputSchema = {
-    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."),
     badgeTypeId: z.string().describe("The badge type ID (UUID) to retrieve."),
 };
 export const BadgeUpdateInputSchema = {
-    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."),
     badgeTypeId: z.string().describe("The badge type ID (UUID) to update."),
-    name: z.string().optional().describe("Badge name."),
+    name: z.string().describe("Badge name (REQUIRED). API requires name as a direct field."),
     translations: z.record(z.string(), z.object({
         name: z.string(),
         description: z.string().optional(),
-    })).optional().describe("Badge translations."),
+    })).optional().describe("Badge translations (for convenience - will extract name from translations.en.name if name not provided directly)."),
     imageUrl: z.string().optional().describe("URL to badge image."),
     active: z.boolean().optional().describe("Whether badge type is active."),
 };
 export const BadgeGetMemberBadgesInputSchema = {
-    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."),
     memberId: z.string().describe("The member ID (UUID)."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 10)."),
@@ -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));
@@ -66,28 +65,31 @@ export async function badgeList(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_badge_list");
+        throw formatApiError(error, "ol_badge_list");
     }
 }
 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;
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_badge_get");
+        throw formatApiError(error, "ol_badge_get");
     }
 }
 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;
-    if (input.translations)
-        badgePayload.translations = input.translations;
+    // API requires name as direct field, not nested in translations
+    // Extract from translations.en.name if name not provided directly
+    let badgeName = input.name;
+    if (!badgeName && input.translations?.en?.name) {
+        badgeName = input.translations.en.name;
+    }
+    if (badgeName !== undefined)
+        badgePayload.name = badgeName;
+    // Note: API does not accept nested translations - only direct fields
     if (input.imageUrl !== undefined)
         badgePayload.imageUrl = input.imageUrl;
     if (input.active !== undefined)
@@ -97,12 +99,11 @@ export async function badgeUpdate(input) {
         await apiPut(`/${storeCode}/badge-type/${input.badgeTypeId}`, { badgeType: badgePayload });
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_badge_update");
+        throw formatApiError(error, "ol_badge_update");
     }
 }
 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));
@@ -133,32 +134,40 @@ export async function badgeGetMemberBadges(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_badge_get_member_badges");
+        throw formatApiError(error, "ol_badge_get_member_badges");
     }
 }
 // Tool definitions
 export const badgeToolDefinitions = [
     {
-        name: "openloyalty_badge_list",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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",
+        name: "ol_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,
     },