diff --git a/README.md b/README.md
index ab45b26..cc52257 100644
--- a/README.md
+++ b/README.md
@@ -2,3 +2,18 @@
 
 This is a go layer on top of the Harmony RPC, included is a CLI tool that you can build with a
 simple invocation of `make`
+
+# Usage
+
+hmy_cli implements a fluent API
+
+```bash
+./hmy_cli blockchain protocol-version
+{"jsonrpc":"2.0","id":"0","result":"0x1"}
+```
+
+# Debugging
+
+```bash
+HMY_RPC_DEBUG=true ./hmy_cli blockchain protocol-version
+```