Leal MCP. Manage loyalty points and customer retention history.
Leal connects your AI agent directly to a robust digital loyalty platform for retail businesses. Instantly manage customer retention by tracking points, viewing detailed member profiles across different tiers, and running personalized campaigns based on real-time purchase history in Latin America.
Claude 
ChatGPT 
Cursor 
Gemini 
Windsurf 
VS Code 
JetBrains 
Vercel Give Claude and any AI agent real-world access
Retrieves a full list of all loyalty program participants, allowing you to count and categorize your entire customer base.
Pulls up the complete details for one specific customer, including their current status and tier level.
Verifies a user’s total points balance and pulls a chronological record of every transaction that affected their score.
Accesses detailed information on pre-defined customer segments, helping you target specific demographics for promotions.
Lists all available reward types and their point costs, so your agent knows what incentives can be offered.
Provides a list of every enrolled physical store location connected to the loyalty program.
Ask an AI about this
Waiting for input…
What AI agents can do with Leal: 12 Tools for Customer Retention
Use these twelve tools to manage every aspect of your customer lifecycle, from listing members to checking transaction history.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Leal MCPCheck Leal Status
Verifies if the connection to the Leal platform is active and working correctly.
Get Member Balance
Retrieves a specific customer's current accumulated points balance.
Get Member
Fetches the full profile details for an identified loyalty member.
Get Member Transactions
Provides a detailed history of all point-affecting transactions for one specific...
Get Segment
Gets detailed information about a specific customer segment by name or ID.
Get Store
Retrieves the details for a single, identified store location.
List Campaigns
Lists all marketing campaigns that have been run or are currently active in the system.
List Members
Generates a comprehensive list of every member enrolled in the loyalty program.
List Rewards
Shows all reward options that are configured and available for members to redeem...
List Segments
Provides a list of all defined customer segments used by the platform.
List Stores
Gives a comprehensive listing of every store location connected to Leal.
List Transactions
Lists all general transaction records across the entire network, not just for one member.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/vk_preview_IUQ9IgkFtPnLdOkLtky5MxTWNMnRw9cE0IhAbwmT/mcp
Preview token vk_preview_IUQ9IgkFtPnLdOkLtky5MxTWNMnRw9cE0IhAbwmT included - explore all tools instantly!
Start a conversation
Open a new chat. The Leal integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Leal, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Leal. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Manual Grind of Loyalty Reporting
Right now, running a simple report on customer health means opening three different tabs: one for member lists, one for campaign results, and another for transactions. You copy the segment count from the first tab, paste it into the spreadsheet, then you have to go back and manually calculate how many of those people are in the 'Gold' tier based on a separate report. It takes minutes, but doing it daily is impossible.
With this MCP, that entire process disappears. You tell your agent exactly what you need—for example, 'How many Gold members did we engage last month?' Your agent handles checking list_members for the tier count, pulling recent transactions via get_member_transactions, and compiling a clean summary report without you ever touching a spreadsheet or logging into multiple portals.
Leal MCP: Insights from Member Data
Before this, finding out which rewards were most popular meant reviewing campaign logs and cross-referencing them with the points spent. You had to check list_rewards against list_transactions records just to get a rough idea of demand.
Now, you simply ask your agent for insight: 'What reward category is currently underutilized but has high potential based on member profiles?' The system combines its knowledge across list_segments and list_rewards instantly. You move from guessing what customers want to knowing exactly what they're ready to buy.
What Leal MCP does for your AI
Managing customer loyalty used to mean juggling spreadsheets and logging into multiple dashboards just to see if someone had enough points for a discount. Now you can connect your AI agent to Leal and handle the full lifecycle of customer retention through natural conversation. You gain instant visibility into who your best customers are, what rewards they've earned, and which store locations are driving traffic.
Your agent pulls together member profiles and transaction histories so you don't have to manually cross-reference data points anymore. Need to know how many people in the 'Gold' tier bought something last week? You can ask for it. Want to see all available marketing campaigns or check if a specific segment is underperforming? Just ask.
This MCP makes sure your AI agent has access to every piece of loyalty intelligence, letting you use Vinkius as the central hub to run complex operations without ever leaving your workflow.
019dd116-8656-71cf-96ea-d647bf827409 
How to set up Leal MCP
The bottom line is you stop writing complex API calls and start having conversations that execute business logic.
Your AI client connects to this MCP and authenticates with your Leal account credentials.
You prompt your agent with a specific request, like 'Show me all Gold members who haven't transacted in 60 days.'
The MCP executes the necessary tools (like list_members and get_member) and returns structured data to your agent for an immediate answer.
Who uses Leal MCP
This MCP is essential for Marketing Managers, Retail Operations Directors, and CRM Specialists who spend too much time cross-referencing loyalty data across multiple systems. If your team struggles to quickly answer questions like 'How many Bronze members are eligible for the spring sale?' without running five different reports, you need this.
Uses the MCP to identify underperforming customer segments and draft targeted campaigns based on point balance data.
Checks store details and member profiles to ensure all physical locations are correctly enrolled and functioning within the loyalty system.
Retrieves historical transaction data and list_transactions records to spot spending patterns that inform next quarter's marketing budget.
Benefits of connecting Leal MCP
Stop guessing about your customers. Use get_member or list_members to instantly pull up full profiles, helping you understand a user's tier status and recent activity immediately.
Never run out of ideas for discounts. With list_rewards, your agent knows exactly what incentives are available, making personalized offers faster than ever before.
Targeting is easier than ever. By using list_segments or get_segment, you can define who needs to see a promotion without manually filtering huge lists of data.
Track the point movement easily. You can use get_member_transactions and list_transactions to audit every single points change across your entire store network.
Run campaigns based on reality. List_campaigns lets you check metrics and performance for active promotions, so you know exactly what's working right now.
Leal MCP use cases
Identifying at-risk high-value customers
A Marketing Manager needs to figure out which 'Gold' tier members haven't logged a transaction in 90 days. They ask their agent, and it combines list_members data with get_member_transactions results to provide an immediate list of people who need a win-back campaign.
Auditing point discrepancies
The Retail Operations Director finds suspicious activity. They use the agent to pull all transactions for a specific member via get_member_transactions and then cross-reference it with the master list from list_transactions to find where points might have been incorrectly applied.
Launching a targeted seasonal offer
A Marketing Manager wants to promote only customers who live in a specific region. They ask for all members within that segment using get_segment, then use list_rewards to ensure the discount matches their point level.
Checking store network compliance
A manager needs to confirm if a new franchise location is properly set up. They run list_stores and verify that the physical address appears alongside active member data, ensuring it's ready for campaigns.
Leal MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Using raw API calls in code
Writing a Python script that uses multiple authentication headers and needs to call 10 different endpoints (list_members, get_member, list_transactions) just to build one simple report.
Connect this MCP. Just ask your agent, 'Give me the point history for John Smith.' The agent handles all those separate calls using multiple tools automatically and gives you a clean answer.
Spreadsheet data entry
Manually downloading CSV files from different portals (members list, transactions, segment report) and then spending hours merging them into one master sheet.
Use your AI client. Ask it to 'Summarize the point balance for all members in the Bronze tier.' The agent pulls the data you need using get_member_balance and list_segments instantly.
Ignoring segment boundaries
Creating a broad promotion that hits every single member, wasting marketing spend on people who are already highly engaged or don't fit the current offer type.
Use get_segment and list_segments. First, identify the precise group you need to target. Then, use those segment details when planning campaigns via list_campaigns.
When to use Leal MCP
You must use this MCP if your core business process relies on connecting disparate pieces of customer loyalty data (e.g., 'Show me members who bought X and are in Segment Y and have points over Z'). It's built for complex queries that require chaining multiple tool calls—like pulling a member’s profile and then using their transaction history to calculate eligibility for a reward. Don't use this if you only need one piece of data, like simply listing all store addresses; in that case, an API wrapper or simple database connector might be sufficient. But if your job is actually analyzing the relationship between segments, transactions, and rewards, this MCP is the right choice because it provides the context to link those tools together.
Frequently Asked Questions
How do I check a customer’s point balance using the Leal MCP? +
Use get_member_balance. You just need to provide the member ID, and the agent will return their current points total instantly.
Can I list all loyalty members with the Leal MCP? +
Yes, run list_members. This tool gives you a full count of every registered participant in your program.
What is the difference between list_transactions and get_member_transactions? +
list_transactions shows every single transaction across all members. get_member_transactions limits that view, giving you only the history for one specific person.
Can I see what rewards are available with Leal MCP? +
Use list_rewards. This will show you a catalog of every reward option and its point cost so you know what customers can aim for.
Does the Leal MCP help me find out if I need to update my store details? +
You can use list_stores and get_store. These tools let you verify that all your physical locations are properly listed and connected to the system.
Can I check a member's points balance? +
Yes. get_member_balance returns the current points balance and tier for any loyalty member.
Can I view transaction history? +
Yes. get_member_transactions shows individual history and list_transactions shows all loyalty transactions.
How do I manage customer segments? +
list_segments shows all segments and get_segment returns configuration and member count for any segment.