create_guild_role
Create a Discord server role with custom name, color, icon, and permissions like MANAGE_MESSAGES. Set hoist and mentionable options to control how members see and use the role.
Instructions
Create a role. permissions accept names like ["MANAGE_MESSAGES"]. [POST /guilds/{guild_id}/roles]
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>"
},
"name": "create_guild_role"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | ||
| name | No | ||
| hoist | No | ||
| colors | No | Role colours {primary_color, secondary_color, tertiary_color} (gradient roles) | |
| reason | No | Reason (shown in the audit log) | |
| guild_id | Yes | Server (guild) ID | |
| description | No | ||
| mentionable | No | ||
| permissions | No | Permissions: bitfield string, or names like ["VIEW_CHANNEL","SEND_MESSAGES"] | |
| unicode_emoji | No |