# AccelByte MCP

> AccelByte integrates your game backend directly into your AI agent. You can manage everything from player accounts and achievements to leaderboards and purchases using natural conversation. This MCP lets you handle live operations and developer tasks—like creating users or banning accounts—without touching an admin dashboard.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** game-backend, player-management, live-ops, achievements, leaderboards

## Description

This MCP connects your AccelByte game backend services, letting your AI client work directly with your core game logic. You're no longer stuck jumping between multiple dashboards just to check player status or fix a small entitlement issue. Your agent becomes a dedicated live operations assistant that handles the messy parts of running a large-scale online game.

Want to know if a user paid for an item? Your agent can query their wallet and even generate the necessary purchase orders. Need to test new content? You can quickly create dummy users, grant them specific entitlements, or unlock achievements just by talking to your AI client. The entire catalog of 4,000+ integrations on Vinkius gives you access to this powerful connection right alongside everything else your business needs.

It lets developers and ops teams perform deep backend tasks—like updating account statuses, listing friends, or checking leaderboard rankings—all through simple conversation.

## Tools

### ban_user
Permanently blocks a user account from accessing the game services.

### create_order
Generates a record for a player's purchase, initiating an in-game transaction.

### create_user
Registers and sets up a brand new user account within a specified game namespace.

### delete_client
Removes an existing Identity and Access Management client credential.

### generate_token
Creates a temporary OAuth2 access token required for secure service communication.

### get_leaderboard
Retrieves the current ranking and scores for a specified leaderboard code.

### get_user
Fetches all core details, profile information, and status of a specific user account.

### get_user_wallets
Queries the current balance and transaction history for a specified user's wallet.

### grant_entitlement
Manually provides an item or access right to a user account.

### list_friends
Retrieves the list of other player accounts that are connected as friends.

### unlock_achievement
Records a specific achievement for a user, usually marking progress toward game goals.

### update_user_status
Changes the active status of an account, enabling or disabling login access.

## Prompt Examples

**Prompt:** 
```
Create a new user with email player1@example.com in the 'GameAlpha' namespace.
```

**Response:** 
```
I've created the user in the 'GameAlpha' namespace. The new User ID is 'ab-98765' and the display name is set to 'player1'.
```

**Prompt:** 
```
Show me the leaderboard rankings for code 'TOP_PLAYERS_2024' in namespace 'studio-1'.
```

**Response:** 
```
Fetching rankings for 'TOP_PLAYERS_2024'... I've found the top players. 'SpeedyGamer' is currently in 1st place with 15,000 points.
```

**Prompt:** 
```
Unlock achievement 'FIRST_BLOOD' for user 'user-777' in namespace 'game-v1'.
```

**Response:** 
```
Processing... The achievement 'FIRST_BLOOD' has been successfully unlocked for user 'user-777'.
```

## Capabilities

### User Account Management
The agent can create new user accounts, retrieve detailed profiles, update an account's active status, or ban users across your game namespaces.

### Progress and Social Status
You can list a player's friends, check their real-time standing on leaderboards, or grant them specific achievements.

### Economy and Purchases
The agent handles in-game commerce by querying user wallets, creating purchase orders, and granting item entitlements for transactions.

### Security and Identity
You can generate secure OAuth2 access tokens or delete specific IAM client credentials to manage service communication.

## Use Cases

### Investigating an account suspension issue
A player reports they can't log in. Instead of logging into the admin tool and digging through logs to see why, you prompt your agent: 'Get user details for player-X.' The agent uses `get_user` and immediately shows if the status needs updating or if an account ban was applied via `ban_user`.

### Setting up a complex test scenario
A developer needs to test how a new item works. They ask their agent to first `create_user`, then use `grant_entitlement` to give that user the item, and finally call `unlock_achievement` to confirm progress—all in one conversational thread.

### Monitoring leaderboard integrity
The ops team suspects a score might be wrong. They ask the agent to run `get_leaderboard` for a specific competition code. The result instantly shows the top players and their point totals, eliminating manual cross-referencing.

### Processing large batches of new users
Instead of manually entering 50 test accounts into an admin form, you instruct your agent to call `create_user` repeatedly with a list of emails and namespaces. The result is immediate user setup for QA testing.

## Benefits

- Stop checking admin dashboards for simple data. Instead of manually running a check to see if a user paid, just ask the agent to query their wallet using `get_user_wallets` and get instant confirmation.
- When you need to onboard or test a new player profile, use `create_user` directly through your AI client. You bypass slow UI forms and get immediate account creation results.
- Banning or reactivating accounts used to involve multiple clicks in different panels. Now, the agent handles status changes instantly by running `update_user_status`, giving you full control over account access.
- Updating player progress is faster than ever. To simulate a user doing something cool, simply call `unlock_achievement` and track their immediate progress via `get_user` details.
- You can handle complex game economies immediately. Generating purchase orders using `create_order` feels as simple as sending a message, making live commerce management frictionless.

## How It Works

The bottom line is you talk to your AI client, and it talks directly to your game database using AccelByte's API.

1. First, you subscribe to this MCP on Vinkius and provide your AccelByte Base URL and Access Token.
2. Next, you instruct your AI agent with a natural language request, like 'Ban user X' or 'What is player Y's leaderboard score?'
3. Finally, the agent executes the necessary backend function via the MCP and returns the resulting status or data.

## Frequently Asked Questions

**How do I check if a user exists using AccelByte MCP?**
You use the `get_user` tool. You provide the user's unique ID, and the agent returns all their detailed profile information to confirm existence and status.

**Can I ban a player account via the AccelByte MCP?**
Yes, you use the `ban_user` tool. This immediately changes the user's access state in your backend system without needing manual dashboard intervention.

**What if I need to see a player’s friend list using AccelByte MCP?**
The agent uses `list_friends` to retrieve all associated accounts. It gives you a clean, up-to-date roster of their connections.

**How does the AccelByte MCP handle item grants?**
Use the `grant_entitlement` tool. You simply tell your agent which item and to which user ID you want to grant it, bypassing manual inventory updates.

**Is generating OAuth tokens done through AccelByte MCP?**
Yes, you use the `generate_token` function. This tool securely handles the creation of necessary access tokens for service-to-service communication.