Improve MCP tool description and add version bump documentation

Author: gfraiteur

CLAUDE.md

@@ -73,4 +73,31 @@ Do NOT use the MCP server for:
 - File operations within the container
 - Reading files or exploring the codebase
 
-These operations should be done directly in the container using standard tools.
+These operations should be done directly in the container using standard tools.
+
+## Version Bumping
+
+Before scheduling a TeamCity build or deploy, the version must be bumped. This is done via the `VersionBump` build configuration on TeamCity.
+
+### How to Bump Version
+
+Use the MCP `ExecuteCommand` tool to trigger the VersionBump build via TeamCity API (requires `TEAMCITY_CLOUD_TOKEN` on host):
+
+```powershell
+$headers = @{
+    "Authorization" = "Bearer $env:TEAMCITY_CLOUD_TOKEN"
+    "Content-Type" = "application/json"
+    "Accept" = "application/json"
+}
+$body = @{
+    buildType = @{ id = "<ProjectPrefix>_VersionBump" }
+    branchName = "<branch>"
+} | ConvertTo-Json
+Invoke-RestMethod -Uri "https://postsharp.teamcity.com/app/rest/buildQueue" -Method Post -Headers $headers -Body $body
+```
+
+### Finding the Build Type ID
+
+1. Check `.teamcity/settings.kts` for the VCS root: `AbsoluteId("...")`
+2. The build type ID is: `<VcsRootId>_VersionBump`
+3. For this repo: `Engineering_PostSharpEngineering_VersionBump`

src/PostSharp.Engineering.BuildTools/Mcp/Tools/ExecuteCommandTool.cs

@@ -35,11 +35,11 @@ public ExecuteCommandTool(
     }
 
     [McpServerTool]
-    [Description( "Execute a command on the host machine. Requires human approval. Use this for git push, GitHub operations, and other actions that affect external systems." )]
+    [Description( "Execute a PowerShell command on the host machine. Requires human approval. Use this for git push, GitHub operations, and other actions that affect external systems or require privileges or tokens that the container does not have." )]
     public async Task<CommandResult> ExecuteCommand(
         [Description( "Unique session identifier for tracking command history" )]
         string sessionId,
-        [Description( "The command to execute (e.g., 'git push origin main')" )]
+        [Description( "The command to execute (e.g., 'git push origin main'). Must be valid PowerShell script." )]
         string command,
         [Description( "The working directory for command execution" )]
         string workingDirectory,