diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f4d6f6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# mbot
+Simple Matrix bot that will eventually send Web3 `PairCreation` event alerts to the Juggalol Homeserver.
+
+## Configuration
+```json
+{
+  "matrix": {
+    "homeserver": "https://matrix.juggalol.com",
+    "username": "",
+    "password": "",
+    "room_id": ""
+  },
+  "infura_url": ""
+}
+```
\ No newline at end of file