discord-mcp

List roles

discord_list_roles

Read-only

Toolset
Roles roles
Context cost
272 tokens, estimated1,086 bytes of definition, divided by 4

List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. Read-only. Returns { roles: [...] }. Use discord_get_role_members to see who holds a given role.

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).

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
rolesrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
color (nested, level 1)requiredstring
position (nested, level 1)requirednumber
memberCount (nested, level 1)requirednumber
permissions (nested, level 1)requiredarray of strings
hoist (nested, level 1)requiredboolean
mentionable (nested, level 1)requiredboolean

Related tools

Named in its description

Also in Roles

Raw definition (1,086 bytes)
{
  "name": "discord_list_roles",
  "description": "List all roles in a server (excluding @everyone), highest-first, with color, position, member count, and permissions. Read-only. Returns { roles: [...] }. Use discord_get_role_members to see who holds a given role.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      }
    },
    "required": [
      "guild_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "roles": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "color": {
              "type": "string"
            },
            "position": {
              "type": "number"
            },
            "memberCount": {
              "type": "number"
            },
            "permissions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "hoist": {
              "type": "boolean"
            },
            "mentionable": {
              "type": "boolean"
            }
          },
          "required": [
            "id",
            "name",
            "color",
            "position",
            "memberCount",
            "permissions",
            "hoist",
            "mentionable"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "roles"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List roles",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}