Leal MCP. Manage customer loyalty and points from any chat window.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Leal MCP Server handles customer loyalty operations for retail businesses across Latin America. Your AI agent connects directly to Leal, giving you access to member profiles, point balances, transaction history, and segment details.
Use it to automate retention campaigns, view store network data, and manage personalized rewards without logging into a dashboard.
What your AI agents can do
Check leal status
Verifies the live API connection between your AI client and the Leal system.
Get member
Retrieves a single customer’s complete loyalty profile using their ID.
Get member balance
Checks the current point total for any specified member.
Fetch a specific member's full loyalty profile, including their tier status and personal details.
Get a member’s current points total and list every transaction that affected that balance.
List existing customer segments or retrieve details on how specific groups are defined within the system.
View operational details for all enrolled physical store locations in the network.
Fetch a list of active marketing campaigns, along with their performance metrics.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Leal MCP Server: 12 Tools for Customer Loyalty
Manage member profiles, transaction history, segment data, rewards, and store details with your AI agent.
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 on Vinkius019dd116check leal status
Verifies the live API connection between your AI client and the Leal system.
019dd116get member
Retrieves a single customer’s complete loyalty profile using their ID.
019dd116get member balance
Checks the current point total for any specified member.
019dd116get member transactions
Lists every historical transaction associated with a specific member’s account.
019dd116get segment
Pulls the detailed definition and membership count for a specified customer segment.
019dd116get store
Retrieves specific operational details about an enrolled retail store location.
019dd116list campaigns
Lists all running marketing campaigns and their key performance metrics.
019dd116list members
Retrieves a paginated list of all active loyalty members in the system.
019dd116list rewards
Lists every reward option available to customers, including point costs and rules.
019dd116list segments
Retrieves a master list of all pre-defined customer segments (e.g., 'High Spenders', 'New Joiners').
019dd116list stores
Provides an overview and list of every store location registered in the network.
019dd116list transactions
Generates a comprehensive, unfiltered list of all loyalty transactions across the entire platform.
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 every 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 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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 INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Reporting on customer loyalty used to mean jumping between five different dashboards.
You open the dashboard. You pull up member lists in one tab, transaction data in a second, and segment definitions in a third. To see if your 'VIP' group is spending enough requires exporting three separate CSVs, merging them manually in Excel, and then hoping your pivot table doesn't break.
With this MCP server, you ask your agent: 'Show me the average transaction value for Gold tier members who visited Store Downtown last month.' The agent runs `get_segment` for 'Gold', pulls data from `list_stores`, and executes a filtered search on transactions. You get the answer instantly. No spreadsheets involved.
Leal MCP Server: Get real-time insights into member status.
Manually verifying if a customer's points balance is correct takes calling three different systems: the POS system, the online portal, and the loyalty database. You spend time cross-referencing IDs just to confirm a simple point total.
Now, you send one prompt. The agent calls `get_member` for their ID, then immediately executes `get_member_balance`. It returns the number directly in your chat window. That's how it should work.
What you can do with this MCP connector
Your AI client connects straight to Leal, so you never have to log into some clunky dashboard just to run customer loyalty operations. This server gives your agent direct access to the core systems that keep shoppers coming back, letting you manage rewards and understand member behavior on the fly.
First off, you can verify everything is working right with check_leal_status, which confirms a live API connection between your agent and the Leal system. From there, you've got deep access to every customer profile in the network. You start by pulling a member’s entire history using get_member based on their ID; this retrieves everything about them.
If you need an overview of who's signed up, use list_members to get a paginated list of all active loyalty members.
When it comes to points and money, your agent handles the accounting for ya. You can check any member’s current point total instantly with get_member_balance. To see how those points got there—whether they were earned or redeemed—you use get_member_transactions, which lists every single transaction tied to that specific account. If you need a full, unfiltered look at what's happening across the whole platform, list_transactions generates a comprehensive list of all loyalty transactions globally.
Understanding your customer groups is huge for targeted campaigns. You can pull a master roster of existing categories using list_segments, seeing names like 'High Spenders' or 'New Joiners.' To get the nuts and bolts on one specific group, run get_segment to pull the detailed definition and membership count for that segment.
For physical store planning, you don’t gotta guess. Run list_stores to get a complete overview of every location registered in the network, and then use get_store to retrieve specific operational details about any single enrolled retail spot.
When it comes to getting customers excited, your agent handles both rewards and marketing visibility. You can list every reward option available for shoppers using list_rewards, which shows the point costs and rules attached to those perks. To track what's working in terms of sales boosts, use list_campaigns to fetch a full list of active marketing campaigns alongside their key performance metrics.
You can also map out how customers are defined by reviewing the detailed segmentation data using get_segment, or you can get a complete understanding of all possible groupings available through list_segments. This whole setup means your agent doesn't just pull reports; it gives you the mechanism to act on that data immediately for retail businesses across Latin America.
019dd116-8656-71cf-96ea-d647bf827409 
How Leal MCP Works
- 1 Your AI client calls the Leal MCP Server using a specific tool (e.g.,
list_members). - 2 The server executes the request against the Leal API, pulling raw data on members, transactions, or segments.
- 3 Your agent receives structured JSON data. It then interprets that data—for instance, calculating the percentage of 'Gold' tier members who haven't transacted in 90 days—and presents the actionable summary to you.
The bottom line is: your AI client uses these tools to bypass dashboards and talk directly to Leal’s operational database.
Who Is Leal MCP For?
This is for Digital Marketing Managers, CRM Ops Engineers, and Retail Analysts who are tired of exporting CSV reports just to find a single metric. If your job involves running retention campaigns or tracking complex cashback rules across multiple physical locations, this saves hours of manual data wrangling.
Uses list_members and get_member_balance to audit the health of the entire customer base before launching a new promotion. They check for inactive high-value segments.
Runs list_segments and checks list_campaigns metrics to determine which specific audience group responded best to the last cashback reward, informing the next campaign strategy.
Uses tools like get_member_transactions to build internal validation scripts, ensuring that point accrual logic correctly handles different retail channels and store locations.
What Changes When You Connect
- Stop manually exporting CSVs for member data. Use
list_membersto pull the entire roster instantly, letting your agent count out 'Gold' versus 'Bronze' tier counts in seconds. - Deep dive into spending habits using
get_member_transactions. You can ask your agent not just for points, but for a summary of point movements over the last 90 days. - Target specific groups with precision. Use
list_segmentsand thenget_segmentto pull data only on customers who match 'High Value' criteria, avoiding irrelevant noise. - Keep track of physical retail health using
list_stores. You can check if a specific store location has been updated or activated without calling the internal admin portal. - Fast campaign review. Instead of pulling up multiple dashboards, run
list_campaignsto get metrics and performance summaries on every active marketing effort at once.
Real-World Use Cases
Identifying Churn Risks
A CRM manager notices that the 'Bronze' tier segment hasn't seen activity in 60 days. They prompt their agent: 'Find all members from list_segments who are Bronze and haven't used get_member_transactions in two months.' The agent runs the necessary checks, identifies 150 names, and drafts a personalized re-engagement email campaign.
Auditing Points Logic
A developer needs to verify if points were correctly credited after a large purchase. They ask their agent to use get_member for the customer ID, followed by get_member_transactions. The agent returns a chronological list showing the initial point calculation and the final credit amount, confirming system integrity.
Planning Multi-Location Promotions
The marketing team wants to run a promotion across three specific stores. They start by running list_stores to confirm location IDs. Then they use these IDs with the agent to verify which store has enough inventory capacity before drafting the final campaign plan using list_campaigns.
Launching New Rewards
The team wants to know what rewards are available and how many points cost them. They first run list_rewards to see all options, then they use that data alongside list_segments to predict which segment would be most motivated by a 'Free Shipping' reward.
The Tradeoffs
Asking for everything at once
Prompting: 'Give me all customer data, transactions, segments, and store locations.' This is too broad; the agent won't know where to start or what combination of tools you need.
→
Start with a resource. If you want segment info, run list_segments first. Then, if needed, use get_segment on a specific ID. Always break down complex questions into sequential tool calls.
Ignoring the member status
Trying to plan a campaign for an inactive user without checking their current point balance or tier. This leads to wasted marketing spend.
→
Always run get_member first on your target ID. Then, immediately check get_member_balance. Use that data to make sure the offer is relevant before calling tools like list_campaigns.
Assuming connectivity
Writing complex code flows without checking if the API connection is actually live. The whole operation fails silently.
→
Always start your workflow by running check_leal_status. If that returns an error, stop and fix the connection before proceeding with any other tool calls.
When It Fits, When It Doesn't
Use this server if your business relies on deep customer relationship data—specifically, when retention, cashback tracking, or segmentation drives revenue. You must be able to link a physical store location (list_stores) or an active campaign (list_campaigns) directly to a specific member's point history (get_member_transactions).
Don't use this if your primary need is simple public-facing data (like basic product catalog browsing). If you only need general sales metrics from a single source, a standard BI tool works. But the moment you need to understand why a customer spent money—connecting their tier status (get_member) to which segment they belong (list_segments) and what rewards are available (list_rewards)—this is necessary.
Common Questions About Leal MCP
How do I check if my API connection is working with check_leal_status? +
Run check_leal_status first. It confirms the live link between your agent and Leal. If it returns success, you're clear to run any other tool.
What is the difference between list_members and get_member? +
list_members gives you a paginated roster of all members. get_member takes one specific ID and pulls that single person's entire, deep profile.
Can I check points balance for every member? Using get_member_balance? +
No, you can't query all members at once. You must first use list_members to get a list of IDs, and then run get_member_balance on each ID individually.
Where do I find data for store locations? Do I use list_stores or get_store? +
list_stores gives you an overview and a full list of all registered stores. get_store lets you drill down into the specific operational details for one single store location.
How do I see what rewards customers can use? Using list_rewards? +
list_rewards provides a complete catalog of every available reward option, detailing their required points and redemption rules.
What's the difference between using `list_transactions` and calling `get_member_transactions`? +
list_transactions gives you a high-level summary of all activity across every member. Use get_member_transactions when you need the complete, detailed history for one specific user.
What kind of data points can I get about customer groupings using `get_segment`? +
get_segment provides deep details on how a segment was defined and what criteria members must meet. You learn the rules for group membership, not just the list of people.
When I run `list_campaigns`, how does the server handle very large numbers of campaigns? +
The API supports pagination for massive lists. If the results exceed the default page size, you'll receive a next_page_token in the response header to fetch all remaining data chunks.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.