Mage MCP connects an AI app you already use, such as Claude, Cursor or Codex, to Mage Loyalty. Once it is connected, you can ask the app about your loyalty program and it answers using your live Mage Loyalty data, so you do not have to look things up yourself.
Mage MCP is included on the Growth plan and above. It is not available during a free trial and unlocks as soon as your paid plan starts.
Questions You Can Ask
Ask in your own words. Here are some ideas to start with.
Customers and orders
"What is the points balance and VIP tier for [email protected]?"
"What has [email protected] earned and redeemed this year?"
"Why did order #1234 not earn points?"
Your program
"How is my loyalty program set up?"
"Which of my rewards do customers pick most often?"
"How did my last bonus campaign perform?"
Your results
"How many points were redeemed last month compared with the month before?"
"How much revenue did the loyalty program drive this quarter?"
"What are my most wishlisted products?"
How Mage Loyalty works
"How do I set up birthday points?"
What You Need
Mage Loyalty on the Growth plan or above.
One of these AI apps: Claude Code, Claude Desktop, Cursor or Codex.
Access to the Mage Loyalty settings in your Shopify admin.
Set It Up in Three Steps
Create a key. In Mage Loyalty, open Settings, then Developer, then MCP. Add a label if you like, for example "Claude on my laptop", and click Create key. Your key is shown once, so keep the window open for the next step.
Add Mage to your AI app. In the same window, find the row for your app, for example Set up Claude Code, and click Copy setup. Click View on that row to see where it goes, then paste it there. Your key is already filled in.
Ask a question. Restart your AI app if the row asks you to, then try "How is my loyalty program set up?".
Keeping Your Data Safe
It can look, not change. Your AI app can read your loyalty data, but it cannot add or remove points, change a customer's tier, create rewards or edit your settings. To make changes, open the Mage Loyalty app.
Your store only. A key only works for the store it was created in.
Treat a key like a password. Anyone who has it can read your store's loyalty data, including customer details, through their AI app. Do not share it or post it anywhere.
Remove a key at any time. Open Settings, then Developer, then MCP, and click Revoke. The key stops working straight away.
Answers go to your AI app. What you ask and the answers you get pass through the AI app you connected, so its own privacy terms apply.
Tips for Better Answers
For a customer, use their full email address. For an order, use the order number, for example #1234.
Say the period you mean, for example "last month" or "this year". Results match the numbers on your Analytics page.
Troubleshooting
My AI app cannot connect, or says the key is not valid
Check you pasted the whole setup, without missing the start or the end.
If the key was revoked, create a new one and set the app up again.
It says Mage MCP is available on the Growth plan and above
Your store is on a lower plan. Upgrade to Growth to use Mage MCP.
It says Mage MCP unlocks when the trial ends
Mage MCP becomes available as soon as your paid plan begins.
It cannot find a customer or an order
Check the email is typed in full and matches the one on the customer's Shopify account, or check the order number.
I cannot see MCP in my settings
Contact us and we will take a look.
Need a hand? Reach us on the live chat or at [email protected].