@open-loyalty/mcp-server 1.0.0

package/dist/tools/analytics.d.ts

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { TierAnalytics, MemberAnalytics, PointsAnalytics, TransactionAnalytics, ReferralAnalytics, CampaignAnalytics, DashboardOverview, UnitsOverview } from "../types/schemas/analytics.js";
+export declare const AnalyticsTiersInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsMembersInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    withTransaction: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const AnalyticsPointsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsTransactionsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsReferralsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsCampaignsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    executedAt: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsDashboardInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    dataType: z.ZodOptional<z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsUnitsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    walletTypeCode: z.ZodString;
+    dataType: z.ZodOptional<z.ZodEnum<["unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"]>>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsCampaignDetailInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodString;
+};
+export declare function analyticsTiers(input: {
+    storeCode?: string;
+}): Promise<TierAnalytics>;
+export declare function analyticsMembers(input: {
+    storeCode?: string;
+    withTransaction?: boolean;
+}): Promise<MemberAnalytics>;
+export declare function analyticsPoints(input: {
+    storeCode?: string;
+}): Promise<PointsAnalytics>;
+export declare function analyticsTransactions(input: {
+    storeCode?: string;
+}): Promise<TransactionAnalytics>;
+export declare function analyticsReferrals(input: {
+    storeCode?: string;
+}): Promise<ReferralAnalytics>;
+export declare function analyticsCampaigns(input: {
+    storeCode?: string;
+    page?: number;
+    perPage?: number;
+    executedAt?: string;
+}): Promise<CampaignAnalytics>;
+export declare function analyticsDashboard(input: {
+    storeCode?: string;
+    dataType?: string;
+    aggregationType?: string;
+    intervalStartDate?: string;
+    intervalEndDate?: string;
+}): Promise<DashboardOverview>;
+export declare function analyticsUnits(input: {
+    storeCode?: string;
+    walletTypeCode: string;
+    dataType?: string;
+    aggregationType?: string;
+    intervalStartDate?: string;
+    intervalEndDate?: string;
+}): Promise<UnitsOverview>;
+export declare function analyticsCampaignDetail(input: {
+    storeCode?: string;
+    campaignId: string;
+}): Promise<Record<string, unknown>>;
+export declare const analyticsToolDefinitions: readonly [{
+    readonly name: "openloyalty_analytics_tiers";
+    readonly description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsTiers;
+}, {
+    readonly name: "openloyalty_analytics_members";
+    readonly 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 inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        withTransaction: z.ZodOptional<z.ZodBoolean>;
+    };
+    readonly handler: typeof analyticsMembers;
+}, {
+    readonly name: "openloyalty_analytics_points";
+    readonly 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 inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsPoints;
+}, {
+    readonly name: "openloyalty_analytics_transactions";
+    readonly 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 inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsTransactions;
+}, {
+    readonly name: "openloyalty_analytics_referrals";
+    readonly description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsReferrals;
+}, {
+    readonly name: "openloyalty_analytics_campaigns";
+    readonly description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        executedAt: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsCampaigns;
+}, {
+    readonly name: "openloyalty_analytics_dashboard";
+    readonly 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 inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        dataType: z.ZodOptional<z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>>;
+        aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+        intervalStartDate: z.ZodOptional<z.ZodString>;
+        intervalEndDate: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsDashboard;
+}, {
+    readonly name: "openloyalty_analytics_units";
+    readonly 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 inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        walletTypeCode: z.ZodString;
+        dataType: z.ZodOptional<z.ZodEnum<["unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"]>>;
+        aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+        intervalStartDate: z.ZodOptional<z.ZodString>;
+        intervalEndDate: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof analyticsUnits;
+}, {
+    readonly name: "openloyalty_analytics_campaign_detail";
+    readonly description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodString;
+    };
+    readonly handler: typeof analyticsCampaignDetail;
+}];

package/dist/tools/analytics.js

@@ -0,0 +1,245 @@
+import { z } from "zod";
+import { apiGet } from "../client/http.js";
+import { formatApiError } from "../utils/errors.js";
+import { getConfig } 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."),
+};
+export const AnalyticsMembersInputSchema = {
+    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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."),
+};
+export const AnalyticsTransactionsInputSchema = {
+    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+};
+export const AnalyticsReferralsInputSchema = {
+    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+};
+export const AnalyticsCampaignsInputSchema = {
+    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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."),
+    dataType: z.enum([
+        "registeredMembers", "activeMembers", "revenue", "avgSpending",
+        "transactions", "avgTransactionValue", "avgNumberOfTransactions"
+    ]).optional().describe("Type of data to retrieve."),
+    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."),
+    walletTypeCode: z.string().describe("Wallet type code (e.g., 'default' or 'points')."),
+    dataType: z.enum([
+        "unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"
+    ]).optional().describe("Type of data to retrieve."),
+    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 AnalyticsCampaignDetailInputSchema = {
+    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    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;
+    try {
+        const response = await apiGet(`/${storeCode}/analytics/levels`);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_tiers");
+    }
+}
+export async function analyticsMembers(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    const params = new URLSearchParams();
+    if (input.withTransaction !== undefined) {
+        params.append("withTransaction", String(input.withTransaction));
+    }
+    const queryString = params.toString();
+    const url = `/${storeCode}/analytics/members${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_members");
+    }
+}
+export async function analyticsPoints(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    try {
+        const response = await apiGet(`/${storeCode}/analytics/points`);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_points");
+    }
+}
+export async function analyticsTransactions(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    try {
+        const response = await apiGet(`/${storeCode}/analytics/transactions`);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_transactions");
+    }
+}
+export async function analyticsReferrals(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    try {
+        const response = await apiGet(`/${storeCode}/analytics/referrals`);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_referrals");
+    }
+}
+export async function analyticsCampaigns(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    const params = new URLSearchParams();
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    if (input.executedAt)
+        params.append("executedAt", input.executedAt);
+    const queryString = params.toString();
+    const url = `/${storeCode}/analytics/campaigns${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_campaigns");
+    }
+}
+export async function analyticsDashboard(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    const params = new URLSearchParams();
+    if (input.dataType)
+        params.append("dataType", input.dataType);
+    if (input.aggregationType)
+        params.append("aggregationType", input.aggregationType);
+    if (input.intervalStartDate)
+        params.append("intervalStartDate", input.intervalStartDate);
+    if (input.intervalEndDate)
+        params.append("intervalEndDate", input.intervalEndDate);
+    const queryString = params.toString();
+    const url = `/${storeCode}/analytics/dashboard/general-overview${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_dashboard");
+    }
+}
+export async function analyticsUnits(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    const params = new URLSearchParams();
+    if (input.dataType)
+        params.append("dataType", input.dataType);
+    if (input.aggregationType)
+        params.append("aggregationType", input.aggregationType);
+    if (input.intervalStartDate)
+        params.append("intervalStartDate", input.intervalStartDate);
+    if (input.intervalEndDate)
+        params.append("intervalEndDate", input.intervalEndDate);
+    const queryString = params.toString();
+    const url = `/${storeCode}/analytics/units-overview/${input.walletTypeCode}${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_units");
+    }
+}
+export async function analyticsCampaignDetail(input) {
+    const config = getConfig();
+    const storeCode = input.storeCode || config.defaultStoreCode;
+    try {
+        const response = await apiGet(`/${storeCode}/analytics/campaign/${input.campaignId}`);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_analytics_campaign_detail");
+    }
+}
+// Tool definitions
+export const analyticsToolDefinitions = [
+    {
+        name: "openloyalty_analytics_tiers",
+        description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.",
+        inputSchema: AnalyticsTiersInputSchema,
+        handler: analyticsTiers,
+    },
+    {
+        name: "openloyalty_analytics_members",
+        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.",
+        inputSchema: AnalyticsMembersInputSchema,
+        handler: analyticsMembers,
+    },
+    {
+        name: "openloyalty_analytics_points",
+        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.",
+        inputSchema: AnalyticsPointsInputSchema,
+        handler: analyticsPoints,
+    },
+    {
+        name: "openloyalty_analytics_transactions",
+        description: "Get transaction analytics showing purchase trends. Returns transaction counts by intervals, total count, total amount, and average values. Use to monitor sales performance.",
+        inputSchema: AnalyticsTransactionsInputSchema,
+        handler: analyticsTransactions,
+    },
+    {
+        name: "openloyalty_analytics_referrals",
+        description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.",
+        inputSchema: AnalyticsReferralsInputSchema,
+        handler: analyticsReferrals,
+    },
+    {
+        name: "openloyalty_analytics_campaigns",
+        description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.",
+        inputSchema: AnalyticsCampaignsInputSchema,
+        handler: analyticsCampaigns,
+    },
+    {
+        name: "openloyalty_analytics_dashboard",
+        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.",
+        inputSchema: AnalyticsDashboardInputSchema,
+        handler: analyticsDashboard,
+    },
+    {
+        name: "openloyalty_analytics_units",
+        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.",
+        inputSchema: AnalyticsUnitsInputSchema,
+        handler: analyticsUnits,
+    },
+    {
+        name: "openloyalty_analytics_campaign_detail",
+        description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.",
+        inputSchema: AnalyticsCampaignDetailInputSchema,
+        handler: analyticsCampaignDetail,
+    },
+];

package/dist/tools/apikey.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export interface ApiKey {
+    apiKeyId: string;
+    token?: string;
+    adminId: string;
+    name: string;
+    legacy?: boolean;
+    expirationDate?: string;
+}
+export interface ApiKeyListResponse {
+    items: ApiKey[];
+    total?: {
+        all?: number | string;
+        filtered?: number | string;
+        estimated?: boolean;
+    };
+}
+export declare const ApiKeyCreateInputSchema: {
+    adminId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    expirationDate: z.ZodOptional<z.ZodString>;
+};
+export declare const ApiKeyListInputSchema: {
+    adminId: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};
+export declare const ApiKeyDeleteInputSchema: {
+    adminId: z.ZodString;
+    apiKeyId: z.ZodString;
+};
+export declare function apiKeyCreate(input: {
+    adminId: string;
+    name?: string;
+    expirationDate?: string;
+}): Promise<ApiKey>;
+export declare function apiKeyList(input: {
+    adminId: string;
+    page?: number;
+    perPage?: number;
+}): Promise<ApiKeyListResponse>;
+export declare function apiKeyDelete(input: {
+    adminId: string;
+    apiKeyId: string;
+}): Promise<void>;
+export declare const apiKeyToolDefinitions: readonly [{
+    readonly name: "openloyalty_apikey_create";
+    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 inputSchema: {
+        adminId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        expirationDate: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof apiKeyCreate;
+}, {
+    readonly name: "openloyalty_apikey_list";
+    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 inputSchema: {
+        adminId: z.ZodString;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly handler: typeof apiKeyList;
+}, {
+    readonly name: "openloyalty_apikey_delete";
+    readonly description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.";
+    readonly inputSchema: {
+        adminId: z.ZodString;
+        apiKeyId: z.ZodString;
+    };
+    readonly handler: typeof apiKeyDelete;
+}];

package/dist/tools/apikey.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { apiGet, apiPost, apiDelete } from "../client/http.js";
+import { formatApiError } from "../utils/errors.js";
+// Input Schemas
+export const ApiKeyCreateInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) to create API key for."),
+    name: z.string().optional().describe("Name/description for the API key."),
+    expirationDate: z.string().optional().describe("Expiration date (ISO format: YYYY-MM-DD)."),
+};
+export const ApiKeyListInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) to list API keys for."),
+    page: z.number().optional().describe("Page number (default: 1)."),
+    perPage: z.number().optional().describe("Items per page (default: 25)."),
+};
+export const ApiKeyDeleteInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) that owns the API key."),
+    apiKeyId: z.string().describe("The API key ID to delete."),
+};
+// Handler functions
+export async function apiKeyCreate(input) {
+    const payload = {};
+    if (input.name)
+        payload.name = input.name;
+    if (input.expirationDate)
+        payload.expirationDate = input.expirationDate;
+    try {
+        const response = await apiPost(`/admin/${input.adminId}/api-key`, { apiKey: payload });
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_apikey_create");
+    }
+}
+export async function apiKeyList(input) {
+    const params = new URLSearchParams();
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    const queryString = params.toString();
+    const url = `/admin/${input.adminId}/api-key${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_apikey_list");
+    }
+}
+export async function apiKeyDelete(input) {
+    try {
+        await apiDelete(`/admin/${input.adminId}/api-key/${input.apiKeyId}`);
+    }
+    catch (error) {
+        throw formatApiError(error, "openloyalty_apikey_delete");
+    }
+}
+// Tool definitions
+export const apiKeyToolDefinitions = [
+    {
+        name: "openloyalty_apikey_create",
+        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.",
+        inputSchema: ApiKeyCreateInputSchema,
+        handler: apiKeyCreate,
+    },
+    {
+        name: "openloyalty_apikey_list",
+        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.",
+        inputSchema: ApiKeyListInputSchema,
+        handler: apiKeyList,
+    },
+    {
+        name: "openloyalty_apikey_delete",
+        description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.",
+        inputSchema: ApiKeyDeleteInputSchema,
+        handler: apiKeyDelete,
+    },
+];

package/dist/tools/audit.d.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+export interface AuditLogStore {
+    storeId: string;
+    code: string;
+    currency?: string;
+    name: string;
+    active?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+export interface AuditLogEntry {
+    auditLogId: string;
+    store?: AuditLogStore;
+    eventType: string;
+    entityType: string;
+    entityId: string;
+    username: string;
+    userId?: string;
+    userType?: string;
+    ip?: string;
+    createdAt: string;
+}
+export interface AuditLogListResponse {
+    items: AuditLogEntry[];
+    total?: Record<string, unknown>;
+}
+export interface AuditExport {
+    exportId: string;
+    status: string;
+    createdAt: string;
+    finishedAt?: string;
+    criteria?: string;
+    exportedRows?: number;
+    message?: string;
+}
+export interface AuditExportListResponse {
+    items: AuditExport[];
+    total?: {
+        all?: number;
+        filtered?: number;
+        estimated?: boolean;
+    };
+}
+export declare const AuditListInputSchema: {
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    eventType: z.ZodOptional<z.ZodString>;
+    entityId: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    store: z.ZodOptional<z.ZodString>;
+};
+export declare const AuditExportInputSchema: {
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};
+export declare function auditList(input: {
+    page?: number;
+    perPage?: number;
+    eventType?: string;
+    entityId?: string;
+    entityType?: string;
+    username?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    store?: string;
+}): Promise<AuditLogListResponse>;
+export declare function auditExport(input: {
+    dateFrom?: string;
+    dateTo?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<{
+    exportId: string;
+}>;
+export declare const auditToolDefinitions: readonly [{
+    readonly name: "openloyalty_audit_list";
+    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 inputSchema: {
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        eventType: z.ZodOptional<z.ZodString>;
+        entityId: z.ZodOptional<z.ZodString>;
+        entityType: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        dateFrom: z.ZodOptional<z.ZodString>;
+        dateTo: z.ZodOptional<z.ZodString>;
+        store: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof auditList;
+}, {
+    readonly name: "openloyalty_audit_export";
+    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 inputSchema: {
+        dateFrom: z.ZodOptional<z.ZodString>;
+        dateTo: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly handler: typeof auditExport;
+}];