# Leal MCP for AI Agents AI Agent Connect > Leal connects your AI agent to your loyalty program to manage members, rewards, and retail campaigns in Latin America. It lets you pull member tiers, check point balances, and browse customer segments directly through your AI client. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_IUQ9IgkFtPnLdOkLtky5MxTWNMnRw9cE0IhAbwmT/ai-agent-connect - **Tags:** loyalty-program, cashback, customer-segmentation, omnichannel-marketing, retail-tech, customer-retention ## Description Managing a retail loyalty program across different regions usually means jumping between tabs to check who's getting what reward. You have to hunt for member balances, look up specific transaction histories, and try to make sense of customer segments just to send out a single marketing push. It's tedious work that eats up your day and makes it harder to stay on top of your growth goals. This Connector changes that by putting all those details into a single chat interface. Instead of digging through a complex dashboard, you can just ask your agent to pull a list of members or see what rewards are currently active. You can see how your store network is performing or check out the metrics on your latest marketing push without leaving your workspace. It's a much faster way to handle the heavy lifting of customer retention and rewards management. If you're looking for a way to manage these operations without the manual overhead, finding this in the Vinkius catalog makes it easy to get your loyalty data moving. You can get a high-level view of your store network or drill down into specific member profiles to provide better service. It turns a multi-step data hunt into a simple conversation. ## Tools ### list_rewards See all the different rewards your members can currently earn or redeem. This helps keep your offers clear. ### list_transactions Pull a complete list of all transactions across the entire program. This is great for high-level auditing. ### check_leal_status Verify that your API connection is active and working correctly. Use this to troubleshoot your setup. ### get_member_balance See the current point balance for a specific loyalty member. This helps with quick customer support. ### get_member Pull the full profile for a single member, including their tier. Use this to get specific customer details. ### get_member_transactions See the specific transaction history for one individual member. This helps you see a single customer's journey. ### get_segment Get the specific details and membership data for a single customer segment. Use this to drill down into groups. ### get_store Get the specific details for a single store location. This is useful for checking local store info. ### list_campaigns View all your marketing campaigns along with their current metrics. This helps you track your marketing ROI. ### list_members Get a full list of all loyalty members in your program. Use this to see your total reach. ### list_segments Browse the various customer segments you've created for targeting. Use this to group your audience. ### list_stores See every store location currently enrolled in your network. This gives you a bird's-eye view of your footprint. ## Prompt Examples **Prompt:** ``` Who are my top customers right now? ``` **Response:** ``` Based on your current segments, here are the high-value groups: | Segment Name | Member Count | Key Activity | | :--- | :--- | :--- | | VIP Gold | 234 | High frequency purchases | | Frequent Shoppers | 890 | Weekly visits | | New Signups | 2,326 | First-time purchases I can show you the specific details for any of these groups if you'd like. ``` **Prompt:** ``` Show me the rewards available for the 500 point tier. ``` **Response:** ``` Here are the rewards currently available: - **10% Discount** (1000 pts) - **Free Shipping** (500 pts) - **Cashback** (2000 pts) - **VIP Access** (5000 pts) - **Birthday Gift** (Automatic) Note: The 'Free Shipping' reward is currently at the 500 point mark. ``` **Prompt:** ``` What's the status of our latest marketing campaign? ``` **Response:** ``` Your active campaigns are performing as follows: - **Summer Sale 2024**: 1,200 conversions, 4.5% conversion rate - **Loyalty Kickoff**: 850 conversions, 3.2% conversion rate Most of the activity is coming from the 'Summer Sale' campaign. ``` ## Capabilities ### Pull member profiles Get full details on loyalty members including their current tiers and status. ### Check point balances See how many points a specific member has and view their recent earning activity. ### Browse customer segments Inspect different groups of customers to target your marketing more effectively. ### View reward options See every reward currently available to your members in your program. ### List marketing campaigns Get a high-level view of active campaigns along with their performance metrics. ### See store locations View all the retail locations currently enrolled in your network. ## Use Cases ### Handling a VIP inquiry A customer calls about their points. You ask the agent to get_member_balance for their ID to see if they're eligible for a reward. ### Planning a seasonal sale You ask the agent to list_segments to find high-spending customers, then check list_rewards to see what you can offer them. ### Reviewing store performance You ask the agent to list_stores and then list_campaigns to see which locations are hitting their targets. ### Auditing recent activity You use list_transactions to spot any unusual patterns in member spending over the last week. ## Benefits - Faster member lookups: Use get_member to pull full profiles instantly instead of searching a database manually. - Real-time balance checks: Quickly see point totals with get_member_balance to answer customer questions on the fly. - Data-driven targeting: Use list_segments and get_segment to identify high-value customers for specific offers. - Campaign oversight: Track your marketing success by pulling performance metrics with list_campaigns. - Network visibility: Keep a pulse on your physical footprint using list_stores and get_store. - Transaction history: Audit member activity easily by pulling specific logs with get_member_transactions. ## How It Works The bottom line is you get a conversational interface for your entire loyalty program's backend. 1. Link your Leal account to the Vinkius platform. 2. Connect your preferred AI client to the Leal MCP. 3. Start asking your agent to pull member lists, check balances, or view campaign metrics. ## Frequently Asked Questions **How does the Leal MCP help with retail loyalty?** It gives your AI agent a direct line to your loyalty data. You can ask about member tiers, check point balances, and see reward options in plain English. **Can I use Leal MCP to see my customer segments?** Yes. Your agent can browse and inspect all your customer segments to help you understand who is buying what and how to target them better. **Does Leal MCP work for Latin American retail?** Yes, it's specifically designed to manage loyalty programs, cashback rewards, and personalized offers for retail businesses in Latin America. **Can my agent check if a customer has enough points?** Absolutely. You can ask the agent to pull a specific member's balance instantly to see if they qualify for a reward or a specific tier. **How do I see my store network performance with Leal?** The Connector allows your agent to list all your enrolled store locations and get specific details for each one, making it easy to monitor your physical footprint. **Can I see my marketing campaign metrics?** Yes, you can ask your agent to list all active marketing campaigns and see the metrics associated with each one to track your ROI. **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.