discord-mcp

Set role icon

discord_set_role_icon

Write

Toolset
Roles roles
Discord permission
Manage Roles
Context cost
269 tokens, estimated1,074 bytes of definition, divided by 4

Set or clear a role's icon, either a custom image or a unicode emoji. Requires the server to be Boost Level 2+ (the ROLE_ICONS feature) and the Manage Roles permission. Pass null to either field to remove that icon. Returns a confirmation.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintyesRepeating the call with the same arguments has no additional effect.
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 set the icon on.
iconoptionalstring or "null" or null
string:format uripattern ^https?://
"null"
null
Image URL for the role icon, or null to remove it.
unicode_emojioptionalstring or null
none
Unicode emoji to use as the role icon, or null to remove it.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Also in Roles

Raw definition (1,074 bytes)
{
  "name": "discord_set_role_icon",
  "description": "Set or clear a role's icon, either a custom image or a unicode emoji. Requires the server to be Boost Level 2+ (the ROLE_ICONS feature) and the Manage Roles permission. Pass null to either field to remove that icon. Returns a confirmation.",
  "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 set the icon on."
      },
      "icon": {
        "description": "Image URL for the role icon, or null to remove it.",
        "anyOf": [
          {
            "anyOf": [
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https?://"
              },
              {
                "type": "string",
                "const": "null"
              }
            ]
          },
          {
            "type": "null"
          }
        ]
      },
      "unicode_emoji": {
        "description": "Unicode emoji to use as the role icon, or null to remove it.",
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "guild_id",
      "role_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Set role icon",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}