# Leal MCP MCP > The Leal MCP manages customer loyalty operations for Latin American retail businesses. Your agent can check specific member profiles, track points balances, and review full transaction histories. It also allows you to analyze pre-defined customer segments, list active campaigns, or find enrolled store locations. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** loyalty-program, cashback, customer-segmentation, omnichannel-marketing, retail-tech, customer-retention ## Description This connector lets your AI client manage the entire lifecycle of a loyalty program without jumping between twelve different dashboards. You can ask it to pull specific data points—for instance, retrieving a member's current point balance and cross-referencing that with their last five transactions. It gives you visibility into which campaigns are running and how many stores are in each geographic segment. The whole system acts as one source of truth for customer retention metrics. By connecting Leal through the Vinkius catalog, your agent treats all this data—member profiles, points tracking, rewards, and store networks—as interconnected information available via natural conversation. ## Tools ### check_leal_status Verifies if the AI client can successfully connect to and communicate with the Leal system. ### get_member_balance Gets the total current points balance for a specified member ID. ### get_member Retrieves a specific individual's full profile within the loyalty program. ### get_member_transactions Lists all recorded financial transactions for a given member, often allowing date filtering. ### get_segment Retrieves detailed information about a predefined customer segment. ### get_store Gets specific data points for an enrolled retail store location. ### list_campaigns Lists all active and past marketing campaigns, including performance metrics. ### list_members Retrieves a list of loyalty members, often with filtering options by tier or status. ### list_rewards Shows all available reward options that members can redeem points for. ### list_segments Lists and summarizes various customer segments defined in the system. ### list_stores Retrieves a directory listing of all physical store locations connected to the network. ### list_transactions Provides a comprehensive list of every transaction recorded across the entire system, not just for one member. ## Prompt Examples **Prompt:** ``` List all loyalty members. ``` **Response:** ``` You have 3,450 loyalty members. Gold: 234, Silver: 890, Bronze: 2,326. Most recent: Maria S. (joined today). ``` **Prompt:** ``` Check points balance for member mbr_1029. ``` **Response:** ``` Member Maria S.: 4,250 points (Gold tier). Last earning: +500 points from purchase at Store Downtown (yesterday). ``` **Prompt:** ``` Show all available rewards. ``` **Response:** ``` 5 rewards available: '10% Discount' (1000 pts), 'Free Shipping' (500 pts), ' Cashback' (2000 pts), 'VIP Access' (5000 pts), 'Birthday Gift' (auto). ``` ## Capabilities ### Review Customer Profiles Retrieve detailed records for specific members or list entire groups of loyalty participants. ### Analyze Spending and Points Check a member's current point balance and pull the full history of all recorded transactions. ### Target Specific Audiences Identify, browse, or inspect predefined customer segments based on behavior or demographics. ### Audit Marketing Efforts List available reward options and view metrics for active marketing campaigns. ### Map Operational Locations Get details about physical store locations or list the entire network of enrolled stores. ## Use Cases ### Auditing Campaign Coverage The ops manager needs to know if the new 'Spring Sale' campaign reached all stores. They ask the agent to run `list_stores` and cross-reference that list with active marketing campaigns using `list_campaigns`. The agent quickly returns a compliance report. ### Reactivating Dormant Members A retention specialist finds members who haven't transacted recently. They use `get_segment` to pull the 'At Risk' segment, then check their balances using `get_member_balance` to see if they still have points worth redeeming. ### Calculating Segment Health A marketing director needs to know the total value of all premium members. They call `list_members`, filter by 'Gold' tier, and then use `get_member_balance` for each member ID to calculate a group LTV. ### Investigating Transaction Gaps The finance team notices discrepancies in reported sales. They ask the agent to run `list_transactions` across a date range and compare that raw data against the members listed via `list_members` for reconciliation. ## Benefits - Instead of running manual reports, use `get_member_balance` to instantly check a customer's point total. You don't need to query the database; you just ask your agent. - Audit marketing performance by calling `list_campaigns`. The MCP gathers metrics on participation and redemption rates from multiple sources into one response. - Stop guessing who is valuable. Use `list_segments` and `get_segment` to automatically identify groups like 'High Spenders' or 'Lapsed Members', allowing for precise targeting. - Track customer journey depth by pairing `get_member` with `get_member_transactions`. This shows not just *if* they bought something, but *how many times* and *when*. - Manage physical operations data by using `list_stores` to verify the entire network of locations. If you need specifics on a single outlet, use `get_store`. ## How It Works The bottom line is that your agent handles all the filtering and linking between member data, transactions, and segment definitions in one go. 1. First, ensure connectivity by running a status check to verify your AI client can communicate with the Leal platform. 2. Next, define the scope: you might list all members or focus on a specific segment using available tools. This narrows the data set. 3. Finally, request the detailed output needed—for example, pulling transaction records for a small group of target members. ## Frequently Asked Questions **How do I check if a customer is eligible for rewards with the Leal MCP?** You can list all available options by calling `list_rewards` to see what's configured. Then, you can use `get_member_balance` and compare that against the reward costs. **Does the Leal MCP track transactions for everyone or just one person?** It handles both. You can run `list_transactions` to see data across the whole network, or use `get_member_transactions` if you only need history for a single member. **What is the best way to find high-value customers using Leal MCP?** First, run `list_segments` to see existing groups. Then, use `get_segment` to inspect specific segments and pull data for those members. **Can I get a list of all stores connected to the network using Leal MCP?** Yes, call `list_stores`. This tool provides the full directory listing of every store location enrolled in the loyalty system. **How do I use `list_campaigns` to check for active marketing promotions?** The tool returns a list of all configured campaigns, including their metrics and status. You can see if the campaign is running, when it started, or what its goal was. **If I run `get_member` with an incorrect ID, what should I expect from the Leal MCP?** The system will return a specific 'Member Not Found' error code. This structured response lets your agent handle invalid member identifiers without failing the overall workflow. **When using `list_members` or `list_transactions`, how do I retrieve data for thousands of records?** These tools support pagination parameters, letting you specify page size and an offset. This mechanism prevents API timeouts when your agent needs to process extremely large datasets. **What detailed information is available when calling `get_member`?** You get the member's complete profile data, including their current tier level and join date. This provides enough context for your AI client to draft highly personalized communications. **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.