@daghis/teamcity-mcp 2.8.0 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.10.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.9.0...teamcity-mcp-v2.10.0) (2026-04-26)
+
+
+### Features
+
+* **tools:** disclose principal return and primary error for mutators ([#484](https://github.com/Daghis/teamcity-mcp/issues/484)) ([0a4d747](https://github.com/Daghis/teamcity-mcp/commit/0a4d7479823f034b04d4623446f71b17b4b30d49))
+
+## [2.9.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.8.0...teamcity-mcp-v2.9.0) (2026-04-24)
+
+
+### Features
+
+* **tools:** unify tool descriptions under a single skeleton ([#479](https://github.com/Daghis/teamcity-mcp/issues/479)) ([19aa256](https://github.com/Daghis/teamcity-mcp/commit/19aa2565f21938639bd9d40f7b1c9cbb524d8e22))
+
 ## [2.8.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.7.0...teamcity-mcp-v2.8.0) (2026-04-24)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.8.0",
+  version: "2.10.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1278,7 +1278,6 @@ var package_default = {
     zod: "^4.3.5"
   },
   devDependencies: {
-    "@codecov/bundle-analyzer": "^2.0.1",
     "@esbuild-plugins/tsconfig-paths": "^0.1.2",
     "@eslint/js": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^6.0.1",
@@ -39230,7 +39229,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Test MCP server connectivity",
+    description: "Test MCP server connectivity. Returns a confirmation echo and optional message.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39258,7 +39257,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: false
     },
-    description: "Get current MCP mode. Dev mode: read-only tools for safe exploration. Full mode: all tools including admin operations.",
+    description: "Get the current MCP mode. Dev mode is read-only; full mode enables all operations.",
     inputSchema: {
       type: "object",
       properties: {}
@@ -39284,7 +39283,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: false
     },
-    description: "Switch MCP mode at runtime. Dev mode: safe read-only operations. Full mode: all operations including writes. Clients are notified of tool list changes.",
+    description: "Switch MCP mode at runtime. Returns previous and current modes with the updated tool count; idempotent and notifies clients of the list change.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39333,7 +39332,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List TeamCity projects (supports pagination)",
+    description: "List TeamCity projects. Supports pagination and locator filtering.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_projects,
     inputSchema: {
       type: "object",
@@ -39407,7 +39406,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get details of a specific project",
+    description: "Get details of a specific project.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_project,
     inputSchema: {
       type: "object",
@@ -39439,7 +39438,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List TeamCity builds (supports pagination)",
+    description: "List TeamCity builds. Supports pagination and locator filtering.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_builds,
     inputSchema: {
       type: "object",
@@ -39534,7 +39533,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get details of a specific build (works for both queued and running/finished builds)",
+    description: "Get details of a specific build. Works for queued, running, and finished builds.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build,
     inputSchema: {
       type: "object",
@@ -39580,7 +39579,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Trigger a new build",
+    description: "Trigger a new build; runs asynchronously, use `wait_for_build` to monitor. Returns the queued build id; returns 404 if buildTypeId is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39701,7 +39700,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Cancel a queued build by ID",
+    description: "Cancel a queued (not-yet-running) build. Idempotent; returns 404 if the build already started or was cancelled.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39732,7 +39731,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Cancel or stop a running (or queued) build by ID. Supports an optional comment and requeue flag.",
+    description: "Cancel or stop a running or queued build, with optional comment and requeue flag. Returns the cancelled build; returns 404 if the build is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39784,7 +39783,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get build status with optional test/problem and queue context details",
+    description: "Get build status. Optionally includes test and problem summaries plus queue context.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_status,
     inputSchema: {
       type: "object",
@@ -39887,7 +39886,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Wait for a build to complete by polling until it reaches a terminal state (finished, canceled, failed) or timeout",
+    description: "Wait for a build to reach a terminal state (finished, canceled, failed). Long-running; polls until completion or timeout.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39982,7 +39981,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Fetch build log with pagination (by lines)",
+    description: "Fetch a build log. Supports line-based pagination and streaming output.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40242,7 +40241,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List build configurations (supports pagination)",
+    description: "List build configurations. Supports pagination and locator filtering.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_build_configs,
     inputSchema: {
       type: "object",
@@ -40316,7 +40315,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get details of a build configuration",
+    description: "Get details of a build configuration.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_config,
     inputSchema: {
       type: "object",
@@ -40348,7 +40347,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List test failures for a build (supports pagination)",
+    description: "List test failures for a build. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40416,7 +40415,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List VCS roots (supports pagination)",
+    description: "List VCS roots. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40487,7 +40486,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get details of a VCS root (including properties)",
+    description: "Get details of a VCS root, including its properties.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40525,7 +40524,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Set a single VCS root property (e.g., branch, branchSpec, url)",
+    description: "Set a single VCS root property such as branch, branchSpec, or url. Returns the updated value; returns 404 if the VCS root or property is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40569,7 +40568,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a single VCS root property",
+    description: "Delete a single VCS root property. Idempotent; returns 404 if the VCS root is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40606,7 +40605,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update common VCS root properties in one call",
+    description: "Update common VCS root properties in a single call. Returns the updated VCS root; returns 404 if the VCS root is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40682,7 +40681,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List queued builds (supports TeamCity queue locator + pagination)",
+    description: "List queued builds. Supports TeamCity queue locator filtering and pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40756,7 +40755,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Fetch server metrics (CPU/memory/disk/load) if available",
+    description: "Fetch TeamCity server metrics (CPU, memory, disk, load) when available.",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
       return runTool(
@@ -40780,7 +40779,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get TeamCity server info (version, build number, state)",
+    description: "Get TeamCity server info including version, build number, and state.",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
       return runTool(
@@ -40803,7 +40802,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List server health items (warnings/errors) for readiness checks",
+    description: "List server health items (warnings and errors). Useful for readiness checks.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40874,7 +40873,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get a single server health item by locator",
+    description: "Get a single server health item by locator.",
     inputSchema: {
       type: "object",
       properties: { locator: { type: "string", description: "Health item locator" } },
@@ -40904,7 +40903,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Evaluate server health; returns ok=false if critical health items found (severity ERROR)",
+    description: "Evaluate server health. Returns ok=false when any ERROR-severity items are present.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40942,7 +40941,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get build types compatible with the specified agent",
+    description: "List build types compatible with the specified agent.",
     inputSchema: {
       type: "object",
       properties: { agentId: { type: "string", description: "Agent ID" } },
@@ -40971,7 +40970,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get build types incompatible with the specified agent",
+    description: "List build types incompatible with the specified agent.",
     inputSchema: {
       type: "object",
       properties: { agentId: { type: "string", description: "Agent ID" } },
@@ -41000,7 +40999,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get the enabled/disabled state for an agent, including comment and switch time",
+    description: "Get an agent's enabled/disabled state, including comment and switch time.",
     inputSchema: {
       type: "object",
       properties: { agentId: { type: "string", description: "Agent ID" } },
@@ -41029,7 +41028,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List agents compatible with a build type (optionally filter enabled only)",
+    description: "List agents compatible with a build type. Optionally filters to enabled agents only.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41070,7 +41069,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Return only the count of enabled compatible agents for a build type",
+    description: "Count enabled agents compatible with a build type.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41112,7 +41111,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List agents compatible with a queued/running build by buildId (optionally filter enabled only)",
+    description: "List agents compatible with a queued or running build. Optionally filters to enabled agents only.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41156,7 +41155,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Check connectivity to TeamCity server and basic readiness",
+    description: "Check connectivity and basic readiness of the TeamCity server.",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
       const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
@@ -41174,7 +41173,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List build agents (supports pagination)",
+    description: "List build agents. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41241,7 +41240,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List agent pools (supports pagination)",
+    description: "List agent pools. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41310,7 +41309,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get detailed results of a build including tests, artifacts, changes, and statistics",
+    description: "Get detailed results of a build. Optionally includes tests, artifacts, changes, statistics, and dependencies.",
     outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_results,
     inputSchema: {
       type: "object",
@@ -41433,7 +41432,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Download a single artifact with optional streaming output",
+    description: "Download a single build artifact, with base64, text, or streaming output. Returns the artifact bytes or stream metadata; returns 404 if the build or path is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41501,7 +41500,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Download multiple artifacts with optional streaming output",
+    description: "Download multiple build artifacts, with base64, text, or streaming output. Returns per-artifact payloads or stream metadata; returns 404 if the build or any path is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41669,7 +41668,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get detailed information about test failures",
+    description: "Get detailed information about test failures.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41706,7 +41705,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Analyze and report build problems and failures",
+    description: "Analyze and report build problems and failures.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41744,7 +41743,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List VCS changes (supports pagination)",
+    description: "List VCS changes. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41820,7 +41819,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List build problems (supports pagination)",
+    description: "List build problems. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41896,7 +41895,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List problem occurrences (supports pagination)",
+    description: "List build problem occurrences. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41978,7 +41977,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List open investigations (supports pagination)",
+    description: "List open investigations. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42067,7 +42066,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List muted tests (supports pagination)",
+    description: "List muted tests. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42149,7 +42148,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Get Versioned Settings status for a locator",
+    description: "Get Versioned Settings status for a project locator.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42193,7 +42192,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List TeamCity users (supports pagination)",
+    description: "List TeamCity users. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42264,7 +42263,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List defined roles and their permissions",
+    description: "List defined roles and their permissions.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42298,7 +42297,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List branches for a project or build configuration",
+    description: "List branches for a project or build configuration.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42338,7 +42337,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List parameters for a build configuration",
+    description: "List parameters for a build configuration.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42371,7 +42370,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List project hierarchy showing parent-child relationships",
+    description: "List project hierarchy showing parent-child relationships.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42427,7 +42426,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new TeamCity project",
+    description: "Create a new TeamCity project. Returns the created project (id and name); returns 409 if a project with the same id already exists.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42474,7 +42473,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a TeamCity project",
+    description: "Delete a TeamCity project. Irreversible; returns 404 if the project does not exist.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42498,7 +42497,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update project settings and parameters",
+    description: "Update project settings and parameters. Returns the updated project; returns 404 if the project does not exist.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42594,7 +42593,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new build configuration",
+    description: "Create a new build configuration. Returns the created configuration (id and name); returns 409 if a configuration with the same id already exists.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42629,7 +42628,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Clone an existing build configuration",
+    description: "Clone an existing build configuration. Returns the new configuration (id and name); returns 404 if the source configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42729,7 +42728,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update build configuration settings",
+    description: "Update build configuration settings. Returns the updated configuration; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42828,7 +42827,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete artifact and snapshot dependencies for a build configuration",
+    description: "Add, update, or delete artifact and snapshot dependencies for a build configuration. Returns the affected dependency or a delete confirmation; returns 404 if the configuration or dependency id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42976,7 +42975,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build features such as ssh-agent or requirements enforcement",
+    description: "Add, update, or delete build features such as ssh-agent or requirements enforcement. Returns the affected feature or a delete confirmation; returns 404 if the configuration or feature id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43089,7 +43088,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build agent requirements for a configuration",
+    description: "Add, update, or delete agent requirements for a build configuration. Returns the affected requirement or a delete confirmation; returns 404 if the configuration or requirement id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43241,7 +43240,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Enable or disable a build configuration by toggling its paused flag",
+    description: "Enable or disable a build configuration by toggling its paused flag. Returns the new paused state; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43292,7 +43291,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Attach a VCS root to a build configuration",
+    description: "Attach a VCS root to a build configuration. Returns the attached VCS root entry; returns 404 if the configuration or VCS root is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43346,7 +43345,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add a parameter to a build configuration",
+    description: "Add a parameter to a build configuration. Returns the created parameter; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43393,7 +43392,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update a build configuration parameter",
+    description: "Update a build configuration parameter. Returns the updated parameter; returns 404 if the configuration or parameter name is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43441,7 +43440,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a parameter from a build configuration",
+    description: "Delete a parameter from a build configuration. Idempotent; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43475,7 +43474,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List parameters for a project",
+    description: "List parameters for a project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43502,7 +43501,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add a parameter to a project",
+    description: "Add a parameter to a project. Returns the created parameter; returns 404 if the project does not exist.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43551,7 +43550,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update a project parameter",
+    description: "Update a project parameter. Returns the updated parameter; returns 404 if the project or parameter name is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43599,7 +43598,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a parameter from a project",
+    description: "Delete a parameter from a project. Idempotent; returns 404 if the project does not exist.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43630,7 +43629,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List output parameters for a build configuration",
+    description: "List output parameters for a build configuration.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43657,7 +43656,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add an output parameter to a build configuration (for build chains)",
+    description: "Add an output parameter to a build configuration; used to pass values between builds in a chain. Returns the created parameter; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43697,7 +43696,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update an output parameter in a build configuration",
+    description: "Update an output parameter in a build configuration. Returns the updated parameter; returns 404 if the configuration or parameter name is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43737,7 +43736,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete an output parameter from a build configuration",
+    description: "Delete an output parameter from a build configuration. Idempotent; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43771,7 +43770,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new VCS root",
+    description: "Create a new VCS root. Returns the created VCS root id; returns 409 if a VCS root with the same id already exists.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43815,7 +43814,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Authorize or unauthorize a build agent",
+    description: "Authorize or unauthorize a build agent. Returns the new authorization state; returns 404 if the agent is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43850,7 +43849,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Assign an agent to a different pool",
+    description: "Assign an agent to a different pool. Returns the agent's new pool assignment; returns 404 if the agent or pool is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43882,7 +43881,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Remove (delete) a build agent from the TeamCity server. Use this to clean up disconnected or ghost agent entries.",
+    description: "Remove a build agent from the TeamCity server, useful for cleaning up disconnected or ghost agent entries. Idempotent; returns 404 if the agent is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43907,7 +43906,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build steps",
+    description: "Add, update, or delete build steps. Returns the affected step or a delete confirmation; returns 404 if the configuration or step id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44106,7 +44105,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build triggers",
+    description: "Add, update, or delete build triggers. Returns the affected trigger or a delete confirmation; returns 404 if the configuration or trigger id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44179,7 +44178,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Set paused/unpaused for a list of build configurations; optionally cancel queued",
+    description: "Pause or unpause a list of build configurations, optionally cancelling their queued builds. Returns the count of configurations updated; returns 404 if any configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44246,7 +44245,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Mute tests within a project or build configuration scope",
+    description: "Mute tests within a project or build configuration scope. Returns the created mute id; returns 404 if the scope id is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44343,7 +44342,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Move a queued build to the top of the queue",
+    description: "Move a queued build to the top of the queue. Idempotent; returns 404 if the build is no longer queued.",
     inputSchema: {
       type: "object",
       properties: { buildId: { type: "string", description: "Queued build ID" } },
@@ -44378,7 +44377,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Reorder queued builds by providing the desired sequence of IDs",
+    description: "Reorder queued builds by providing the desired sequence of IDs. Returns the new queue order; returns 404 if any build id is no longer queued.",
     inputSchema: {
       type: "object",
       properties: { buildIds: { type: "array", items: { type: "string" } } },
@@ -44413,7 +44412,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Cancel all queued builds for a specific build configuration",
+    description: "Cancel all queued builds for a specific build configuration. Returns the count of cancelled builds; returns 404 if the configuration is unknown.",
     inputSchema: {
       type: "object",
       properties: { buildTypeId: { type: "string", description: "Build type ID" } },
@@ -44455,7 +44454,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Cancel all queued builds matching a queue locator expression",
+    description: "Cancel all queued builds matching a queue locator expression. Returns the count of cancelled builds; returns 400 if the locator is malformed.",
     inputSchema: {
       type: "object",
       properties: { locator: { type: "string", description: "Queue locator expression" } },
@@ -44497,7 +44496,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Disable all agents in a pool to pause queue processing; optionally cancel queued builds for a build type",
+    description: "Pause queue processing by disabling all agents in a pool, optionally cancelling queued builds for a build type. Returns counts of agents disabled and builds cancelled; returns 404 if the pool is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44575,7 +44574,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Re-enable all agents in a pool to resume queue processing",
+    description: "Resume queue processing by re-enabling all agents in a pool. Returns the count of agents re-enabled; returns 404 if the pool is unknown.",
     inputSchema: {
       type: "object",
       properties: { poolId: { type: "string", description: "Agent pool ID" } },
@@ -44625,7 +44624,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Enable/disable an agent, with optional comment and schedule",
+    description: "Enable or disable an agent, with optional comment and schedule. Returns the new enabled state; returns 404 if the agent is unknown.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44677,7 +44676,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Bulk enable/disable agents selected by pool or locator; supports comment/schedule",
+    description: "Bulk enable or disable agents selected by pool or locator, with optional comment and schedule. Returns counts of agents updated and skipped; returns 404 if the pool is unknown or 400 if the locator is malformed.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44770,7 +44769,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List SSH keys configured for a project",
+    description: "List SSH keys configured for a project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44802,7 +44801,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Upload an SSH key to a project. Provide either privateKeyContent (raw PEM string) or privateKeyPath (path to key file), but not both.",
+    description: "Upload an SSH key to a project; provide either privateKeyContent or privateKeyPath, not both. Returns the uploaded key's name; returns 404 if the project does not exist.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44852,7 +44851,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete an SSH key from a project",
+    description: "Delete an SSH key from a project. Idempotent; returns 404 if the project or key is unknown.",
     inputSchema: {
       type: "object",
       properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -73,7 +73,6 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@codecov/bundle-analyzer": "^2.0.1",
     "@esbuild-plugins/tsconfig-paths": "^0.1.2",
     "@eslint/js": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^6.0.1",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/Daghis/teamcity-mcp",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.8.0",
+      "version": "2.10.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {