discord-mcp

Bulk ban

discord_bulk_ban

DestructiveDry run by default

Toolset
Members members
Discord permissions
Ban Members and Manage Server
Context cost
561 tokens, estimated2,245 bytes of definition, divided by 4

Ban many users in a single call, intended for raid mitigation. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the user IDs a real call would send to Discord, unchecked, then re-call with dry_run:false to actually ban them. Requires both the Ban Members and Manage Server permissions. Returns { dry_run, would_ban } for a preview, and { dry_run, banned, failed } with the user IDs after a real call; failed also lists users who were already banned. Discord rejects the whole call with an error if no user could be banned. Use discord_ban_member for a single ban with finer control.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
IdempotentidempotentHintnoRepeating the call can have an 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_idsrequiredarray of strings
1 to 200 items
Array of user IDs (snowflakes) to ban (max 200 per call, a Discord API limit).
delete_message_secondsoptionalinteger
0 to 604800default 0
Also delete each user's messages from the last N seconds (0–604800, i.e. up to 7 days). Default 0.
dry_runoptionalboolean
default true
If true (default), returns the user IDs a real call would send, unchecked, and bans no one. Set false to actually ban.
reasonoptionalstring
none
Optional reason recorded in the server audit log.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldTypeDescription
dry_runrequiredbooleantrue for a preview: no one was banned.
would_banarray of stringsDry run only: the user IDs a real call would send to Discord, unchecked.
bannedarray of stringsUser IDs banned by this call.
failedarray of stringsUser IDs not banned, including users who were already banned.

Related tools

Named in its description

Also in Members

Raw definition (2,245 bytes)
{
  "name": "discord_bulk_ban",
  "description": "Ban many users in a single call, intended for raid mitigation. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview the user IDs a real call would send to Discord, unchecked, then re-call with dry_run:false to actually ban them. Requires both the Ban Members and Manage Server permissions. Returns { dry_run, would_ban } for a preview, and { dry_run, banned, failed } with the user IDs after a real call; failed also lists users who were already banned. Discord rejects the whole call with an error if no user could be banned. Use discord_ban_member for a single ban with finer control.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "user_ids": {
        "minItems": 1,
        "maxItems": 200,
        "type": "array",
        "items": {
          "type": "string",
          "pattern": "^\\d{17,20}$"
        },
        "description": "Array of user IDs (snowflakes) to ban (max 200 per call, a Discord API limit)."
      },
      "delete_message_seconds": {
        "default": 0,
        "description": "Also delete each user's messages from the last N seconds (0–604800, i.e. up to 7 days). Default 0.",
        "type": "integer",
        "minimum": 0,
        "maximum": 604800
      },
      "dry_run": {
        "default": true,
        "description": "If true (default), returns the user IDs a real call would send, unchecked, and bans no one. Set false to actually ban.",
        "type": "boolean"
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "guild_id",
      "user_ids"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "dry_run": {
        "type": "boolean",
        "description": "true for a preview: no one was banned."
      },
      "would_ban": {
        "description": "Dry run only: the user IDs a real call would send to Discord, unchecked.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "banned": {
        "description": "User IDs banned by this call.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "failed": {
        "description": "User IDs not banned, including users who were already banned.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "dry_run"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Bulk ban",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}