diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4313838
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# cloud-server
+
+Multi-cloud VM instance database API
+
+## Overview
+
+Provides unified API for managing cloud server instance data across multiple providers.
+
+## Features
+
+- Multi-cloud support (Linode, Vultr, etc.)
+- Instance metadata management
+- Price comparison
+- Region filtering
+
+## License
+
+MIT