From 69f0e59bf7888ea075ca4bf12e8ada83045a1f37 Mon Sep 17 00:00:00 2001
From: Andy Dalton <andalton@redhat.com>
Date: Fri, 27 Mar 2026 16:02:00 -0400
Subject: [PATCH 1/2] fix: correct installation docs and add missing build
 dependency

The Quick Start referenced a pre-built wheel (dist/mcp_acp-*.whl) that
doesn't exist after a fresh clone, and the Python version requirement
was listed as 3.10+ instead of the actual 3.12+. Reorganized the
Installation section to lead with the simplest path (pip install from
source), clarified audience for each install method, added a venv
fallback for PEP 668 systems with guidance on configuring MCP clients
to use the venv path, and added the missing `build` package to dev
dependencies so `make build` succeeds.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md      | 45 +++++++++++++++++++++++++++++++++++++++++----
 pyproject.toml |  1 +
 2 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 8d97b40..d179921 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,8 @@ A Model Context Protocol (MCP) server for managing Ambient Code Platform (ACP) s
 ```bash
 # Install
 git clone https://github.com/ambient-code/mcp
-pip install dist/mcp_acp-*.whl
+cd mcp
+pip install .    # installs the 'mcp-acp' command
 
 # Configure
 mkdir -p ~/.config/acp
@@ -113,23 +114,59 @@ List my ACP sessions
 
 ## Installation
 
+### From Source (end users)
+
+```bash
+git clone https://github.com/ambient-code/mcp
+cd mcp
+pip install .    # installs the 'mcp-acp' command
+```
+
 ### From Wheel
 
+Requires `make` to be installed.
+
 ```bash
+# "make install" sets up the dev environment (.venv + dependencies),
+# which "make build" then uses to produce the wheel in dist/
+make install
+make build
 pip install dist/mcp_acp-*.whl
 ```
 
-### From Source
+### Development Install (contributors)
 
 ```bash
 git clone https://github.com/ambient-code/mcp
 cd mcp
+uv venv
 uv pip install -e ".[dev]"
 ```
 
+### Virtual Environment Install
+
+On some Linux distributions (Debian, Ubuntu, Fedora 38+), [PEP 668](https://peps.python.org/pep-0668/)
+prevents `pip install` into the system Python. If you get an "externally-managed-environment" error,
+install into a virtual environment instead:
+
+```bash
+git clone https://github.com/ambient-code/mcp
+cd mcp
+python3 -m venv .venv
+source .venv/bin/activate
+pip install .
+```
+
+Note that the `mcp-acp` command will only be available inside the venv. To use it
+from an MCP client like Claude Code, reference the full path:
+
+```bash
+claude mcp add mcp-acp -t stdio /full/path/to/mcp/.venv/bin/mcp-acp
+```
+
 **Requirements:**
 
-- Python 3.10+
+- Python 3.12+
 - Bearer token for the ACP public-api gateway
 - Access to an ACP cluster
 
@@ -233,7 +270,7 @@ For a local wheel (before PyPI publish):
   "mcpServers": {
     "acp": {
       "command": "uvx",
-      "args": ["--from", "/full/path/to/dist/mcp_acp-0.1.0-py3-none-any.whl", "mcp-acp"]
+      "args": ["--from", "/full/path/to/dist/mcp_acp-0.3.0-py3-none-any.whl", "mcp-acp"]
     }
   }
 }
diff --git a/pyproject.toml b/pyproject.toml
index b447acb..6cc5c8e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -48,6 +48,7 @@ dev = [
     "mypy>=1.0.0",
     "pre-commit>=4.0.0",
     "bandit>=1.7.0",
+    "build>=1.0.0",
 ]
 
 [project.scripts]

From 3ba4e17fd8ef1a518215ea2425c03b96c355e956 Mon Sep 17 00:00:00 2001
From: Andy Dalton <andalton@redhat.com>
Date: Fri, 27 Mar 2026 16:08:09 -0400
Subject: [PATCH 2/2] fix: sync __init__.py version with pyproject.toml (0.3.0)

__init__.py was never updated when 0.3.0 was released in 95e83ee,
leaving __version__ at "0.1.0". Align it with pyproject.toml.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 src/mcp_acp/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/mcp_acp/__init__.py b/src/mcp_acp/__init__.py
index 832eaba..3a6917c 100644
--- a/src/mcp_acp/__init__.py
+++ b/src/mcp_acp/__init__.py
@@ -1,3 +1,3 @@
 """MCP ACP Server - Ambient Code Platform management via MCP."""
 
-__version__ = "0.1.0"
+__version__ = "0.3.0"