# Gameball MCP MCP > Gameball connects your loyalty and gamification account to any AI agent, letting you manage player points, track events, and run rewards programs instantly through conversation. Use it to simplify how you reward customer actions, monitor progress in challenges, and keep customers engaged so they keep coming back. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** loyalty-program, gamification, customer-retention, referral-marketing, rewards-points, engagement-challenges ## Description Need a way to turn repeat shoppers into raving fans? This MCP connects directly to your loyalty platform's core data. You can track exactly what players are doing—from logging in daily to completing massive purchases—and automatically assign points or levels based on those actions. It lets you list all active challenges and check point balances for any person instantly, just by asking your AI agent a question. Whether you're checking if a user qualifies for a discount coupon or tracking progress toward a high-level badge, it pulls the real-time data right into your chat window. You manage your entire gamified ecosystem without ever leaving your workspace; this is where Vinkius brings all that complex business logic to your AI client. It's about making customer retention feel as simple as asking a question. ## Tools ### get_player_balance Checks the point balance for any given player ID. ### get_player_details Retrieves detailed metadata and current status for a specific player account. ### list_challenges Fetches the list of all active engagement challenges in the loyalty program. ### list_discount_coupons Shows a rundown of discount coupons and promo codes that are currently live. ### list_loyalty_levels Retrieves the defined loyalty tiers available in your customer program. ### list_players Lists all registered players within the Gameball system for overview purposes. ### list_rewards Provides a list of all available rewards that customers can earn or redeem. ### track_player_event Records a specific player action, automatically updating their points and progress. ## Prompt Examples **Prompt:** ``` What is the point balance for player 'user_10293'? ``` **Response:** ``` I've retrieved the balance. Player user_10293 currently has 1,250 points (Value: $12.50). They are in the 'Silver Tier' and are 250 points away from reaching the Gold level. Shall I check their active challenges? ``` **Prompt:** ``` Award points for a 'Feedback Given' event to player 'user_88231'. ``` **Response:** ``` Event tracked! I've recorded the 'Feedback Given' action for user_88231 in Gameball. This has triggered a reward of 50 points and updated their progress for the 'Community Contributor' challenge. ``` **Prompt:** ``` List all active challenges in our loyalty program. ``` **Response:** ``` Fetching challenges... You have 5 active challenges: 'First Purchase', 'Refer a Friend', 'Weekly Login Streak', 'Write a Review', and 'Mobile App Install'. Would you like the point details for any of these? ``` ## Capabilities ### Check player points balance Retrieve the current point total and associated currency value for any specific user. ### Get detailed player status Fetch comprehensive information about a single player, including their loyalty level and history. ### List ongoing challenges View all current active badges, challenges, and rewards available in the system. ### Check coupon availability List all promo codes or discount coupons that are currently active for use. ### View configured loyalty levels See a list of defined membership tiers and the criteria required to reach them. ### Find registered players List all users who have accounts within your gamification system. ### Review available rewards Get a catalog of all the tangible and intangible rewards that can be issued to customers. ### Record customer actions Trigger an event record, such as giving feedback or making a purchase, which updates player progress and points. ## Use Cases ### A user asks about their status Instead of forcing a customer to call support or log into a separate portal, your agent runs `get_player_details` and replies with a full breakdown: 'You're currently Silver Tier (1250 points), and you only need 250 more for Gold.' The user stays happy and knows exactly what they are working toward. ### Launching an in-store promotion The store manager asks the agent to run `list_discount_coupons` and cross-reference it with available points from `get_player_balance`. The AI confirms, 'Yes, they have 500 points, which qualifies them for the $10 coupon.' No manual lookup required. ### Tracking a marketing campaign A product team member wants to know if their recent blog post activity should reward points. They run `track_player_event` and immediately see that 50 points were awarded, which updated the user's status for the 'Content Contributor' challenge. ### Audit player eligibility You need to verify if a specific batch of users qualifies for a new reward. You use `list_players` to pull IDs, and then loop through them using `get_player_balance` to confirm they all meet the point threshold. ## Benefits - Stop guessing customer status. Use the `get_player_balance` tool to instantly confirm how many points a user has, right in your chat. - Keep users engaged by making their actions count. The `track_player_event` tool lets you log any activity—like giving feedback—and immediately trigger point rewards. - Know exactly what’s available. Run `list_challenges` or `list_rewards` to show your team the full scope of current programs without digging through a dashboard. - Streamline customer support. Use `get_player_details` so agents can tell customers their precise loyalty tier and how close they are to leveling up. - Prevent missed sales opportunities. Check for active discounts using `list_discount_coupons` before confirming an order, ensuring the best deal is always offered. ## How It Works The bottom line is that you get real-time loyalty data without ever writing an API call or navigating multiple dashboards. 1. Subscribe to this MCP and enter your Gameball API Key in the Vinkius Marketplace. 2. Your AI agent connects to the platform using the key. It then knows which specific actions you need, like checking player details or listing challenges. 3. You ask your agent a natural language question (e.g., 'What points does user 456 have?') and it executes the required tool call instantly. ## Frequently Asked Questions **How does the Gameball MCP handle point updates?** You use the `track_player_event` tool. This function records a specific action (like 'purchase completed') and tells your system to automatically calculate and assign points, keeping everything up to date. **Can I find out which players exist using the Gameball MCP?** Yes, you run `list_players`. This gives you a comprehensive list of all customer IDs within your loyalty system so you know who needs rewards or attention. **What is the difference between checking player details and getting the balance using Gameball MCP?** The `get_player_details` tool gives a full profile (level, history). The `get_player_balance` tool is simpler; it only returns the current point total for quick verification. **How do I find out what coupons are valid right now?** You use `list_discount_coupons`. This function queries your system and provides a clean, current list of all working promo codes that customers can redeem today. **How do I use `list_challenges` to view all active campaigns?** It shows every challenge currently running in your loyalty program. You get a clean list of the active promotions, letting you verify which engagement opportunities are available right now. **How do I check my configured loyalty tiers using `list_loyalty_levels`?** This tool provides a complete catalog of all defined loyalty levels in your system. You can use this data to verify the full structure and progression path for every customer. **What is the proper way to track player actions using `track_player_event`?** You pass a specific action type, like 'Purchase Made' or 'Review Written', along with a player ID. This records the event in Gameball and automatically triggers any linked rewards or point updates. **How can I view the full catalog of available prizes with `list_rewards`?** The tool retrieves every reward item configured in your account. You get details on what those rewards are, their associated point costs, and if they require specific criteria to redeem. **Can I check a player's points balance via AI?** Yes! Use the `get_player_balance` tool and provide the Player Unique ID. Your agent will retrieve the current points and currency for that specific user. **How do I award points for a specific action using the agent?** Use the `track_player_event` action. Provide the Player ID and the Event Name (e.g., 'purchase_completed'). Gameball will process the event and trigger rewards based on your rules. **Is it possible to list all available rewards via AI?** Absolutely. Use the `list_rewards` query. The agent will retrieve the full catalog of rewards, redemption options, and active point rules from your account.