diff --git a/BUILD.md b/BUILD.md
index ca5dd03a..e3911b5b 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -98,7 +98,8 @@ the login milestone and is the lightweight control plane for the live USB.
 
 `colibri-mcp` is staged out of the box for MCP-capable editors and assistants.
 It defaults to read-only tools; launch it with `COLIBRI_MCP_WRITE=1` only for a
-trusted write-capable MCP profile.
+trusted write-capable MCP profile. Example MCP client configs are installed at
+`/usr/local/share/clawdie-iso/mcp-examples/`.
 
 ### Colibri vs. Clawdie service names
 
diff --git a/build.sh b/build.sh
index a04be321..85be7d35 100755
--- a/build.sh
+++ b/build.sh
@@ -1465,6 +1465,13 @@ EOF
     mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap"
     install -m 0644 "${LIVE_SESSION_DIR}/bootstrap.html" \
         "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap/index.html"
+    if [ -d "${LIVE_SESSION_DIR}/mcp-examples" ]; then
+        mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples"
+        cp -R "${LIVE_SESSION_DIR}/mcp-examples/." \
+            "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples/"
+        find "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples" \
+            -type f -exec chmod 0644 {} +
+    fi
     chroot "$MOUNT_POINT" chown -R clawdie:clawdie /home/clawdie/Desktop
     chmod 0755 "${MOUNT_POINT}/home/clawdie/Desktop"
     chmod 0644 \
diff --git a/live/operator-session/bootstrap.html b/live/operator-session/bootstrap.html
index f3344e00..f20d6205 100644
--- a/live/operator-session/bootstrap.html
+++ b/live/operator-session/bootstrap.html
@@ -122,6 +122,10 @@ colibri-mcp tools          # MCP bridge, read-only by default
 COLIBRI_MCP_WRITE=1 colibri-mcp tools  # trusted write-capable profile
 colibri create-task --title "check network"
 colibri list-tasks --status queued</pre>
+      <p>
+        MCP client examples are installed under
+        <code>/usr/local/share/clawdie-iso/mcp-examples/</code>.
+      </p>
 
       <h2>pi assistant</h2>
       <pre>
diff --git a/live/operator-session/mcp-examples/README.md b/live/operator-session/mcp-examples/README.md
new file mode 100644
index 00000000..1ff30f04
--- /dev/null
+++ b/live/operator-session/mcp-examples/README.md
@@ -0,0 +1,58 @@
+# Colibri MCP client examples
+
+The live USB includes `/usr/local/bin/colibri-mcp`, an MCP server that exposes
+Colibri status, glasspane snapshots, task lists, and skills to MCP-capable
+editors/assistants.
+
+Default posture is read-only. Write tools are available only when the MCP server
+process is launched with `COLIBRI_MCP_WRITE=1`.
+
+## Generic MCP client config
+
+Most MCP clients accept a config shaped like `mcpServers`. Use one of:
+
+- `mcp-readonly.json` — safe default profile
+- `mcp-trusted-write.json` — explicit trusted profile with write tools enabled
+
+## Quick checks
+
+```sh
+colibri-mcp tools
+COLIBRI_MCP_WRITE=1 colibri-mcp tools
+colibri-mcp socket-path
+```
+
+## Claude Code example
+
+If your Claude Code version supports `claude mcp add`, adapt:
+
+```sh
+claude mcp add colibri /usr/local/bin/colibri-mcp
+claude mcp add colibri-write --env COLIBRI_MCP_WRITE=1 /usr/local/bin/colibri-mcp
+```
+
+If your version uses a JSON config file instead, copy the matching object from
+`mcp-readonly.json` or `mcp-trusted-write.json`.
+
+## Zed / Cursor example
+
+Zed, Cursor, and other MCP-capable editors may use slightly different config
+file paths or wrapper keys by version. The server object is the important part:
+
+```json
+{
+  "command": "/usr/local/bin/colibri-mcp",
+  "args": [],
+  "env": {}
+}
+```
+
+For a write-capable profile, add:
+
+```json
+{
+  "env": { "COLIBRI_MCP_WRITE": "1" }
+}
+```
+
+Only enable the write profile for trusted workspaces/sessions.
diff --git a/live/operator-session/mcp-examples/mcp-readonly.json b/live/operator-session/mcp-examples/mcp-readonly.json
new file mode 100644
index 00000000..56617b39
--- /dev/null
+++ b/live/operator-session/mcp-examples/mcp-readonly.json
@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "colibri": {
+      "command": "/usr/local/bin/colibri-mcp",
+      "args": [],
+      "env": {}
+    }
+  }
+}
diff --git a/live/operator-session/mcp-examples/mcp-trusted-write.json b/live/operator-session/mcp-examples/mcp-trusted-write.json
new file mode 100644
index 00000000..68151d90
--- /dev/null
+++ b/live/operator-session/mcp-examples/mcp-trusted-write.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "colibri-write": {
+      "command": "/usr/local/bin/colibri-mcp",
+      "args": [],
+      "env": {
+        "COLIBRI_MCP_WRITE": "1"
+      }
+    }
+  }
+}