discord-mcp

Set nickname

discord_set_nickname

Write

Toolset
Members members
Discord permissions
Manage Nicknames, or Change Nickname for the bot itself
Context cost
261 tokens, estimated1,045 bytes of definition, divided by 4

Set or clear a member's server nickname. Pass null (or the string 'null') to clear it. Requires the Manage Nicknames permission (or Change Nickname for the bot itself). To rename another member, their highest role must be below the bot's highest role. The reason is recorded in the audit log.

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).
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the member.
nicknamerequiredstring or null
string:at most 32 characters
null
New nickname (max 32 characters), or null to clear it.
reasonoptionalstring
none
Optional reason recorded in the server audit log.

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 Members

Raw definition (1,045 bytes)
{
  "name": "discord_set_nickname",
  "description": "Set or clear a member's server nickname. Pass null (or the string 'null') to clear it. Requires the Manage Nicknames permission (or Change Nickname for the bot itself). To rename another member, their highest role must be below the bot's highest role. The reason is recorded in the audit log.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the member."
      },
      "nickname": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 32
          },
          {
            "type": "null"
          }
        ],
        "description": "New nickname (max 32 characters), or null to clear it."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "guild_id",
      "user_id",
      "nickname"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Set nickname",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}