Roles
roles
2 read-only, 6 write, 1 destructive
- Tools
- 9 tools
- Context cost
- 2,423 tokens, estimated9,690 bytes of definitions, divided by 4
- Read-only mode
- Keeps 2 of its 9 tools
Create, edit, assign, order and delete roles.
Its 9 tools
-
Read-only
List roles
discord_List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. ~272 tokenslist_ roles -
Write
Create role
discord_Create a new role in a server. ~320 tokenscreate_ role -
Write
Edit role
discord_Update an existing role's name, color, permissions, hoist, or mentionable flag. ~368 tokensedit_ role -
Destructive
Delete role
discord_Permanently delete a role from the server; it is automatically removed from every member who held it. ~199 tokensdelete_ role -
Write
Add role to member
discord_Assign an existing role to a member. ~241 tokensadd_ role -
Write
Remove role from member
discord_Remove a role from a member. ~240 tokensremove_ role -
Read-only
Get role members
discord_List members who currently hold a specific role, scanning up to 20,000 members. ~272 tokensget_ role_ members -
Write
Set role position
discord_Move a role up or down in the server's role hierarchy, which determines permission precedence and member-list ordering. ~243 tokensset_ role_ position -
Write
Set role icon
discord_Set or clear a role's icon, either a custom image or a unicode emoji. ~269 tokensset_ role_ icon
Load only this toolset
DISCORD_MCP_TOOLSETS=roles
Tip: add discovery, as in DISCORD_MCP_TOOLSETS=. Its discord_ (read-only) finds the guild_id most other tools need. Combine toolsets in the builder.
README profiles that include it
- Everything
unset100 tools, ~35.1k tokens - Moderator
discovery,31 tools, ~9.6k tokensmembers, moderation, roles, permissions
The profiles come from the README section Expose only what you need.