# Gameball MCP for AI Agents AI Agent Connect > Gameball MCP lets you manage your loyalty program and gamified rewards through natural conversation. Use it to check customer points, award rewards for specific actions, and track challenge progress without leaving your AI client. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WQDfKPxMxpL7kIwOOkEGxsRrTDxJtL6quAQp83LR/ai-agent-connect - **Tags:** loyalty-program, gamification, customer-retention, referral-marketing, rewards-points, engagement-challenges ## Description Gameball lets you turn one-time buyers into repeat fans by giving them reasons to come back. This Connector lets you talk to your loyalty program instead of digging through a dashboard. You can ask your agent to check how many points a customer has or see which rewards are still available. It handles the heavy lifting of tracking player events and updating their progress. If you're tired of jumping between tabs to manage your gamification strategy, this is the shortcut. You'll find it in the Vinkius catalog alongside other tools that help you manage your customer relationships. Instead of manually logging into a dashboard to find a specific user, you can just tell your agent what happened. If a customer sends in a great review, you can have your agent record that event and award points instantly. It pulls in your loyalty levels, active challenges, and available coupons so your agent always has the right context. This means you spend less time on data entry and more time actually talking to your customers. It's built for people who want to move at the speed of conversation while keeping their loyalty data accurate and up to date. You can check who is eligible for what without leaving your workspace. ## Tools ### get_player_balance Check the current point total for a specific player. This helps you see exactly how much currency a customer has. ### get_player_details Pull the full profile for a specific player. You can see their current tier and other important metadata. ### list_challenges See every active challenge in your loyalty program. Use this to see what your customers are currently trying to earn. ### list_discount_coupons Get a list of all active promo codes. This is great for checking what discounts you have available to share. ### list_players Get a list of all players in your Gameball account. Use this to see your entire customer base at a glance. ### list_rewards See what rewards your customers can actually claim. This helps you understand what's currently in your catalog. ### track_player_event Record a specific action a player took. This is how you trigger point updates or progress changes. ### list_loyalty_levels See the different tiers you've set up. Use this to understand how your loyalty program is structured. ## 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. 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 * Mobile App Install Would you like the point details for any of these? ``` ## Capabilities ### Check customer point balances Instantly see how many points a specific player has accumulated. ### Award points for actions Record player events to trigger automatic reward updates. ### View active rewards See every reward and coupon currently available in your program. ### Track challenge progress Monitor what goals your customers are currently working toward. ### Retrieve player metadata Get full details on any customer including their current loyalty tier. ## Use Cases ### Instant reward for a positive review A customer leaves a 5-star review. You ask your agent to use track_player_event to award 50 points immediately. ### Checking eligibility for a discount A user asks if they can get a coupon. You ask your agent to check list_discount_coupons and get_player_balance to see if they qualify. ### Analyzing referral campaign progress You want to see how your referral program is doing. You ask your agent to list_challenges and see how many people joined. ### Resolving a missing points issue A customer says they didn't get their points. You use get_player_details to verify their status and check their current tier. ## Benefits - Award points instantly using track_player_event so you don't have to manually enter data for every customer action. - Check customer status quickly with get_player_details to provide faster and more accurate support during live chats. - See what is available for your customers by using list_rewards and list_discount_coupons to keep your marketing current. - Understand your audience better by looking at list_loyalty_levels to see how your customers are moving through your program. - Keep track of active goals with list_challenges to see exactly what your fans are working toward every day. - Reduce tab switching by pulling all your loyalty data into one single chat interface for your agent. ## How It Works The bottom line is you can manage your entire loyalty ecosystem through a chat interface. 1. Subscribe to the Gameball MCP on the Vinkius Marketplace. 2. Input your Gameball API Key into your AI client settings. 3. Ask your agent to check points, list rewards, or track customer events. ## Frequently Asked Questions **Can I use the Gameball MCP to give rewards to my customers?** Yes, it lets your agent track specific actions and award points automatically. You can tell your agent to reward a customer for a review or a purchase without leaving your chat. **How does Gameball MCP help with my loyalty program?** It connects your rewards data to your AI agent. This allows you to ask questions about points, check loyalty tiers, and see available rewards in plain English. **Can I see what rewards are available with Gameball MCP?** Yes, your agent can pull the full list of active rewards and coupons for you. This is great for quickly checking what you can offer a customer in the moment. **Does Gameball MCP work with my existing loyalty levels?** It reads your current levels and tiers so the agent can explain them to customers. It ensures the information your agent gives is always accurate to your setup. **How do I track customer actions using Gameball MCP?** Your agent can log specific events like signups or purchases to trigger rewards. This automates the process of updating customer progress in your loyalty program. **Can I check a customer's point balance with Gameball MCP?** Yes, you can ask your agent to look up any player's balance instantly. It will return the total points and their current loyalty tier. **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.