diff --git a/ts/client/scripts/mm/README.md b/ts/client/scripts/mm/README.md
new file mode 100644
index 000000000..85d800e64
--- /dev/null
+++ b/ts/client/scripts/mm/README.md
@@ -0,0 +1,7 @@
+This directory contains a sample market maker (`market-maker.ts`) in typescript, which can be run using ts-node.
+
+The environment variables required are
+
+- `MANGO_ACCOUNT_PK` - public key of the mango account
+- `KEYPAIR` - private key of the owner of the mango account
+- `MB_CLUSTER_URL` - RPC cluster url