discord_add_role
Assign an existing Discord role to a member using guild ID, user ID, and role ID; Manage Roles is required, and the role must sit below the bot's highest role.
Instructions
Assign an existing role to a member. Requires the Manage Roles permission, and the role must be below the bot's highest role. Idempotent: assigning a role the member already has has no effect. Use discord_remove_role to undo.
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>",
"user_id": "<user_id>",
"role_id": "<role_id>"
},
"name": "discord_add_role"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Optional reason recorded in the server audit log. | |
| role_id | Yes | ID (snowflake) of the role to assign. | |
| user_id | Yes | Discord user ID (snowflake) of the member to give the role to. | |
| guild_id | Yes | Discord server (guild) ID (snowflake). |