Get role members
discord_
Read-only
- Toolset
- Roles
roles - Context cost
- 272 tokens, estimated1,087 bytes of definition, divided by 4
List members who currently hold a specific role, scanning up to 20,000 members. Returns { members: [...], truncated }; check `truncated` on very large servers. Read-only. Use discord_ to discover role IDs first.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| role_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the role to list holders of. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| membersrequired | array of objects |
| id (nested, level 1)required | string |
| username (nested, level 1)required | string |
| nickname (nested, level 1)required | string or null |
| truncatedrequired | boolean |
| note | string |
Related tools
Named in its description
Also in Roles
-
Create role, Write
discord_create_ role -
Edit role, Write
discord_edit_ role -
Delete role, Destructive
discord_delete_ role -
Add role to member, Write
discord_add_ role -
Remove role from member, Write
discord_remove_ role -
Set role position, Write
discord_set_ role_ position -
Set role icon, Write
discord_set_ role_ icon
Raw definition (1,087 bytes)
{
"name": "discord_get_role_members",
"description": "List members who currently hold a specific role, scanning up to 20,000 members. Returns { members: [...], truncated }; check `truncated` on very large servers. Read-only. Use discord_list_roles to discover role IDs first.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"role_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the role to list holders of."
}
},
"required": [
"guild_id",
"role_id"
],
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"nickname": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"username",
"nickname"
],
"additionalProperties": false
}
},
"truncated": {
"type": "boolean"
},
"note": {
"type": "string"
}
},
"required": [
"members",
"truncated"
],
"additionalProperties": false
},
"annotations": {
"title": "Get role members",
"readOnlyHint": true,
"openWorldHint": true
}
}