diff --git a/README.md b/README.md
index d7152ae..afba119 100644
--- a/README.md
+++ b/README.md
@@ -105,28 +105,36 @@ Restart Claude Code fully (**Cmd+Q on Mac**, not just closing the window).
   "mcpServers": {
     "ra-h": {
       "command": "node",
-      "args": ["/absolute/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
+      "args": ["/absolute/path/to/ra-h_os/apps/mcp-server-standalone/index.js"]
     }
   }
 }
 ```
 
+**What happens:** Once connected, Claude will proactively identify valuable information in your conversations and offer to save it to your knowledge graph. It calls `rah_get_context` first to understand what's already in your graph, then searches before creating to avoid duplicates.
+
 Available tools:
 
 | Tool | What it does |
 |------|--------------|
+| `rah_get_context` | Get graph overview — stats, hub nodes, dimensions, recent activity |
 | `rah_search_nodes` | Find nodes by keyword |
 | `rah_add_node` | Create a new node |
 | `rah_get_nodes` | Fetch nodes by ID |
 | `rah_update_node` | Edit an existing node |
 | `rah_create_edge` | Link two nodes together |
+| `rah_update_edge` | Update an edge explanation |
 | `rah_query_edges` | Find connections |
 | `rah_list_dimensions` | List all tags/categories |
+| `rah_create_dimension` | Create a new dimension |
+| `rah_update_dimension` | Update/rename a dimension |
+| `rah_delete_dimension` | Delete a dimension |
 
 **Example prompts for Claude Code:**
+- "What's in my knowledge graph?"
 - "Search my knowledge base for notes about React performance"
 - "Add a node about the article I just read on transformers"
-- "What nodes are connected to my 'project-ideas' dimension?"
+- "What nodes are connected to my 'research' dimension?"
 
 ---
 
diff --git a/apps/mcp-server-standalone/README.md b/apps/mcp-server-standalone/README.md
index 069b254..dac0e60 100644
--- a/apps/mcp-server-standalone/README.md
+++ b/apps/mcp-server-standalone/README.md
@@ -30,8 +30,7 @@ Restart Claude. Done.
 ## Requirements
 
 - Node.js 18+
-- RA-H database at `~/Library/Application Support/RA-H/db/rah.sqlite`
-  - Run the RA-H desktop app once to create it
+- Database is created automatically at `~/Library/Application Support/RA-H/db/rah.sqlite` on first connection
 
 ## Environment Variables
 
@@ -39,15 +38,24 @@ Restart Claude. Done.
 |----------|---------|-------------|
 | `RAH_DB_PATH` | ~/Library/Application Support/RA-H/db/rah.sqlite | Database path |
 
+## What to Expect
+
+Once connected, Claude will:
+- **Call `rah_get_context` first** to see what's in your graph
+- **Proactively offer to save** valuable information from your conversations
+- **Search before creating** to avoid duplicates
+
 ## Available Tools
 
 | Tool | Description |
 |------|-------------|
+| `rah_get_context` | Get graph overview — stats, hub nodes, dimensions, recent activity |
 | `rah_add_node` | Create a new node |
 | `rah_search_nodes` | Search nodes by keyword |
 | `rah_get_nodes` | Load nodes by ID |
 | `rah_update_node` | Update an existing node |
 | `rah_create_edge` | Create connection between nodes |
+| `rah_update_edge` | Update an edge explanation |
 | `rah_query_edges` | Find edges for a node |
 | `rah_list_dimensions` | List all dimensions |
 | `rah_create_dimension` | Create a dimension |
diff --git a/docs/8_mcp.md b/docs/8_mcp.md
index 8b0cc85..c924b33 100644
--- a/docs/8_mcp.md
+++ b/docs/8_mcp.md
@@ -25,9 +25,8 @@ Add this to your `~/.claude.json` (Claude Code) or Claude Desktop settings.
 
 **Requirements:**
 - Node.js 18+ installed
-- RA-OS run at least once (to create the database)
 
-**That's it.** No need to keep RA-OS running.
+**That's it.** The database is created automatically on first connection. No need to keep RA-OS running.
 
 ---
 
@@ -77,11 +76,13 @@ If you want real-time UI updates when nodes are created:
 
 | Tool | Description |
 |------|-------------|
+| `rah_get_context` | Get graph overview — stats, hub nodes, dimensions, recent activity. Called first automatically. |
 | `rah_add_node` | Create a new node (title/content/dimensions) |
-| `rah_search_nodes` | Search existing nodes |
+| `rah_search_nodes` | Search existing nodes by keyword |
 | `rah_update_node` | Update an existing node |
 | `rah_get_nodes` | Get nodes by ID |
 | `rah_create_edge` | Create relationship between nodes |
+| `rah_update_edge` | Update an edge explanation |
 | `rah_query_edges` | Query existing edges |
 | `rah_list_dimensions` | List all dimensions |
 | `rah_create_dimension` | Create a new dimension |
@@ -90,11 +91,25 @@ If you want real-time UI updates when nodes are created:
 
 ---
 
+## What to Expect
+
+Once connected, the MCP server instructs Claude to:
+
+1. **Call `rah_get_context` first** to understand your graph (hub nodes, dimensions, stats)
+2. **Proactively identify valuable information** in conversations and offer to save it
+3. **Search before creating** to avoid duplicates
+4. **Require edge explanations** — every connection needs a reason
+
+You don't need to ask Claude to use your knowledge base — it will offer when it spots something worth saving.
+
+---
+
 ## Example Usage
 
 Once connected, you can ask your AI assistant:
 
 ```
+"What's in my knowledge graph?"
 "Search RA-H for what I wrote about product strategy"
 "Add this conversation summary to RA-H as a new node"
 "Find all nodes with the 'research' dimension"
@@ -125,7 +140,7 @@ Once connected, you can ask your AI assistant:
 
 ### "Database not found"
 
-Run RA-OS at least once to create the database:
+The MCP server auto-creates the database on first connection (v1.1.0+). If you're on an older version, run RA-OS once to create it:
 ```bash
 npm run dev
 ```