From 6095ef0fd5d54be1ca2ceb084dc6afe37996bfa0 Mon Sep 17 00:00:00 2001
From: Steve Yegge <steve.yegge@gmail.com>
Date: Tue, 14 Oct 2025 18:36:13 -0700
Subject: [PATCH] docs: Add MCP server installation section to README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Added clear installation instructions for users of Sourcegraph Amp, Claude Desktop,
and other MCP clients right after the Claude Code plugin section.

Users can now easily find instructions to install via:
- uv tool install beads-mcp
- pip install beads-mcp

Includes Claude Desktop configuration example and link to detailed MCP server docs.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

diff --git a/README.md b/README.md
index f12ff5a5..eb9b6f8d 100644
--- a/README.md
+++ b/README.md
@@ -134,6 +134,40 @@ Thanks to [@v4rgas](https://github.com/v4rgas) for maintaining the AUR package!
 
 See [PLUGIN.md](PLUGIN.md) for complete plugin documentation.
 
+### MCP Server (For Sourcegraph Amp, Claude Desktop, and other MCP clients)
+
+If you're using an MCP-compatible tool other than Claude Code, you can install the beads MCP server:
+
+```bash
+# Using uv (recommended)
+uv tool install beads-mcp
+
+# Or using pip
+pip install beads-mcp
+```
+
+Then add to your MCP client configuration. For Claude Desktop, add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "beads": {
+      "command": "beads-mcp"
+    }
+  }
+}
+```
+
+For other MCP clients, refer to their documentation for how to configure MCP servers.
+
+**What you get:**
+- Full bd functionality exposed via MCP protocol
+- Tools for creating, updating, listing, and closing issues
+- Ready work detection and dependency management
+- All without requiring Bash commands
+
+See [integrations/beads-mcp/README.md](integrations/beads-mcp/README.md) for detailed MCP server documentation.
+
 #### Windows 11
 For Windows you must build from source.
 Assumes git, go-lang and mingw-64 installed and in path.