From bb57a76cb6be6c7c66086e930c881fc3e4ced3ed Mon Sep 17 00:00:00 2001
From: geobelsky <geobelsky@gmail.com>
Date: Wed, 29 Apr 2026 12:02:38 +0000
Subject: [PATCH] docs(README): add 'Works With Any MCP Client' section
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Surfaces multi-client support (Cursor/Windsurf/Cline/Claude Desktop/any
MCP client) in the main README. Previously only documented in
docs/MULTI_CLIENT.md. Adds compatibility matrix, the universal MCP
server entry snippet, and per-client config-file paths. Notes that
hooks are Claude Code-specific while MCP tools work everywhere.

Builds on the existing docs/MULTI_CLIENT.md — README links there for
full per-client setup, hook workarounds, and concurrent-client
semantics.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/README.md b/README.md
index 1010db9..b66e999 100644
--- a/README.md
+++ b/README.md
@@ -185,6 +185,44 @@ AXME Code complements CLAUDE.md — it reads your existing CLAUDE.md during setu
 
 ---
 
+## Works With Any MCP Client
+
+AXME Code is a [stdio MCP server](https://modelcontextprotocol.io/) — every MCP-compatible AI coding assistant gets the full set of `axme_*` tools (knowledge base read/write, safety queries, status, worklog).
+
+| Client | MCP Tools | Safety Hooks | Auto Auditor |
+|---|---|---|---|
+| **Claude Code** (CLI / VS Code) | ✅ Full | ✅ Full | ✅ Yes |
+| **Cursor** | ✅ Full | ❌ | ❌ |
+| **Windsurf** | ✅ Full | ❌ | ❌ |
+| **Cline** (VS Code) | ✅ Full | ❌ | ❌ |
+| **Claude Desktop** | ✅ Full | ❌ | ❌ |
+| **Any other MCP client** | ✅ Full | ❌ | ❌ |
+
+The MCP server entry is identical in every client:
+
+```json
+{
+  "mcpServers": {
+    "axme": {
+      "command": "axme-code",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Just place it in your client's MCP config file:
+- **Cursor:** `~/.cursor/mcp.json` or `.cursor/mcp.json` (per-project)
+- **Windsurf:** `~/.codeium/windsurf/mcp_config.json`
+- **Cline:** VS Code Settings → Cline MCP → `cline_mcp_settings.json`
+- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or equivalent
+
+Pre-execution safety hooks, the post-tool-use file tracker, and the background session auditor are Claude Code-specific (they require Claude Code's hook system). In other clients, the agent must call AXME tools explicitly — same knowledge base, same `.axme-code/` storage, just no automatic enforcement layer.
+
+See [docs/MULTI_CLIENT.md](docs/MULTI_CLIENT.md) for full per-client setup, hook workarounds, and concurrent-client semantics.
+
+---
+
 ## Comparison
 
 | | AXME Code | MemPalace | Mastra | Zep | Mem0 | Supermemory |