discord-mcp

Get role members

discord_get_role_members

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_list_roles to discover role IDs first.

Risk and annotations

Read-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).
role_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the role to list holders of.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
membersrequiredarray of objects
id (nested, level 1)requiredstring
username (nested, level 1)requiredstring
nickname (nested, level 1)requiredstring or null
truncatedrequiredboolean
notestring

Related tools

Named in its description

Also in Roles

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
  }
}