@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/prompts/fan-engagement-setup.js

@@ -0,0 +1,492 @@
+/**
+ * Fan Engagement Setup Prompts
+ *
+ * MCP prompt templates for guided campaign setup.
+ * These define conversational flows and default values for AI agents
+ * to help program admins create fan engagement campaigns.
+ */
+// ============================================================================
+// Default Values
+// ============================================================================
+export const DEFAULTS = {
+    // Match Attendance
+    matchAttendance: {
+        coinsPerMatch: 50,
+        milestones: [6, 12],
+        milestoneBonuses: { 6: 500, 12: 1000, "80%": 2000 },
+        limitPerDay: 1,
+        badges: { 6: "Silver", 12: "Gold", "80%": "Platinum" },
+    },
+    // Early Arrival
+    earlyArrival: {
+        minutesBefore: 60,
+        coinsPerArrival: 25,
+        limitPerMatch: 1,
+    },
+    // Sports Bar
+    sportsbarVisit: {
+        coinsPerVisit: 50,
+        visitMilestone: 5,
+        milestoneBonus: 500,
+        limitPerDay: 1,
+    },
+    // VOD Watching
+    vodWatching: {
+        trackBy: "minutes",
+        coinsPerUnit: 10,
+        unitSize: 10, // coins per X minutes
+        achievementMinutes: 300,
+        achievementBonus: 200,
+    },
+    // App Login Streak
+    appLoginStreak: {
+        coinsPerLogin: 5,
+        streakDays: 7,
+        streakBonus: 50,
+        limitPerDay: 1,
+    },
+    // General
+    seasonDates: {
+        start: new Date().toISOString().split("T")[0],
+        end: new Date(new Date().setFullYear(new Date().getFullYear() + 1)).toISOString().split("T")[0],
+    },
+};
+// ============================================================================
+// Workflow Definitions
+// ============================================================================
+export const MATCH_ATTENDANCE_WORKFLOW = {
+    id: "match-attendance",
+    name: "Match Attendance Campaign",
+    description: "Reward fans for attending matches with coins and achievements",
+    triggerPhrases: [
+        "set up a campaign to reward fans for attending matches",
+        "create match attendance rewards",
+        "reward match attendance",
+        "attendance campaign",
+        "match attendance",
+    ],
+    questions: [
+        {
+            id: "coinsPerMatch",
+            question: "How many coins should fans receive per match attendance?",
+            type: "number",
+            default: DEFAULTS.matchAttendance.coinsPerMatch,
+            hint: "Common values: 50, 100, 200",
+        },
+        {
+            id: "createAchievements",
+            question: "Set up achievements for attending multiple matches?",
+            type: "boolean",
+            default: true,
+            hint: "Creates milestone achievements (e.g., 6 matches, 12 matches)",
+        },
+        {
+            id: "milestones",
+            question: "What attendance milestones should earn achievements?",
+            type: "string",
+            default: "6,12",
+            hint: "Comma-separated numbers (e.g., '6,12' or '6,12,80%')",
+        },
+        {
+            id: "badgeNames",
+            question: "What badge names for each milestone?",
+            type: "string",
+            default: "Silver,Gold",
+            hint: "Comma-separated names matching milestones (e.g., 'Silver,Gold,Platinum')",
+        },
+        {
+            id: "milestoneBonuses",
+            question: "Bonus coins for each milestone?",
+            type: "string",
+            default: "500,1000",
+            hint: "Comma-separated values matching milestones",
+        },
+        {
+            id: "limitPerDay",
+            question: "Maximum attendances per day (anti-fraud)?",
+            type: "number",
+            default: DEFAULTS.matchAttendance.limitPerDay,
+            hint: "Usually 1 to prevent multiple scans per match",
+        },
+        {
+            id: "seasonStart",
+            question: "Season start date?",
+            type: "string",
+            default: DEFAULTS.seasonDates.start,
+            hint: "ISO format: YYYY-MM-DD",
+        },
+        {
+            id: "seasonEnd",
+            question: "Season end date?",
+            type: "string",
+            default: DEFAULTS.seasonDates.end,
+            hint: "ISO format: YYYY-MM-DD",
+        },
+    ],
+    steps: [
+        {
+            id: "create-base-campaign",
+            action: "Create base match attendance campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign with custom_event trigger for match_attendance event",
+        },
+        {
+            id: "create-achievements",
+            action: "Create milestone achievements",
+            tool: "openloyalty_achievement_create",
+            description: "Creates achievements for each attendance milestone with badges",
+        },
+        {
+            id: "create-achievement-campaigns",
+            action: "Create achievement bonus campaigns",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaigns triggered by achievement completion for bonus coins",
+        },
+        {
+            id: "verify",
+            action: "Verify all campaigns and achievements",
+            tool: "openloyalty_campaign_list",
+            description: "Lists created campaigns to confirm setup",
+        },
+    ],
+};
+export const EARLY_ARRIVAL_WORKFLOW = {
+    id: "early-arrival",
+    name: "Early Arrival Campaign",
+    description: "Reward fans who arrive early to matches",
+    triggerPhrases: [
+        "reward fans who arrive early",
+        "early arrival rewards",
+        "early arrival campaign",
+        "reward early arrival",
+    ],
+    questions: [
+        {
+            id: "minutesBefore",
+            question: "How early (in minutes) counts as 'early arrival'?",
+            type: "number",
+            default: DEFAULTS.earlyArrival.minutesBefore,
+            hint: "Common values: 30, 45, 60 minutes before kickoff",
+        },
+        {
+            id: "coinsPerArrival",
+            question: "How many coins for early arrival?",
+            type: "number",
+            default: DEFAULTS.earlyArrival.coinsPerArrival,
+            hint: "Usually less than match attendance reward",
+        },
+        {
+            id: "limitPerMatch",
+            question: "Limit early arrival bonus per match?",
+            type: "number",
+            default: DEFAULTS.earlyArrival.limitPerMatch,
+            hint: "1 = one bonus per match day",
+        },
+    ],
+    steps: [
+        {
+            id: "create-campaign",
+            action: "Create early arrival campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign with custom_event trigger and minutes_before condition",
+        },
+    ],
+};
+export const SPORTSBAR_VISIT_WORKFLOW = {
+    id: "sportsbar-visit",
+    name: "Sports Bar Visit Campaign",
+    description: "Reward fans for visiting the sports bar",
+    triggerPhrases: [
+        "set up rewards for visiting the sports bar",
+        "sports bar visit rewards",
+        "sportsbar visit campaign",
+        "reward bar visits",
+    ],
+    questions: [
+        {
+            id: "coinsPerVisit",
+            question: "How many coins per sports bar visit?",
+            type: "number",
+            default: DEFAULTS.sportsbarVisit.coinsPerVisit,
+            hint: "Common values: 25, 50, 100",
+        },
+        {
+            id: "createAchievement",
+            question: "Set up achievement for multiple visits?",
+            type: "boolean",
+            default: true,
+            hint: "Creates milestone achievement for visiting X times",
+        },
+        {
+            id: "visitMilestone",
+            question: "How many visits for the achievement?",
+            type: "number",
+            default: DEFAULTS.sportsbarVisit.visitMilestone,
+            hint: "Common values: 5, 10, 20",
+        },
+        {
+            id: "milestoneBonus",
+            question: "Bonus coins for completing the achievement?",
+            type: "number",
+            default: DEFAULTS.sportsbarVisit.milestoneBonus,
+            hint: "Bonus awarded when milestone is reached",
+        },
+        {
+            id: "limitPerDay",
+            question: "Maximum visits counted per day?",
+            type: "number",
+            default: DEFAULTS.sportsbarVisit.limitPerDay,
+            hint: "Prevents abuse from multiple scans",
+        },
+    ],
+    steps: [
+        {
+            id: "create-visit-campaign",
+            action: "Create visit campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign with custom_event trigger for sportsbar_visit",
+        },
+        {
+            id: "create-achievement",
+            action: "Create visit milestone achievement",
+            tool: "openloyalty_achievement_create",
+            description: "Creates achievement for visiting X times",
+        },
+        {
+            id: "create-achievement-campaign",
+            action: "Create achievement bonus campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign triggered by achievement completion",
+        },
+    ],
+};
+export const VOD_WATCHING_WORKFLOW = {
+    id: "vod-watching",
+    name: "VOD Watching Campaign",
+    description: "Reward fans for watching video content",
+    triggerPhrases: [
+        "reward fans for watching video content",
+        "vod watching rewards",
+        "video content rewards",
+        "reward watching videos",
+    ],
+    questions: [
+        {
+            id: "trackBy",
+            question: "Track by views or minutes watched?",
+            type: "select",
+            options: ["views", "minutes"],
+            default: DEFAULTS.vodWatching.trackBy,
+            hint: "Minutes watched is more engagement-focused",
+        },
+        {
+            id: "coinsPerUnit",
+            question: "How many coins per unit (view or X minutes)?",
+            type: "number",
+            default: DEFAULTS.vodWatching.coinsPerUnit,
+            hint: "For minutes: coins per unitSize minutes",
+        },
+        {
+            id: "unitSize",
+            question: "If tracking minutes, how many minutes per reward?",
+            type: "number",
+            default: DEFAULTS.vodWatching.unitSize,
+            hint: "e.g., 10 = earn coins every 10 minutes watched",
+        },
+        {
+            id: "createAchievement",
+            question: "Set up achievement for total minutes/views?",
+            type: "boolean",
+            default: true,
+            hint: "Creates milestone achievement for watching X total",
+        },
+        {
+            id: "achievementTarget",
+            question: "Target for achievement (minutes or views)?",
+            type: "number",
+            default: DEFAULTS.vodWatching.achievementMinutes,
+            hint: "Total minutes or views to earn achievement",
+        },
+        {
+            id: "achievementBonus",
+            question: "Bonus coins for completing the achievement?",
+            type: "number",
+            default: DEFAULTS.vodWatching.achievementBonus,
+            hint: "Bonus awarded when target is reached",
+        },
+    ],
+    steps: [
+        {
+            id: "create-watch-campaign",
+            action: "Create VOD watching campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign with custom_event trigger for vod_watch",
+        },
+        {
+            id: "create-achievement",
+            action: "Create watching achievement",
+            tool: "openloyalty_achievement_create",
+            description: "Creates achievement tracking total minutes/views with attribute sum",
+        },
+        {
+            id: "create-achievement-campaign",
+            action: "Create achievement bonus campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign triggered by achievement completion",
+        },
+    ],
+};
+export const APP_LOGIN_STREAK_WORKFLOW = {
+    id: "app-login-streak",
+    name: "App Login Streak Campaign",
+    description: "Reward fans for daily login streaks",
+    triggerPhrases: [
+        "set up daily login rewards",
+        "daily login streak",
+        "app login rewards",
+        "login streak campaign",
+    ],
+    questions: [
+        {
+            id: "coinsPerLogin",
+            question: "How many coins per daily login?",
+            type: "number",
+            default: DEFAULTS.appLoginStreak.coinsPerLogin,
+            hint: "Usually a small amount (5-20)",
+        },
+        {
+            id: "createStreakBonus",
+            question: "Set up streak bonus?",
+            type: "boolean",
+            default: true,
+            hint: "Extra reward for consecutive daily logins",
+        },
+        {
+            id: "streakDays",
+            question: "How many consecutive days for streak bonus?",
+            type: "number",
+            default: DEFAULTS.appLoginStreak.streakDays,
+            hint: "Common values: 7, 14, 30 days",
+        },
+        {
+            id: "streakBonus",
+            question: "Bonus coins for completing the streak?",
+            type: "number",
+            default: DEFAULTS.appLoginStreak.streakBonus,
+            hint: "Bonus awarded when streak is achieved",
+        },
+    ],
+    steps: [
+        {
+            id: "create-login-campaign",
+            action: "Create daily login campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign with custom_event trigger for app_login, limited to 1/day",
+        },
+        {
+            id: "create-streak-achievement",
+            action: "Create login streak achievement",
+            tool: "openloyalty_achievement_create",
+            description: "Creates achievement for X consecutive daily logins",
+        },
+        {
+            id: "create-streak-campaign",
+            action: "Create streak bonus campaign",
+            tool: "openloyalty_campaign_create",
+            description: "Creates campaign triggered by streak achievement completion",
+        },
+    ],
+};
+// ============================================================================
+// All Workflows
+// ============================================================================
+export const ALL_WORKFLOWS = [
+    MATCH_ATTENDANCE_WORKFLOW,
+    EARLY_ARRIVAL_WORKFLOW,
+    SPORTSBAR_VISIT_WORKFLOW,
+    VOD_WATCHING_WORKFLOW,
+    APP_LOGIN_STREAK_WORKFLOW,
+];
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Find matching workflow based on user input
+ */
+export function findMatchingWorkflow(userInput) {
+    const input = userInput.toLowerCase();
+    return ALL_WORKFLOWS.find((workflow) => workflow.triggerPhrases.some((phrase) => input.includes(phrase.toLowerCase())));
+}
+/**
+ * Get workflow by ID
+ */
+export function getWorkflowById(id) {
+    return ALL_WORKFLOWS.find((workflow) => workflow.id === id);
+}
+/**
+ * Parse comma-separated values to array
+ */
+export function parseCommaSeparated(value) {
+    return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+/**
+ * Parse milestones (handles both numbers and percentages like "80%")
+ */
+export function parseMilestones(value) {
+    return parseCommaSeparated(value).map((v) => {
+        if (v.includes("%"))
+            return v;
+        const num = parseInt(v, 10);
+        return isNaN(num) ? v : num;
+    });
+}
+/**
+ * Format ISO date for Open Loyalty (YYYY-MM-DD HH:mm+TZ)
+ */
+export function formatOLDate(date) {
+    const d = typeof date === "string" ? new Date(date) : date;
+    const pad = (n) => n.toString().padStart(2, "0");
+    const offset = -d.getTimezoneOffset();
+    const offsetHours = Math.floor(Math.abs(offset) / 60);
+    const offsetSign = offset >= 0 ? "+" : "-";
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} 00:00${offsetSign}${pad(offsetHours)}:00`;
+}
+// ============================================================================
+// Prompt Templates for AI Agents
+// ============================================================================
+export const AGENT_PROMPTS = {
+    /**
+     * System prompt for fan engagement setup
+     */
+    systemPrompt: `You are helping a program admin set up fan engagement campaigns in Open Loyalty.
+For each campaign type, guide the user through the setup questions step by step.
+Use the default values when the user doesn't have a preference.
+After collecting all information, execute the workflow to create the campaigns and achievements.
+
+Available campaign types:
+1. Match Attendance - Reward fans for attending matches with coins and milestone achievements
+2. Early Arrival - Bonus for arriving early to matches
+3. Sports Bar Visits - Reward visits to the sports bar
+4. VOD Watching - Reward watching video content
+5. App Login Streak - Daily login rewards with streak bonuses
+
+When creating campaigns:
+- Always use custom_event trigger for fan engagement events
+- Custom events are defined inline (no separate create step needed)
+- Use achievement trigger for bonus campaigns on milestones
+- Set appropriate execution limits to prevent abuse
+- Create achievements with badges for milestone rewards`,
+    /**
+     * Workflow completion template
+     */
+    completionTemplate: (results) => `Your fan engagement program is now set up!
+
+Created campaigns:
+${results.campaignIds.map((id) => `- Campaign ID: ${id}`).join("\n")}
+
+Created achievements:
+${results.achievementIds.map((id) => `- Achievement ID: ${id}`).join("\n")}
+
+Summary:
+${results.summary}`,
+};

package/dist/server.d.ts

@@ -1,4 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-declare const SERVER_INSTRUCTIONS = "\nOpen Loyalty MCP Server - Complete Loyalty Program Management\n\n## Domain Model\n\nMember (loyalty program participant)\n  \u2514\u2500\u2500 Points (wallet balance, transfers)\n  \u2514\u2500\u2500 Tier (current level: Bronze, Silver, Gold)\n  \u2514\u2500\u2500 Transactions (purchase history)\n  \u2514\u2500\u2500 Rewards (redeemed coupons)\n  \u2514\u2500\u2500 Achievements (gamification progress)\n  \u2514\u2500\u2500 Badges (visual rewards from achievements)\n\nTierSet (loyalty program structure)\n  \u2514\u2500\u2500 Conditions (criteria: activeUnits, totalSpending)\n  \u2514\u2500\u2500 Tiers (levels with thresholds)\n\nWalletType (points currency configuration)\n\nReward (redeemable items)\n  \u2514\u2500\u2500 Categories (reward groupings)\n\nCampaign (automated points/rewards rules)\n  \u2514\u2500\u2500 Type (earning, spending, custom, instant_reward)\n  \u2514\u2500\u2500 Trigger (transaction, custom_event, points_transfer)\n  \u2514\u2500\u2500 Rules (SKU, category, transaction amount conditions)\n  \u2514\u2500\u2500 Effects (give_points, multiply_points, percentage_discount)\n  \u2514\u2500\u2500 Targeting (segments, tiers for audience)\n\nSegment (member audience grouping)\n  \u2514\u2500\u2500 Parts (groups of criteria - OR logic between parts)\n      \u2514\u2500\u2500 Criteria (conditions - AND logic within part)\n          Types: purchase_period, transaction_count, average_transaction,\n                 anniversary, last_purchase_days, tier\n\nAchievement (gamification goals)\n  \u2514\u2500\u2500 Trigger (transaction, custom_event, points_transfer, referral, login)\n  \u2514\u2500\u2500 CompleteRule (periodGoal, period type, unique counting)\n  \u2514\u2500\u2500 Badge (visual reward when completed)\n\nBadge (visual recognition)\n  \u2514\u2500\u2500 Linked to achievements via badgeTypeId\n  \u2514\u2500\u2500 Auto-created when referenced by achievement\n\n## Key Workflows\n\n### 1. Create 3-tier Loyalty Program:\nwallet_type_list \u2192 tierset_create \u2192 tierset_get \u2192 tierset_update_tiers\n\n### 2. Register and Reward Member:\nmember_create \u2192 points_add (welcome bonus) \u2192 member_get (verify)\n\n### 3. Record Purchase and Earn Points:\ntransaction_create (with customerData) \u2192 triggers campaigns \u2192 points auto-added\n\n### 4. Redeem Reward:\nreward_list \u2192 reward_buy (deducts points) \u2192 reward_redeem (mark coupon used)\n\n### 5. Assign Unmatched Transaction:\ntransaction_list (matched=false) \u2192 transaction_assign_member \u2192 points earned\n\n### 6. Check Member Tier Progress:\nmember_get_tier_progress \u2192 shows current tier, next tier, progress %\n\n### 7. Double Points for VIP Members:\nsegment_create (with tier criteria for VIP level) \u2192 campaign_create (targeting that segment with give_points effect and multiplier: 2)\n\n### 8. Purchase Achievement with Badge:\nbadge_list (find or note badgeTypeId) \u2192 achievement_create (trigger: transaction, periodGoal for amount, badgeTypeId)\n\n### 9. Create Targeted Promotion:\nsegment_create (define audience) \u2192 campaign_create (type: earning, target: segment, segmentIds: [segmentId])\n\n### 10. Track Member Gamification:\nachievement_list_member_achievements \u2192 badge_get_member_badges \u2192 achievement_get_member_progress\n\n## Discovery Paths:\n- Members: member_list \u2192 member_get \u2192 points_get_balance\n- Tiers: tierset_list \u2192 tierset_get \u2192 tierset_get_tiers\n- Rewards: reward_category_list \u2192 reward_list \u2192 reward_get\n- Transactions: transaction_list \u2192 transaction_get\n- Campaigns: campaign_list \u2192 campaign_get \u2192 campaign_simulate\n- Segments: segment_list \u2192 segment_get \u2192 segment_get_members \u2192 campaign_create (audience targeting)\n- Achievements: achievement_list \u2192 badge_list \u2192 achievement_create (with badge)\n- Member Gamification: achievement_list_member_achievements \u2192 badge_get_member_badges\n\n## Important Patterns:\n- conditionId REQUIRED for tier thresholds - call tierset_get after tierset_create\n- Points operations: check balance with points_get_balance before spending\n- Reward flow: reward_buy returns couponCode, use reward_redeem to mark used\n- Transactions auto-match to members via customerData (email, phone, loyaltyCardNumber)\n\n### Pagination:\n- Traditional pagination: use page + perPage params\n- Cursor pagination: provide cursor from previous response for efficient deep pagination\n- Cursor-enabled tools: member_list, transaction_list, points_get_history\n- First scroll request: cursor=\"\" (empty string)\n- Subsequent requests: use cursor value from previous response\n- When cursor provided, page param is ignored\n\n### Campaign Patterns:\n- Campaign types: earning (earn points), spending (spend points), custom (custom events), instant_reward\n- Triggers: transaction (purchase), custom_event, points_transfer, referral, registration\n- Effects: give_points, multiply_points, percentage_discount, fixed_discount\n- Target campaigns to segments or tiers using target: \"segment\" and segmentIds array\n\n### Segment Patterns:\n- Parts use OR logic (member matches ANY part)\n- Criteria within a part use AND logic (member must match ALL criteria in that part)\n- Common criteria: purchase_period (spending), transaction_count, average_transaction, anniversary, last_purchase_days, tier\n\n### Achievement Patterns:\n- Triggers: transaction, custom_event, points_transfer, reward_redemption, referral, achievement, tier_change, registration, profile_update, login\n- periodGoal sets the target (e.g., 5 purchases, 1000 points spent)\n- period defines timeframe: day, week, month, year, forever\n- Link to badge via badgeTypeId - badge auto-created if doesn't exist\n- uniqueAttribute for counting distinct values (e.g., unique products)\n\n## Phase 3: Analytics, Admin, Roles & Stores\n\n### Domain Model (Extended)\n\nAdmin (system user)\n  \u2514\u2500\u2500 Roles (permission sets)\n      \u2514\u2500\u2500 Permissions (resource + access level)\n  \u2514\u2500\u2500 API Keys (programmatic access)\n\nStore (multi-tenant container)\n  \u2514\u2500\u2500 Members, Campaigns, Rewards (isolated per store)\n\nAudit Log (compliance tracking)\n  \u2514\u2500\u2500 eventType, entityType, entityId, username, timestamp\n\n### Analytics Workflows:\n\n#### 11. Get Program Overview:\nanalytics_dashboard \u2192 analytics_tiers \u2192 analytics_members\n\n#### 12. Analyze Points Economy:\nanalytics_points \u2192 analytics_units (per wallet) \u2192 points_get_histogram\n\n#### 13. Measure Campaign Performance:\nanalytics_campaigns \u2192 analytics_campaign_detail (specific campaign)\n\n#### 14. Track Transactions:\nanalytics_transactions \u2192 transaction_list (details)\n\n### Aggregation Queries (Top Spenders, Purchase Analysis):\n\nIMPORTANT: For queries like \"top 5 spenders in July 2025\", use this approach:\n\n#### 15. Find Top Spenders by Date Range:\n1. transaction_list(purchasedAtFrom, purchasedAtTo, perPage=50, cursor='') - returns customerId with each transaction\n2. Use cursor pagination to fetch ALL pages - even if there are 1000+ transactions\n3. Aggregate grossValue by customerId in your code\n4. Sort by total spent, take top N\n5. member_get for each top spender to get names/details\n\nCRITICAL - DO NOT TRY TO BE SMART OR OPTIMIZE:\n- ALWAYS iterate through ALL pages using cursor pagination - this is the ONLY correct approach\n- DO NOT skip pages or try to sample data - you will get inaccurate results\n- DO NOT use transaction_get individually - transaction_list already includes customerId\n- DO NOT try to find \"smarter\" analytics endpoints - they don't exist for per-customer aggregation\n- Large datasets (1000+ transactions) are normal - just keep paginating until cursor is empty\n- Start with cursor='' (empty string), use returned cursor for next request, repeat until done\n\nExample: Top 5 spenders July 2025\n- First request: transaction_list(purchasedAtFrom: \"2025-07-01\", purchasedAtTo: \"2025-07-31\", perPage: 50, cursor: \"\")\n- Each result includes: transactionId, grossValue, customerId, purchasedAt\n- Keep fetching with returned cursor until response has no cursor or empty transactions\n- Even if there are 1500 transactions (30 pages), iterate through ALL of them\n- Group by customerId, sum grossValue, sort descending, take 5\n\n### Admin & Security Workflows:\n\n#### 15. Create Admin with Limited Role:\nacl_get_resources \u2192 role_create \u2192 admin_create (with roleId)\n\n#### 16. Generate API Key for Integration:\nadmin_get \u2192 apikey_create \u2192 SAVE TOKEN IMMEDIATELY (shown once!)\n\n#### 17. Audit User Actions:\naudit_list (filter by username/entity) \u2192 audit_export (compliance report)\n\n### Store Multi-Tenancy:\n\n#### 18. Create New Store:\nstore_create \u2192 configure campaigns/tiers \u2192 member_create (with storeCode)\n\n### Analytics Query Patterns:\n- All analytics tools support dateFrom/dateTo ISO date filters\n- analytics_dashboard: high-level program metrics\n- analytics_units: wallet-specific metrics (requires walletTypeCode)\n- analytics_campaign_detail: detailed metrics for single campaign\n\n### Admin \u2192 Role \u2192 Permission Model:\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502  Admin  \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 Role \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 Permission \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n     \u2502                            \u2502\n     \u2502                       resource + access\n     \u2502                       (VIEW, MODIFY, etc.)\n     \u25BC\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 API Key \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n\n### Store Multi-Tenancy:\n- Each store is isolated: members, campaigns, rewards, transactions\n- storeCode parameter routes requests to correct tenant\n- Default store used when storeCode omitted\n\n## Phase 4: Webhooks, Import & Export\n\n### Domain Model (Extended)\n\nWebhook Subscription (event notification)\n  \u2514\u2500\u2500 eventName (event to subscribe to)\n  \u2514\u2500\u2500 url (callback endpoint)\n  \u2514\u2500\u2500 headers (custom HTTP headers)\n\nImport (bulk data upload)\n  \u2514\u2500\u2500 type: member, groupValue, segmentMembers, unitTransferAdding, etc.\n  \u2514\u2500\u2500 status: pending, processing, succeed, failed\n  \u2514\u2500\u2500 items (individual row results)\n\nExport (bulk data download)\n  \u2514\u2500\u2500 type: campaignCode, member, memberTier, memberSegment, rewardFulfillment\n  \u2514\u2500\u2500 status: pending, done, failed, error\n  \u2514\u2500\u2500 CSV file (when status='done')\n\n### Webhook Workflows:\n\n#### 19. Subscribe to Member Events for CRM Sync:\nwebhook_events \u2192 webhook_create (eventName: 'member.created', url: 'https://crm.example.com/webhook')\n\n#### 20. List and Manage Subscriptions:\nwebhook_list \u2192 webhook_get \u2192 webhook_update or webhook_delete\n\n### Import Workflows:\n\n#### 21. Bulk Import Members from CSV:\nimport_create (type: 'member', fileContent: CSV data) \u2192 import_list \u2192 import_get (check status)\n\n#### 22. Bulk Add Points to Members:\nimport_create (type: 'unitTransferAdding', fileContent: CSV) \u2192 poll import_get until complete\n\n### Export Workflows:\n\n#### 23. Export Campaign Codes:\nexport_create (type: 'campaignCode', filters: { campaignId }) \u2192 poll export_get (until status='done') \u2192 export_download\n\n#### 24. Export Member Data:\nexport_create (type: 'member') \u2192 export_get \u2192 export_download (returns CSV)\n\n### Webhook Patterns:\n- Use webhook_events to discover available event types before subscribing\n- API uses wrapper: { webhookSubscription: { eventName, url, headers? } }\n- Common events: member.created, member.updated, transaction.created, reward.purchased\n\n### Import Patterns:\n- Import is async: create returns importId, poll status with import_get\n- CSV format required - provide plain text, not base64\n- Types: member, groupValue, segmentMembers, unitTransferAdding, unitTransferSpending, transaction, campaignCode, rewardCoupon\n\n### Export Patterns:\n- Export is async: create returns exportId, poll status until 'done'\n- API body wrapper varies by type: { campaignCode: { filters... } }\n- Only call export_download when status='done'\n- Types: campaignCode, member, memberTier, memberSegment, rewardFulfillment\n";
+import { SERVER_INSTRUCTIONS } from "./instructions.js";
 export declare function createServer(): McpServer;
 export { SERVER_INSTRUCTIONS };