discord_set_bot_username
Change the bot's global Discord username. It applies across all servers, leaves server names and nicknames unchanged, and returns the new username or a 429 when rate-limited.
Instructions
Change the bot's global username. WARNING: this is the most rate-limited endpoint Discord offers (roughly two changes per hour), it applies in every server, and Discord may reject names that are taken or reserved. If the call is throttled it will fail with a 429 and you must wait. This does not change the server name or the bot's nickname. Returns the new username.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"username": "<username>"
},
"name": "discord_set_bot_username"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | New global username (2–32 characters). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | ||
| previous_username | Yes |