diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1721bc6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+# CloudFoundry VCAP Parser
+This simple package handles the parsing of CloudFoundry's environment variables for both the application itself as well as the service bindings.
+It gives you nice methods to easily get different metadata or credentials about your app and its services.