# Gameball MCP for AI Agents AI Agent Connect > Gameball MCP lets you manage your entire loyalty and rewards program through your AI agent. You can update customer profiles, check point balances, track orders to award rewards, and handle point refunds in real-time. It connects your e-commerce loyalty data directly to your workflow. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_r4VS2TkYN1X2z0gfXWloKwFezP1p9P1ltwazq1La/ai-agent-connect - **Tags:** loyalty-program, gamification, customer-retention, rewards, engagement ## Description This Connector lets you manage your loyalty and rewards program through your AI agent. Instead of manually looking up a balance or worrying about double-spending during a checkout, you can just tell your agent what to do. It handles the logic of holding points temporarily, awarding them once an order is confirmed, and reversing them if a refund hits. You get a unified way to manage customer rewards without the usual back-and-forth. Because Vinkius hosts this Connector, you can connect once to get access to a catalog of over 4,000 tools, giving your team a way to handle customer loyalty through a simple chat or command interface. It turns a complex backend into a conversational tool for your team. ## Tools ### get_customer_activities Fetch a full log of everything a specific customer has done in your program. Use this to see how users are interacting with your rewards. ### get_customer_balance See a customer's current points, cash value, and upcoming expiration dates. It helps you answer balance inquiries instantly during support chats. ### get_order_transactions View every loyalty-related transaction associated with a specific order. Use it to audit exactly how points were earned or spent. ### hold_points Temporarily set aside points for a checkout to prevent double-spending. This ensures your rewards stay secure during the payment process. ### refund_transaction Reverse points earned from a purchase or restore points from a redemption. Use this to fix point balances when a customer returns an item. ### send_events Trigger specific customer events to feed into your gamification logic. This lets you reward users for specific actions like signing up or making a first purchase. ### track_order Award loyalty points for a completed purchase and finalize any held redemptions. This automates the reward process for every new sale. ### create_or_update_customer Create or modify a customer profile with custom attributes and contact info. This keeps your loyalty data consistent across all your platforms. ## Prompt Examples **Prompt:** ``` How many points does customer cust_98765 have? ``` **Response:** ``` Customer **cust_98765** has **1,250 points**. That's worth **$12.50** in rewards. I also see 200 of those points are set to expire at the end of next month. ``` **Prompt:** ``` Just finished order ORD-999 for $150. Award the points. ``` **Response:** ``` I've processed order **ORD-999** for customer **cust_123**. Based on the $150 total, I have awarded **150 loyalty points** and finalized the redemption. ``` **Prompt:** ``` Create a new profile for Alice Smith at alice@example.com. ``` **Response:** ``` Done. I've created the profile for **Alice Smith** (ID: **alice_001**). Her details are now synced with Gameball for your loyalty tracking. ``` ## Capabilities ### Update customer profiles Create or modify a customer profile with custom attributes and contact info. ### Check point balances See a customer's current points, cash value, and upcoming expiration dates. ### Reserve points for checkout Hold points for temporary redemption to stop double-spending at checkout. ### Award points for orders Submit order details to award loyalty points and finish held redemptions. ### Process reward refunds Process refunds or cancellations to reverse earned points or restore redeemed ones. ### Log customer actions Get a log of customer activities to see how users interact with your rewards. ### Sync customer events Trigger specific customer events to feed into your gamification logic. ## Use Cases ### Support inquiry about missing points A customer asks why their points are missing. The rep uses get_customer_balance and get_customer_activities to explain the history in seconds. ### Flash sale inventory protection During a high-traffic sale, the manager uses hold_points to ensure customers can't use the same points twice during the checkout flow. ### Automated welcome rewards A user signs up for a newsletter. The team uses send_events to trigger a welcome reward automatically based on the signup event. ### Order cancellation correction A customer cancels an order. The manager uses refund_transaction to restore the points immediately to the customer's account. ## Benefits - Stop manual data entry by using create_or_update_customer to sync profiles instantly. - Prevent double-spending during checkouts by using hold_points to reserve rewards. - Handle complex refunds faster by using refund_transaction to correct point balances. - Give your support team instant answers with get_customer_balance to see real-time values. - Automate retention efforts by using send_events to trigger rewards based on user actions. - Keep a clean audit trail of every interaction using get_customer_activities. ## How It Works The bottom line is you get direct access to your loyalty data without leaving your workspace. 1. Subscribe to the Gameball MCP on Vinkius. 2. Add your Gameball API Key and Secret Key to the configuration. 3. Use your AI client to manage loyalty data via natural language. ## Frequently Asked Questions **Can I use the Gameball MCP to check customer points?** Yes, you can ask your agent to pull real-time balances for any customer. It shows the points, their cash value, and any upcoming expiration dates. **How does the Gameball MCP handle order rewards?** It automatically awards points when you track an order. You can also use it to finalize redemptions so points aren't spent twice. **Can I use the Gameball MCP to manage customer profiles?** You can create new profiles or update existing ones with custom attributes. This keeps your loyalty data consistent across your tools. **Does the Gameball MCP support point refunds?** Yes, it can process refunds or cancellations. This allows you to reverse earned points from a return or restore points from a failed redemption. **Can I use the Gameball MCP to track customer behavior?** You can pull activity logs and send custom events. This helps you see what your customers are doing and trigger rewards based on those actions. **Is the Gameball MCP good for e-commerce support?** It's ideal for support teams. They can handle balance inquiries and point adjustments directly in their chat interface without switching tabs. **How can I check a customer's current points balance?** Use the `get_customer_balance` tool by providing the unique Customer ID. The agent will return the points balance, their monetary value, and any points nearing expiration. **Can I reserve points during a checkout process to prevent double-spending?** Yes! The `hold_points` action allows you to temporarily lock a specific amount of points for a customer, ensuring they aren't used elsewhere while the transaction is being finalized. **How do I reward points to a customer for a new purchase?** Use the `track_order` tool. By submitting the order ID and total price, Gameball will automatically calculate and award the appropriate loyalty points based on your configured rules.