diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7f9e0d5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# CIIMS web service message exchange proxy
+
+
+## send
+
+* context: /send
+```json
+{
+    "url":"http://domain.tld", //optional old ciims server
+    "user":"ciims username",
+    "pass":"ciims password",
+    "event":"route event id",
+    "priority":0, //optional
+    "val": false, //optional
+    "msg":"ciims xml message body"
+}
+```
+
+## receive
+
+* context: /
+```json
+{
+    "url":"http://domain.tld", //optional old ciims server
+    "user":"ciims username",
+    "pass":"ciims password",
+    "count": 3
+}
+```
\ No newline at end of file