discord-mcp

Unban member

discord_unban_member

Write

Toolset
Members members
Discord permission
Ban Members
Context cost
193 tokens, estimated771 bytes of definition, divided by 4

Lift a ban so the user may rejoin via a new invite. Requires the Ban Members permission. Reverses discord_ban_member. 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 banned user to unban.
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

Named in its description

Also in Members

Raw definition (771 bytes)
{
  "name": "discord_unban_member",
  "description": "Lift a ban so the user may rejoin via a new invite. Requires the Ban Members permission. Reverses discord_ban_member. 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 banned user to unban."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "guild_id",
      "user_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Unban member",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}