diff --git a/README.md b/README.md
index 1816af4..36b7337 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
 # minetest_motd
 A "message of the day" mod for multiplayer Minetest servers.
+
+The message is displayed to a player when he/her joins the server.
+
+The player will be warned when the motd has been set but could not be saved to the disk.
+
+This mod exposes 3 commands:
+
+* /motd - Displays the motd to the player
+
+* /setmotd - Sets the motd (requires the "setmotd" permission)
+
+* /unsetmotd - Removes the motd (requires the "setmotd" permission)