bulk_delete_messages
Remove multiple recent messages from a Discord channel to manage content or perform moderation actions.
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 |
Implementation Reference
- Main handler function that executes bulk deletion of up to 100 recent messages from a specified Discord channel using channel.purge(). Returns confirmation of messages deleted.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')}" )]
- src/discord_mcp/integrated_server.py:451-463 (registration)Registers the 'bulk_delete_messages' tool in the MCP server's tool list, including name, description, and input schema for channel_id (required), limit (required), and optional reason.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"] } ),
- src/discord_mcp/integrated_server.py:1005-1019 (registration)Dispatch logic in call_tool() that routes 'bulk_delete_messages' calls to AdvancedToolHandlers.handle_bulk_delete_messages based on inclusion in advanced_tool_names list.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)