# Zinrelo MCP MCP > Zinrelo manages your entire loyalty program lifecycle through a single AI connection. Use this MCP to instantly enroll members, track point balances, award points for purchases or activities, and process reward redemptions—all from natural language prompts. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** loyalty-programs, rewards-points, customer-engagement, retention-marketing, tier-management, redemption ## Description This connector lets you automate the whole customer loyalty loop directly within your agent. Instead of manually checking multiple systems for member status or transaction history, your AI client handles it all. You can instantly enroll new customers and pull their full profile, including tier level and current point balance. Need to adjust a reward? Simply process redemptions using natural language commands. When points are earned from purchases or special activities, you award them immediately. If the system needs manual adjustment, you can deduct points too. Since managing customer rewards is fundamentally financial data, every action taken by your agent generates a cryptographically signed audit trail through Vinkius, ensuring nothing happens in the dark and maintaining a perfect record of every point movement. It’s designed to handle everything from listing all active members to checking an individual's entire transaction history. This means marketing can launch campaigns that automatically award points for specific actions, and customer support staff can instantly check any member’s status without leaving their chat window. It streamlines the core flow of retention and rewards management. ## Tools ### award_points_activity Gives points to a user based on a custom action that isn't a direct purchase. ### award_points_purchase Adds points to a user’s account after they complete a transaction or make a sale. ### enroll_member Creates a new loyalty profile or updates the details of an existing customer. ### deduct_points Manually subtracts points from a member's balance, often for adjustments or disputes. ### get_member_details Pulls all current information about a specific member, like their tier status or point count. ### redeem_reward Processes the exchange of accumulated points for a defined reward or coupon. ### get_loyalty_settings Retrieves high-level configuration and settings for the entire loyalty program account. ### list_member_transactions Provides a full, chronological log of points earned and spent by one member. ### list_loyalty_members Fetches an exhaustive list of every person enrolled in the loyalty program. ## Prompt Examples **Prompt:** ``` Show me the loyalty profile for 'customer@example.com'. ``` **Response:** ``` I've retrieved the profile for customer@example.com. They are currently in the 'Gold' tier with 1,250 available points. Would you like to see their recent transactions? ``` **Prompt:** ``` Award 500 points to 'jane.doe@example.com' for a $50.00 purchase. ``` **Response:** ``` Successfully awarded points for the purchase. Jane Doe now has a total of 1,750 points in her Zinrelo loyalty account. ``` **Prompt:** ``` List all transactions for 'john.smith@example.com'. ``` **Response:** ``` I found 8 transactions for John Smith. Recent activity includes +100 pts for 'Newsletter Signup' and -500 pts for 'Redeem $5 Coupon'. ``` ## Capabilities ### Check Member Profile Retrieve a detailed loyalty profile for a specific user, including their tier status and current point balance. ### List All Members Generate a list of all active members in the entire loyalty program. ### Process Point Awards Award points to a user, differentiating between points earned from purchases or custom activities. ### Manage Redemptions Execute point redemptions for specified rewards. ### Track History Pull a complete, itemized transaction history for any individual member. ## Use Cases ### Customer service needs an account audit A customer calls questioning a point deduction. Instead of looking up invoices, the agent asks their AI client to list_member_transactions for that user. The agent immediately sees exactly when and why the points were taken. ### New users need immediate onboarding A new signup completes an action. The workflow triggers 'award_points_activity' automatically, giving them a welcome bonus, while simultaneously calling enroll_member to get their profile started. ### Running end-of-quarter reporting The marketing team needs to know how many members are in the 'Gold' tier and what their current point totals are. They use list_loyalty_members combined with get_member_details for a high-level overview. ### Processing bulk rewards The business decides to offer a $5 coupon redemption event. The agent uses redeem_reward across a segment of members, ensuring the points are correctly removed from their balances and logged. ## Benefits - Stop manually tracking balances. Use get_member_details to pull a user’s current status, tier, and point count in seconds. - Automate rewards immediately after sales. The award_points_purchase tool ensures points are credited instantly upon checkout completion. - Audit every movement with list_member_transactions. You can generate full historical logs for any member to prove where their points came from or went. - Handle disputes easily. Use deduct_points when a manual adjustment is necessary, and always keep that action logged. - Scale campaigns effortlessly. By listing all loyalty members, you get the roster needed to target promotions instantly. ## How It Works The bottom line is you tell your agent what you need done with plain English, and it handles the API calls and data retrieval for you. 1. First, connect your AI client to the Zinrelo MCP and provide your required API credentials. 2. Next, issue a natural language request—for example, 'Check John Smith's point balance.' 3. Your agent executes the necessary functions against the live data and returns structured results detailing the member’s status or transaction log. ## Frequently Asked Questions **How do I check my loyalty points using the get_member_details tool?** Just ask your agent to 'Get details for member X.' The client runs get_member_details and returns the full profile, including their current point balance and tier status. **Can I list all my customers using the list_loyalty_members tool?** Yes. The list_loyalty_members function pulls a comprehensive roster of every person currently enrolled in your program, which is useful for bulk marketing campaigns. **What is the difference between award_points_activity and award_points_purchase?** Use award_points_purchase when points are earned directly from a sale. Use award_points_activity when points are awarded for something else, like completing a survey or referring a friend. **Does the system log point changes using list_member_transactions?** Yes. This tool provides the complete and immutable record of every single point movement—both gains and losses—for full auditing purposes. **What information can I get using the `get_loyalty_settings` tool?** The tool retrieves high-level configuration details for your entire program. This includes essential parameters like point multiplier rates, maximum available tiers, and overall account status without needing to query specific member data. **If I run `deduct_points`, how does the system handle insufficient points?** The function performs a mandatory balance check before proceeding. If the deduction amount exceeds the user's current point total, it fails immediately and returns an explicit error code, ensuring no unauthorized changes occur. **When should I use `enroll_member`, and what information must I provide?** Use this when you need to create or update a loyalty record for a customer. You must supply mandatory fields like the unique member identifier (email) and initial status details for a successful enrollment. **Can I filter results when using `list_loyalty_members`?** Yes, you can pass criteria to narrow down the list of members. You should be able to filter by parameters like account tier, date range, or minimum point balance directly in your request payload. **How do I award points for a specific activity?** Use the `award_points_activity` tool with the member's email and the specific `activity_id` defined in your Zinrelo dashboard. **Can I see a history of point redemptions for a user?** Yes, the `list_member_transactions` tool retrieves a complete history of all point earnings and redemptions for a target member. **Is it possible to manually deduct points?** Absolutely. Use the `deduct_points` tool to remove a specific amount of points from a user's loyalty balance.