diff --git a/docs/0_overview.md b/docs/0_overview.md
index 9215efa..ab38187 100644
--- a/docs/0_overview.md
+++ b/docs/0_overview.md
@@ -62,14 +62,16 @@ RA-OS is designed to be the knowledge backend for your AI workflows:
 {
   "mcpServers": {
     "ra-h": {
-      "command": "node",
-      "args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
+      "command": "npx",
+      "args": ["ra-h-mcp-server"]
     }
   }
 }
 ```
 
-Available tools: `rah_add_node`, `rah_search_nodes`, `rah_update_node`, `rah_get_nodes`, `rah_create_edge`, `rah_query_edges`, `rah_update_edge`, `rah_create_dimension`, `rah_update_dimension`, `rah_delete_dimension`, `rah_search_embeddings`
+Add this to `~/.claude.json` and restart Claude. Works without RA-OS running.
+
+Available tools: `rah_add_node`, `rah_search_nodes`, `rah_update_node`, `rah_get_nodes`, `rah_create_edge`, `rah_query_edges`, `rah_list_dimensions`, `rah_create_dimension`, `rah_update_dimension`, `rah_delete_dimension`
 
 ## Documentation
 
diff --git a/docs/4_tools-and-guides.md b/docs/4_tools-and-guides.md
index 7d84ba2..35491e5 100644
--- a/docs/4_tools-and-guides.md
+++ b/docs/4_tools-and-guides.md
@@ -205,8 +205,9 @@ These tools are used by APIs and internal operations:
 
 | File | Purpose |
 |------|---------|
-| `apps/mcp-server/server.js` | HTTP MCP server |
-| `apps/mcp-server/stdio-server.js` | STDIO MCP server |
+| `apps/mcp-server-standalone/` | **Standalone MCP server (recommended)** |
+| `apps/mcp-server/server.js` | HTTP MCP server (requires app running) |
+| `apps/mcp-server/stdio-server.js` | STDIO bridge to HTTP server |
 | `src/tools/infrastructure/registry.ts` | Tool registry |
 | `src/services/guides/guideService.ts` | Guide management |
 | `src/config/guides/*.md` | Built-in guides |
diff --git a/docs/README.md b/docs/README.md
index fb89c0b..31b0daa 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -42,20 +42,20 @@ Open http://localhost:3000
 
 ## MCP Integration
 
-Add to your Claude Code config:
+Add to your `~/.claude.json`:
 
 ```json
 {
   "mcpServers": {
     "ra-h": {
-      "command": "node",
-      "args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
+      "command": "npx",
+      "args": ["ra-h-mcp-server"]
     }
   }
 }
 ```
 
-See [MCP docs](./8_mcp.md) for full setup.
+Works without RA-OS running. See [MCP docs](./8_mcp.md) for alternatives.
 
 ## Questions?