members_bulk_add_role
Assign one existing role to 1–100 explicitly identified guild members in a single batch and return per-member success and failure lists. Use it for bounded bulk role grants, not single-member updates.
Instructions
Purpose: Add one role to 1-100 explicitly identified guild members.
When to use: - Assign the same existing role to a bounded list of known members.
When NOT to use: - Assigning a role to one member -> use members_add_role. - Discovering or filtering members -> use members_list first.
Returns: {role_id, succeeded_user_ids, failed_user_ids, succeeded_count, failed_count}. Each successful PUT includes an idempotent no-op when the member already has the role. An unknown member is reported as a per-member failure. Permission, rate-limit, upstream, and other infrastructure errors stop the batch; prior successful writes remain, and retrying the same request is safe because each PUT is idempotent.
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>",
"role_id": "<role_id>",
"user_ids": "<user_ids>"
},
"name": "members_bulk_add_role"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_id | Yes | Role to add | |
| guild_id | Yes | Guild containing the members | |
| user_ids | Yes | Unique member IDs to grant the role to (1-100) | |
| audit_reason | No | Reason recorded in audit log (X-Audit-Log-Reason header) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||