diff --git a/README.md b/README.md
index e69de29..9ec671e 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,22 @@
+# mc-connect
+
+Bash wrapper for the Discord-Linux API
+
+## usage
+
+mc-connect uses your my-mc.link api key.
+
+```bash
+export MY_MC_API_KEY='<my-mc.link api key'
+```
+
+sub-commands can be shown by running the script without arguments
+
+```bash
+./mc
+```
+
+to start your Minecraft container:
+```bash
+./mc start
+```
\ No newline at end of file