diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c0bb419
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# xy — HTTP MCP server supervisor
+
+Daemon + CLI that launches and supervises HTTP-based MCP servers.
+
+## Build
+
+    cargo build --release
+
+## Run
+
+    target/release/xy daemon       # foreground
+
+Drop a server definition into `$XDG_CONFIG_HOME/xy/servers/<name>.kdl`
+(see `examples/insikt.kdl`) and `xy reload`.
+
+Commands:
+
+    xy list
+    xy status <name>
+    xy start  <name|--all>
+    xy stop   <name|--all>
+    xy restart <name|--all>
+    xy reload
+    xy logs <name> [--tail N] [--follow]
+
+Exit codes: 0 success, 1 operational error, 2 daemon unreachable, 3 config invalid.
diff --git a/examples/insikt.kdl b/examples/insikt.kdl
new file mode 100644
index 0000000..42c59dc
--- /dev/null
+++ b/examples/insikt.kdl
@@ -0,0 +1,15 @@
+command "/Users/you/.cargo/bin/insikt-mcp"
+args "--http" "--port" "8421"
+port 8421
+
+env {
+    RUST_LOG "info"
+}
+
+restart {
+    policy "on-failure"
+}
+
+stop {
+    grace "10s"
+}