list_roles

List all roles in the guild sorted by position (highest first). Returns each role’s ID, name, color, member count, hoist status, mentionable status, and whether it is managed. Use when the user asks about available roles or needs to pick a role by name.

User guide / All capabilities

Contract

Effect: read. Evidence role: live_evidence.

List all roles in the guild sorted by position. Use when the user asks about available roles.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "include_member_counts": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "Optional: include number of members per role. Default: true."
    }
  },
  "required": []
}

Execution requirements

• guild context should exist

Expected postconditions

• returns list of all guild roles