discord_set_bot_guild_avatar
Set the bot's per-server avatar to override its global avatar in one Discord server using an image URL, data URI, or base64; pass null to clear it. Requires the server's boost feature.
Instructions
Set the bot's per-server avatar, which overrides the global avatar in that one server. Requires the server to have the BANNER or ROLE_ICONS-adjacent boost feature set that Discord requires for per-guild member avatars; on a server without it Discord rejects the call. Accepts an https URL, data: URI or base64. Pass null to clear it and fall back to the global avatar. Returns the resulting per-server avatar URL.
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": {
"guild_id": "<guild_id>",
"image": "<image>"
},
"name": "discord_set_bot_guild_avatar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | Image as a URL, data URI or base64, or null to clear. | |
| reason | No | Optional reason recorded in the audit log. | |
| guild_id | Yes | Discord server (guild) ID (snowflake). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guild_id | Yes | ||
| guild_avatar | Yes |