diff --git a/plugins/jsontools/README.md b/plugins/jsontools/README.md
index 309ce9b5f..975d2bb79 100644
--- a/plugins/jsontools/README.md
+++ b/plugins/jsontools/README.md
@@ -6,7 +6,13 @@ Handy command line tools for dealing with json data.
 
 - **pp_json** - pretty prints json
 - **is_json** - returns true if valid json; false otherwise
+- **urlencode_json** - returns a url encoded string for the given json 
 
+## Usage
+Usage is simple...just take your json data and pipe it into the appropriate jsontool.
+```sh
+<json data> | <jsontools tool>
+```
 ## Examples
 
 ##### pp_json
@@ -14,22 +20,16 @@ Handy command line tools for dealing with json data.
 ```sh
 # curl json data and pretty print the results
 curl https://coderwall.com/bobwilliams.json | pp_json
-
-# pretty print the contents of an existing json file
-less data.json | pp_json
-
-# json data directly from the command line
-echo '{"b":2, "a":1}' | pp_json
 ```
 
 ##### is_json
 ```sh
-# curl json data and pretty print the results
-curl https://coderwall.com/bobwilliams.json | is_json
-
 # pretty print the contents of an existing json file
 less data.json | is_json
+```
 
+##### urlencode_json
+```sh
 # json data directly from the command line
-echo '{"b":2, "a":1}' | is_json
+echo '{"b":2, "a":1}' | urlencode_json
 ```
\ No newline at end of file
diff --git a/plugins/jsontools/jsontools.plugin.zsh b/plugins/jsontools/jsontools.plugin.zsh
index b8b558807..8877ee62f 100644
--- a/plugins/jsontools/jsontools.plugin.zsh
+++ b/plugins/jsontools/jsontools.plugin.zsh
@@ -8,6 +8,7 @@ fi
 if [[ $(whence node) != "" && ( "x$JSONTOOLS_METHOD" = "x"  || "x$JSONTOOLS_METHOD" = "xnode" ) ]]; then
 	alias pp_json='xargs -0 node -e "console.log(JSON.stringify(JSON.parse(process.argv[1]), null, 4));"'
 	alias is_json='xargs -0 node -e "try {json = JSON.parse(process.argv[1]);} catch (e) { console.log(false); json = null; } if(json) { console.log(true); }"'
+	alias urlencode_json='xargs -0 node -e "console.log(encodeURIComponent(JSON.stringify(process.argv[1])))"'
 elif [[ $(whence python) != "" && ( "x$JSONTOOLS_METHOD" = "x" || "x$JSONTOOLS_METHOD" = "xpython" ) ]]; then
 	alias pp_json='python -mjson.tool'
 	alias is_json='python -c "
@@ -18,10 +19,15 @@ except ValueError, e:
 	print False
 else:
 	print True
+sys.exit(0)"'
+	alias urlencode_json='python -c "
+import urllib, json, sys;
+print urllib.quote_plus(json.dumps(sys.stdin.read()))
 sys.exit(0)"'
 elif [[ $(whence ruby) != "" && ( "x$JSONTOOLS_METHOD" = "x" || "x$JSONTOOLS_METHOD" = "xruby" ) ]]; then
 	alias pp_json='ruby -e "require \"json\"; require \"yaml\"; puts JSON.parse(STDIN.read).to_yaml"'
 	alias is_json='ruby -e "require \"json\"; begin; JSON.parse(STDIN.read); puts true; rescue Exception => e; puts false; end"'
+	alias urlencode_json='ruby -e "require \"uri\"; puts URI.escape(STDIN.read)"'
 fi
 
 unset JSONTOOLS_METHOD