discord-mcp

Ban member

discord_ban_member

Destructive

Toolset
Members members
Discord permission
Ban Members
Context cost
277 tokens, estimated1,107 bytes of definition, divided by 4

Ban a user from the server, blocking re-entry until unbanned. Optionally bulk-deletes their recent messages. Requires the Ban Members permission, and the bot's top role must outrank the target's. Use discord_unban_member to reverse, or discord_kick_member for a non-permanent removal. The reason is recorded in the audit log.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
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 user to ban.
reasonoptionalstring
none
Optional reason recorded in the server audit log.
delete_message_daysoptionalinteger
0 to 7default 0
Also delete the user's messages from the last N days (0–7). Default 0 (delete nothing).

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 (1,107 bytes)
{
  "name": "discord_ban_member",
  "description": "Ban a user from the server, blocking re-entry until unbanned. Optionally bulk-deletes their recent messages. Requires the Ban Members permission, and the bot's top role must outrank the target's. Use discord_unban_member to reverse, or discord_kick_member for a non-permanent removal. 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 user to ban."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      },
      "delete_message_days": {
        "default": 0,
        "description": "Also delete the user's messages from the last N days (0–7). Default 0 (delete nothing).",
        "type": "integer",
        "minimum": 0,
        "maximum": 7
      }
    },
    "required": [
      "guild_id",
      "user_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Ban member",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": true
  }
}