bulk_delete_messages
Remove multiple recent messages from a Discord channel to manage content or perform moderation tasks.
Instructions
Delete multiple recent messages from a channel.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_id | Yes | ||
| message_ids | No | ||
| limit | No | ||
| reason | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- The main handler function that executes the bulk delete messages tool. Fetches the channel, purges up to 100 recent messages, and returns a confirmation message.
async def handle_bulk_delete_messages(discord_client, arguments: Dict[str, Any]) -> List[TextContent]: """Bulk delete messages in a channel""" channel = await discord_client.fetch_channel(int(arguments["channel_id"])) limit = min(arguments["limit"], 100) deleted = await channel.purge( limit=limit, reason=arguments.get("reason", "Bulk delete via MCP") ) return [TextContent( type="text", text=f"Deleted {len(deleted)} messages from #{channel.name}\nReason: {arguments.get('reason', 'Bulk delete via MCP')}" )] - The JSON schema defining the input parameters for the bulk_delete_messages tool: channel_id (required), limit (required, max 100), reason (optional).
inputSchema={ "type": "object", "properties": { "channel_id": {"type": "string", "description": "Channel ID"}, "limit": {"type": "number", "description": "Number of messages to delete (max 100)"}, "reason": {"type": "string", "description": "Reason for deletion"} }, "required": ["channel_id", "limit"] } - src/discord_mcp/integrated_server.py:1005-1019 (registration)The dispatching logic in call_tool that routes 'bulk_delete_messages' to the corresponding handler method in AdvancedToolHandlers class.
advanced_tool_names = [ "edit_server_settings", "create_server_template", "create_channel_category", "create_voice_channel", "create_stage_channel", "create_forum_channel", "create_announcement_channel", "edit_channel", "set_channel_permissions", "create_role", "edit_role", "delete_role", "create_role_hierarchy", "create_emoji", "create_webhook", "send_webhook_message", "ban_member", "kick_member", "timeout_member", "bulk_delete_messages", "create_scheduled_event", "create_invite", "create_thread", "create_automod_rule" ] if name in advanced_tool_names: handler_method = f"handle_{name}" if hasattr(AdvancedToolHandlers, handler_method): return await getattr(AdvancedToolHandlers, handler_method)(discord_client, arguments) - src/discord_mcp/integrated_server.py:451-463 (registration)The Tool object instantiation that registers the bulk_delete_messages tool with MCP framework, including name, description, and schema.
Tool( name="bulk_delete_messages", description="Bulk delete messages in a channel", inputSchema={ "type": "object", "properties": { "channel_id": {"type": "string", "description": "Channel ID"}, "limit": {"type": "number", "description": "Number of messages to delete (max 100)"}, "reason": {"type": "string", "description": "Reason for deletion"} }, "required": ["channel_id", "limit"] } ),