diff --git a/README.md b/README.md
index b329800038ce5e46e5ce1a453dfe182ca46c83e7..8f71afeb0c31e1b311ef34c535f9878f287e6fb5 100644
--- a/README.md
+++ b/README.md
@@ -9,4 +9,13 @@ Alternate MDX research project
 - Create (self-signed) metadata signing cert (```meta.crt/meta.key```)
 - Create output directory (```mkdir output```)
 - Download metadata file(s)
-- Run ```./mdsigner <metadata file(s)>```
\ No newline at end of file
+- Run one or more of the tools below
+
+## ```mdsigner.py [mdfile] [mdfile] [mdfile] ...```
+Reads source metadata file(s) and outputs them signed to filesystem
+
+## ```mdserver.py [mdfile] [mdfile] [mdfile] ...```
+Reads source metadata files(s). Serves and caches them signed from memory, on request
+
+## ```mdproxy.py```
+Caches signed and cached ```mdserver.py``` metadata requests