diff --git a/docs/src/content/docs/reference/tools.md b/docs/src/content/docs/reference/tools.md
index d234ecc278d..840843a79c2 100644
--- a/docs/src/content/docs/reference/tools.md
+++ b/docs/src/content/docs/reference/tools.md
@@ -134,8 +134,11 @@ Enables browser automation using containerized Playwright with domain-based acce
 tools:
   playwright:
     allowed_domains: ["defaults", "github", "*.custom.com"]  # Domain access
+    version: "1.56.1"  # Optional: pin version (defaults to 1.56.1)
 ```
 
+**Version Pinning**: Defaults to version 1.56.1 for stability. Set `version: "latest"` to use the latest version or specify a different version number.
+
 **Domain Access**: Uses same ecosystem bundles as `network:` configuration (`defaults`, `github`, `node`, `python`, etc.). Default is `["localhost", "127.0.0.1"]` for security. Supports wildcards like `*.example.com`.
 
 ## Custom MCP Servers (`mcp-servers:`)
diff --git a/docs/src/content/docs/setup/mcp-server.md b/docs/src/content/docs/setup/mcp-server.md
index 9aeea79ad30..39543a771f0 100644
--- a/docs/src/content/docs/setup/mcp-server.md
+++ b/docs/src/content/docs/setup/mcp-server.md
@@ -5,7 +5,7 @@ sidebar:
   order: 400
 ---
 
-The `gh aw mcp-server` command exposes CLI tools (status, compile, logs, audit, mcp-inspect) to AI agents through the Model Context Protocol.
+The `gh aw mcp-server` command exposes CLI tools (status, compile, logs, audit, update, add, mcp-inspect) to AI agents through the Model Context Protocol.
 
 Start the server:
 ```bash wrap
@@ -91,6 +91,7 @@ The MCP server provides:
 - **compile**: Generate GitHub Actions YAML
 - **logs**: Download with timeout handling and continuation
 - **audit**: Generate report to `/tmp/gh-aw/aw-mcp/logs`
+- **update**: Update workflows with support for major version updates and force flag
 - **add**: Install workflows from remote repositories
 - **mcp-inspect**: Inspect servers and validate secrets