# Xsolla MCP for AI Agents AI Agent Connect > Xsolla lets you manage your game's commerce, payments, and virtual catalogs directly through your AI agent. Instead of jumping between merchant dashboards, you can check transaction statuses, issue refunds, and update store items using natural language. It bridges the gap between your Xsolla merchant account and your daily workflow, making it easier to handle player payments and manage your game's economy in real-time. ## Overview - **Category:** gaming-entertainment - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** game-commerce, payment-gateway, virtual-items, transaction-management, fintech ## Description Managing a game's economy often feels like a chore of constant tab-switching. You're jumping from your code editor to a merchant dashboard to check if a specific payment went through, then over to a catalog manager to see if a new bundle is live, and finally into a support tool to handle a refund. It's a fragmented way to work that pulls you away from actual development or strategy. This Connector changes that by bringing your Xsolla merchant account directly into your AI's workspace. You can just ask your agent to pull up a user's recent history or see what's currently in their shopping cart. It makes your commerce operations feel like a conversation rather than a series of manual data entries. Whether you're checking on a promotion's performance or making quick adjustments to virtual items, everything happens in one place. Because Vinkius hosts this connector, you can plug it into your existing setup and start handling complex gaming commerce tasks without ever leaving your primary workspace. It's about making the business side of gaming feel as fluid as the game side. ## Tools ### get_bundles Pulls a list of all active bundles from your store. Use this to verify your current offerings. ### get_events Retrieves a list of events from the Xsolla platform. It helps you stay on top of system notifications. ### get_payment_accounts Shows the saved payment accounts for a specific user. This is useful for verifying payment methods. ### register_user_oauth Registers a new user using the OAuth 2.0 protocol. This streamlines the onboarding process. ### register_user Creates a new user account in the system. Use this to programmatically add new players. ### search_transactions Searches through your transaction history based on your criteria. Find specific orders quickly. ### update_subscription_plan Modifies an existing subscription plan. This lets you adjust pricing or tiers on the fly. ### update_virtual_item_admin Allows admins to update details for a virtual item. Keep your catalog accurate without manual edits. ### verify_promo_code Checks if a specific promotional code is valid for a user. Use this to validate player discounts. ### get_promotions_admin Lets admins see all current promotions. Use this to audit active marketing deals. ### invalidate_token Makes a Pay Station token no longer valid. Use this to secure sessions when needed. ### create_order Creates a new order for a specific item using a user's JWT. This helps automate the checkout flow. ### get_social_login_url Provides the URL for a user to log in via social media. This helps with third-party authentication. ### get_subscription_plans Lists all available subscription plans. Use this to review your recurring revenue models. ### get_transaction_details Pulls the full details for a specific transaction ID. This is the go-to tool for deep auditing. ### get_user_attributes Retrieves specific attributes for a user using their JWT. This helps personalize the user experience. ### get_user_cart Shows the current items in a user's active shopping cart. Use this to assist players with purchases. ### get_user_profile Fetches the profile information for a specific user. This helps you understand your player base. ### activate_promotion Turns on a specific promotion for your store. Use this to launch seasonal sales instantly. ### get_user_subscription Shows the current subscription status for a user. This helps you manage active memberships. ### get_virtual_items Lists all virtual items available in your catalog. Use this to see what's currently for sale. ### create_payment Initiates a payment using a saved user account. This simplifies the checkout experience for players. ### create_subscription_plan Sets up a new subscription plan for your game. Use this to expand your recurring revenue. ### create_token Generates a Pay Station token for a user. This is a core part of the Xsolla payment flow. ### create_virtual_item_admin Allows admins to create new virtual items. Use this to expand your store's inventory quickly. ### link_account Connects a user's account to the platform. This helps sync data across different systems. ### login_user Logs a user into their account. This simplifies the authentication process for your players. ### mark_event_processed Flags an event as having been handled. Use this to keep your event queue organized. ### redeem_coupon Allows a user to use a coupon for their purchase. This makes redeeming rewards much easier. ### refund_transaction Reverses a transaction and issues a refund. Use this to resolve billing disputes quickly. ## Prompt Examples **Prompt:** ``` Find the last three transactions for user 'GamerPro99' and tell me the total spent. ``` **Response:** ``` I've pulled the recent history for **GamerPro99**. Here are the last three transactions: | Date | Amount | Status | | :--- | :--- | :--- | | 2026-07-14 | $19.99 | Completed | | 2026-07-12 | $4.99 | Completed | | 2026-07-10 | $0.99 | Completed | **Total Spent:** $25.97 ``` **Prompt:** ``` Is the 'Warrior Bundle' currently active in our store? ``` **Response:** ``` Yes, the **Warrior Bundle** is currently active. It includes: * 500 Gold * Steel Sword * 2x Health Potions It is currently listed in the store catalog. ``` **Prompt:** ``` I need to refund transaction 550921. Can you check the status first? ``` **Response:** ``` Checking transaction **550921**... This was a payment of **$19.99** for the 'Season Pass' by user **Gamer123**. The current status is **Completed**. Would you like me to process the refund for this transaction now? ``` ## Capabilities ### Issue player refunds instantly Process transaction reversals directly through your AI agent to resolve customer issues. ### Search historical transaction data Query your past sales to find specific orders or audit payment history. ### Update virtual item listings Modify the contents of your store's virtual items and bundles in real-time. ### Manage user shopping carts Inspect active user sessions to see what items they are currently considering. ### Create new subscription plans Set up and manage recurring billing options for your game's services. ### Verify promotional codes Check the validity of discount codes for players before they complete a purchase. ## Use Cases ### Resolving a double-charge A player claims they were charged twice. The support lead asks the agent to search_transactions, finds the duplicate, and uses refund_transaction to fix it. ### Verifying a store launch A developer wants to know if the 'Starter Pack' is live. They ask the agent to get_bundles and confirm the status instantly. ### Launching a weekend sale A product manager wants to start a weekend sale. They tell the agent to activate_promotion for the 'Summer Bundle' to go live. ### Troubleshooting a stuck checkout A user is stuck at checkout. The support rep uses get_user_cart to see what the user is trying to buy and offer specific help. ## Benefits - Faster Support: Use refund_transaction and get_transaction_details to resolve player issues in seconds instead of minutes. - Instant Catalog Checks: See your full inventory using get_virtual_items and get_bundles without leaving your chat. - Real-time Promotion Management: Use activate_promotion and get_promotions_admin to toggle deals on the fly. - Simplified Order Handling: Create new orders or manage carts with create_order and get_user_cart easily. - Easier Subscription Tracking: Use get_user_subscription and update_subscription_plan to keep player memberships accurate. ## How It Works The bottom line is it turns your complex Xsolla merchant dashboard into a conversational command center for your game's economy. 1. Subscribe to the Xsolla MCP and gather your Merchant ID, Project ID, and API Key. 2. Input these credentials into your AI client's configuration settings. 3. Ask your agent to perform tasks like finding transactions or updating store bundles. ## Frequently Asked Questions **Can the Xsolla MCP help my support team handle refunds faster?** Yes, it allows your agent to look up transaction details and issue refunds directly through chat. This removes the need for support staff to log into a separate merchant portal for every request. **How do I use the Xsolla MCP to manage my game's virtual items?** You can ask your agent to list all current items or update specific bundle details in real-time. It gives you a direct way to manage your store inventory using natural language. **Can I check what's in a player's shopping cart using Xsolla MCP?** Yes, your agent can pull up the current items in a user's active cart. This is helpful for troubleshooting checkout issues or assisting players with their purchases. **Does the Xsolla MCP support subscription management?** It allows you to view user subscriptions and update plan details through simple natural language commands. You can manage your recurring revenue models without leaving your workspace. **Can I see my active promotions with Xsolla MCP?** Your agent can pull a list of all active promotions or activate new ones whenever you need. It makes it easy to manage seasonal sales and marketing deals on the fly. **Is the Xsolla MCP good for monitoring game commerce?** It's built specifically for that. It provides a bird's-eye view of transactions, store health, and catalog performance, making it a core tool for game economy management. **Can I search for specific transactions based on their status?** Yes. Use the `search_transactions` tool. You can filter by status (e.g., 'completed', 'canceled') and date ranges to find exactly what you need. **How do I view the virtual items currently available in my catalog?** Simply use the `get_virtual_items` tool. It will retrieve the full list of virtual items configured in your project catalog. **Is it possible to issue a refund through the AI agent?** Yes. By using the `refund_transaction` tool with a valid Transaction ID and an optional reason, the agent can initiate the refund process directly.