Bulk ban
discord_
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_ for a single ban with finer control.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | yes | May perform destructive updates, so clients can ask before running it. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| user_ | array of strings | 1 to 200 items | Array of user IDs (snowflakes) to ban (max 200 per call, a Discord API limit). |
| delete_ | integer | 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_ | boolean | default true | If true (default), returns the user IDs a real call would send, unchecked, and bans no one. Set false to actually ban. |
| reasonoptional | string | none | Optional reason recorded in the server audit log. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type | Description |
|---|---|---|
| dry_ | boolean | true for a preview: no one was banned. |
| would_ | array of strings | Dry run only: the user IDs a real call would send to Discord, unchecked. |
| banned | array of strings | User IDs banned by this call. |
| failed | array of strings | User IDs not banned, including users who were already banned. |
Related tools
Named in its description
Also in Members
-
List members, Read-only
discord_list_ members -
Get member info, Read-only
discord_get_ member_ info -
Kick member, Destructive
discord_kick_ member -
Unban member, Write
discord_unban_ member -
Timeout member, Write
discord_timeout_ member -
Search members, Read-only
discord_search_ members -
Set nickname, Write
discord_set_ nickname -
List bans, Read-only
discord_list_ bans -
Prune inactive members, Destructive
discord_prune_ 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
}
}