@daghis/teamcity-mcp 2.9.0 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.9.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",
@@ -39284,7 +39283,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: false
     },
-    description: "Switch MCP mode at runtime. Clients are notified when the 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: {
@@ -39580,7 +39579,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Trigger a new build. Returns the queued build id; the build runs asynchronously, use `wait_for_build` to monitor.",
+    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: {
@@ -39732,7 +39731,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Cancel or stop a running or queued build. 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: {
@@ -40525,7 +40524,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Set a single VCS root property such as branch, branchSpec, or 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 a single 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: {
@@ -41433,7 +41432,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Download a single build artifact. Supports base64, text, or 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 build artifacts. Supports base64, text, or 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: {
@@ -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 agent requirements for a build 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: {
@@ -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: {
@@ -43657,7 +43656,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add an output parameter to a build configuration. Used to pass values between builds in a chain.",
+    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 a build agent from the TeamCity server. Useful for cleaning 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: "Pause or unpause a list of build configurations. Optionally cancels their queued builds.",
+    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: "Pause queue processing by disabling all agents in a pool. Optionally cancels 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: "Resume queue processing by re-enabling all agents in a pool.",
+    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 or disable an agent. Supports 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 or disable agents selected by pool or locator. Supports optional comment and 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: {
@@ -44802,7 +44801,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Upload an SSH key to a project. Provide either privateKeyContent or privateKeyPath, 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.9.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.9.0",
+  "version": "2.10.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.9.0",
+      "version": "2.10.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {