What you can ask
| Area | Try asking |
|---|---|
| Getting oriented | "How is my loyalty program set up?" · "Is my loyalty program healthy?" |
| Members and points | "How many points does [email protected] have?" · "How many points until this customer reaches the next tier?" · "Who are my top 10 members?" |
| Point history | "Why does this customer have 850 points when they had 500?" · "Which members earned points in the last 7 days?" |
| Missing points | "Why didn't order #1234 earn any points?" |
| Tiers and rewards | "What are my VIP tier thresholds?" · "How many members are in Gold?" · "What can customers redeem points for?" |
| Growth and retention | "Who is about to reach Gold?" · "Whose points expire in the next 30 days?" · "Who is about to drop a tier?" |
| Referrals | "Is my referral program on?" · "How many people has [email protected] referred?" |
| Analytics | "How much revenue did loyalty drive last month vs last year?" · "Which tier spends the most?" · "What's my redemption rate?" |
| Suspicious activity | "Is this member abusing the referral program?" |
| Storefront | "Is the Joy widget turned on in my theme?" · "What does my loyalty page look like?" · "Match my widget colors to my store's branding." (needs settings changes) |
| Changes (Full access) | "Award 500 points to [email protected] — her order shipped late." · "Correct this customer's balance to 1,200." · "Move this customer to Gold." · "Change the loyalty page headline to 'Join the club'." |
Saved workflows
Saved workflows guide the assistant through a common task step by step, such as a missing
points investigation or a program review, and end with a clear conclusion. In Claude, find
them in the + menu of the message box. In Claude Code, type / and look for
mcp__joy-loyalty__ followed by the workflow name.
| Workflow | Name | What it does | You provide |
|---|---|---|---|
| Investigate missing points for an order | support_missing_points | Checks whether the points were already awarded, correctly blocked by a rule, or genuinely missing. Proposes the exact fix and waits for your go-ahead. | Email, order number (optional) |
| Loyalty program review (health + revenue + tiers + referral) | program_review | Health check, revenue, tier performance and referrals in one pass. Starts with a short summary, then anything unusual, then one recommended action. | Period (optional, default last 30 days) |
| Investigate a member for abuse risk | investigate_member | Runs the abuse checks on one member and tells you which records to open in Joy. Never takes action. | |
| Set up the storefront loyalty widget | set_up_storefront_widget | Checks your live theme for the Joy widget and blocks, explains what's missing, and links you to fix it. | Focus (optional) |
| Set up a loyalty program safely | setup_loyalty_program | Reviews your current setup, proposes a simple program, then applies each change one at a time with a preview. Needs settings changes (local server only). | Business type and goal (both optional) |
| Apply storefront branding to a widget draft | apply_brand_to_widget | Scans your store's colors and fonts and applies them to a widget draft for you to publish. Needs settings changes (local server only). | Preferences (optional) |