Bulk delete messages (admin)
discord_admin_purge_messagesDelete up to 100 recent messages in a Discord channel or thread, optionally filtering by author, bots, or text; messages older than 14 days are skipped.
Instructions
Delete up to 100 recent messages in a channel or thread, optionally only from one user, only bots, or containing some text. Discord only bulk-deletes messages under 14 days old; older ones are skipped. Cannot be undone; confirm with the user first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"channel_id": "<channel_id>",
"count": "<count>"
},
"name": "discord_admin_purge_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | How many recent messages to look at | |
| reason | No | Reason, recorded in Discord's audit log | |
| contains | No | ||
| author_id | No | Only this user's messages | |
| bots_only | No | ||
| channel_id | Yes | Channel, thread or post |