@daghis/teamcity-mcp 2.7.0 → 2.9.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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)
+
+
+### Features
+
+* **tools:** declare outputSchema for first batch of read tools ([#477](https://github.com/Daghis/teamcity-mcp/issues/477)) ([932fee9](https://github.com/Daghis/teamcity-mcp/commit/932fee9e09988555cda13b8f7282128de8a7e3f5))
+
 ## [2.7.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.6.3...teamcity-mcp-v2.7.0) (2026-04-23)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.7.0",
+  version: "2.9.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1287,6 +1287,8 @@ var package_default = {
     "@types/node": "^25.0.2",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
     "@typescript-eslint/parser": "^8.58.0",
+    ajv: "^8.18.0",
+    "ajv-formats": "^3.0.1",
     esbuild: "^0.28.0",
     eslint: "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
@@ -4605,13 +4607,19 @@ async function runTool(toolName, schema, handler, rawArgs, context) {
     );
     if (err instanceof import_zod3.z.ZodError) {
       const formatted2 = formatError(err, { ...context, requestId: reqId });
-      return json(formatted2);
+      const response2 = json(formatted2);
+      response2.success = false;
+      response2.error = msg;
+      return response2;
     }
     const formatted = globalErrorHandler.handleToolError(err, toolName, {
       ...context,
       requestId: reqId
     });
-    return json(formatted);
+    const response = json(formatted);
+    response.success = false;
+    response.error = msg;
+    return response;
   }
 }
 
@@ -39052,6 +39060,163 @@ var downloadArtifactByUrl = async (adapter, request, encoding, options) => {
   };
   return buildArtifactPayload(artifact, "base64", options);
 };
+var paginationMetaSchema = {
+  type: "object",
+  description: "Pagination metadata describing which slice was returned.",
+  additionalProperties: true,
+  properties: {
+    page: { type: "number" },
+    pageSize: { type: "number" },
+    mode: { type: "string", enum: ["all"] },
+    fetched: { type: "number" }
+  }
+};
+var buildObjectSchema = {
+  type: "object",
+  description: "TeamCity build representation.",
+  additionalProperties: true,
+  properties: {
+    id: { type: ["number", "string"] },
+    buildTypeId: { type: "string" },
+    number: { type: "string" },
+    state: { type: "string" },
+    status: { type: "string" },
+    statusText: { type: "string" },
+    branchName: { type: "string" },
+    href: { type: "string" },
+    webUrl: { type: "string" }
+  }
+};
+var projectObjectSchema = {
+  type: "object",
+  description: "TeamCity project representation.",
+  additionalProperties: true,
+  properties: {
+    id: { type: "string" },
+    name: { type: "string" },
+    parentProjectId: { type: "string" },
+    href: { type: "string" },
+    webUrl: { type: "string" },
+    archived: { type: "boolean" },
+    description: { type: "string" }
+  }
+};
+var buildTypeObjectSchema = {
+  type: "object",
+  description: "TeamCity build configuration (buildType) representation.",
+  additionalProperties: true,
+  properties: {
+    id: { type: "string" },
+    name: { type: "string" },
+    projectId: { type: "string" },
+    projectName: { type: "string" },
+    href: { type: "string" },
+    webUrl: { type: "string" },
+    paused: { type: "boolean" },
+    description: { type: "string" }
+  }
+};
+var listOutputSchema = (itemSchema) => ({
+  type: "object",
+  additionalProperties: false,
+  required: ["items", "pagination"],
+  properties: {
+    items: { type: "array", items: itemSchema },
+    pagination: paginationMetaSchema
+  }
+});
+var buildStatusOutputSchema = {
+  type: "object",
+  description: "Aggregated status for a queued, running, or finished build.",
+  additionalProperties: true,
+  required: ["buildId", "state", "percentageComplete"],
+  properties: {
+    buildId: { type: "string" },
+    buildNumber: { type: "string" },
+    buildTypeId: { type: "string" },
+    state: { type: "string", enum: ["queued", "running", "finished", "failed", "canceled"] },
+    status: { type: "string", enum: ["SUCCESS", "FAILURE", "ERROR", "UNKNOWN"] },
+    statusText: { type: "string" },
+    percentageComplete: { type: "number" },
+    currentStageText: { type: "string" },
+    branchName: { type: "string" },
+    webUrl: { type: "string" },
+    queuedDate: { type: "string" },
+    startDate: { type: "string" },
+    finishDate: { type: "string" },
+    elapsedSeconds: { type: "number" },
+    estimatedTotalSeconds: { type: "number" },
+    estimatedStartTime: { type: "string" },
+    queuePosition: { type: "number" },
+    waitReason: { type: "string" },
+    failureReason: { type: "string" },
+    canceledBy: { type: "string" },
+    canceledDate: { type: "string" },
+    totalQueued: { type: "number" },
+    canMoveToTop: { type: "boolean" },
+    testSummary: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        total: { type: "number" },
+        passed: { type: "number" },
+        failed: { type: "number" },
+        ignored: { type: "number" },
+        muted: { type: "number" },
+        newFailed: { type: "number" }
+      }
+    },
+    problems: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: true,
+        properties: {
+          type: { type: "string" },
+          identity: { type: "string" },
+          description: { type: "string" }
+        }
+      }
+    }
+  }
+};
+var buildResultsOutputSchema = {
+  type: "object",
+  description: "Rich build result bundle assembled by BuildResultsManager. The core build summary is always under `build`; optional sections (artifacts, statistics, changes, dependencies) are present when requested via the corresponding include* flags.",
+  additionalProperties: true,
+  required: ["build"],
+  properties: {
+    build: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        id: { type: ["string", "number"] },
+        number: { type: "string" },
+        status: { type: "string" },
+        state: { type: "string" },
+        buildTypeId: { type: "string" },
+        projectId: { type: "string" },
+        branchName: { type: "string" },
+        statusText: { type: "string" },
+        webUrl: { type: "string" }
+      }
+    },
+    artifacts: { type: "array", items: { type: "object", additionalProperties: true } },
+    statistics: { type: "object", additionalProperties: true },
+    changes: { type: "array", items: { type: "object", additionalProperties: true } },
+    dependencies: { type: "array", items: { type: "object", additionalProperties: true } }
+  }
+};
+var FIRST_BATCH_OUTPUT_SCHEMAS = {
+  list_builds: listOutputSchema(buildObjectSchema),
+  get_build: buildObjectSchema,
+  get_build_status: buildStatusOutputSchema,
+  get_build_results: buildResultsOutputSchema,
+  list_projects: listOutputSchema(projectObjectSchema),
+  get_project: projectObjectSchema,
+  list_build_configs: listOutputSchema(buildTypeObjectSchema),
+  get_build_config: buildTypeObjectSchema
+};
 function getMCPMode2() {
   return getMCPMode();
 }
@@ -39065,7 +39230,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: {
@@ -39093,7 +39258,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: {}
@@ -39119,7 +39284,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. Clients are notified when the tool list changes.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39168,7 +39333,8 @@ 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",
       properties: {
@@ -39241,7 +39407,8 @@ 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",
       properties: {
@@ -39272,7 +39439,8 @@ 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",
       properties: {
@@ -39366,7 +39534,8 @@ 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",
       properties: {
@@ -39411,7 +39580,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Trigger a new build",
+    description: "Trigger a new build. Returns the queued build id; the build runs asynchronously, use `wait_for_build` to monitor.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39532,7 +39701,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: {
@@ -39563,7 +39732,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. Supports an optional comment and requeue flag.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39615,7 +39784,8 @@ 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",
       properties: {
@@ -39717,7 +39887,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: {
@@ -39812,7 +39982,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: {
@@ -40072,7 +40242,8 @@ 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",
       properties: {
@@ -40145,7 +40316,8 @@ 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",
       properties: {
@@ -40176,7 +40348,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: {
@@ -40244,7 +40416,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List VCS roots (supports pagination)",
+    description: "List VCS roots. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40315,7 +40487,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: {
@@ -40353,7 +40525,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40397,7 +40569,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a single VCS root property",
+    description: "Delete a single VCS root property.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40434,7 +40606,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40510,7 +40682,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: {
@@ -40584,7 +40756,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(
@@ -40608,7 +40780,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(
@@ -40631,7 +40803,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: {
@@ -40702,7 +40874,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" } },
@@ -40732,7 +40904,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: {
@@ -40770,7 +40942,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" } },
@@ -40799,7 +40971,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" } },
@@ -40828,7 +41000,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" } },
@@ -40857,7 +41029,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: {
@@ -40898,7 +41070,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: {
@@ -40940,7 +41112,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: {
@@ -40984,7 +41156,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());
@@ -41002,7 +41174,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List build agents (supports pagination)",
+    description: "List build agents. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41069,7 +41241,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List agent pools (supports pagination)",
+    description: "List agent pools. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41138,7 +41310,8 @@ 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",
       properties: {
@@ -41260,7 +41433,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Download a single artifact with optional streaming output",
+    description: "Download a single build artifact. Supports base64, text, or streaming output.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41328,7 +41501,7 @@ var DEV_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Download multiple artifacts with optional streaming output",
+    description: "Download multiple build artifacts. Supports base64, text, or streaming output.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41496,7 +41669,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: {
@@ -41533,7 +41706,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: {
@@ -41571,7 +41744,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List VCS changes (supports pagination)",
+    description: "List VCS changes. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41647,7 +41820,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List build problems (supports pagination)",
+    description: "List build problems. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41723,7 +41896,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: {
@@ -41805,7 +41978,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List open investigations (supports pagination)",
+    description: "List open investigations. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41894,7 +42067,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List muted tests (supports pagination)",
+    description: "List muted tests. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -41976,7 +42149,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: {
@@ -42020,7 +42193,7 @@ var DEV_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "List TeamCity users (supports pagination)",
+    description: "List TeamCity users. Supports pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42091,7 +42264,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: {
@@ -42125,7 +42298,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: {
@@ -42165,7 +42338,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: {
@@ -42198,7 +42371,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: {
@@ -42254,7 +42427,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new TeamCity project",
+    description: "Create a new TeamCity project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42301,7 +42474,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a TeamCity project",
+    description: "Delete a TeamCity project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42325,7 +42498,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update project settings and parameters",
+    description: "Update project settings and parameters.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42421,7 +42594,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new build configuration",
+    description: "Create a new build configuration.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42456,7 +42629,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Clone an existing build configuration",
+    description: "Clone an existing build configuration.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42556,7 +42729,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update build configuration settings",
+    description: "Update build configuration settings.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42655,7 +42828,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42803,7 +42976,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -42916,7 +43089,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43068,7 +43241,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43119,7 +43292,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43173,7 +43346,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43220,7 +43393,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update a build configuration parameter",
+    description: "Update a build configuration parameter.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43268,7 +43441,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43302,7 +43475,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: {
@@ -43329,7 +43502,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add a parameter to a project",
+    description: "Add a parameter to a project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43378,7 +43551,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Update a project parameter",
+    description: "Update a project parameter.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43426,7 +43599,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Delete a parameter from a project",
+    description: "Delete a parameter from a project.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43457,7 +43630,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: {
@@ -43484,7 +43657,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43524,7 +43697,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43564,7 +43737,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43598,7 +43771,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: false,
       openWorldHint: true
     },
-    description: "Create a new VCS root",
+    description: "Create a new VCS root.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43642,7 +43815,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Authorize or unauthorize a build agent",
+    description: "Authorize or unauthorize a build agent.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43677,7 +43850,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43709,7 +43882,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43734,7 +43907,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build steps",
+    description: "Add, update, or delete build steps.",
     inputSchema: {
       type: "object",
       properties: {
@@ -43933,7 +44106,7 @@ var FULL_MODE_TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     },
-    description: "Add, update, or delete build triggers",
+    description: "Add, update, or delete build triggers.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44006,7 +44179,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 cancels their queued builds.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44073,7 +44246,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44170,7 +44343,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.",
     inputSchema: {
       type: "object",
       properties: { buildId: { type: "string", description: "Queued build ID" } },
@@ -44205,7 +44378,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.",
     inputSchema: {
       type: "object",
       properties: { buildIds: { type: "array", items: { type: "string" } } },
@@ -44240,7 +44413,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.",
     inputSchema: {
       type: "object",
       properties: { buildTypeId: { type: "string", description: "Build type ID" } },
@@ -44282,7 +44455,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.",
     inputSchema: {
       type: "object",
       properties: { locator: { type: "string", description: "Queue locator expression" } },
@@ -44324,7 +44497,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 cancels queued builds for a build type.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44402,7 +44575,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.",
     inputSchema: {
       type: "object",
       properties: { poolId: { type: "string", description: "Agent pool ID" } },
@@ -44452,7 +44625,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. Supports optional comment and schedule.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44504,7 +44677,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. Supports optional comment and schedule.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44597,7 +44770,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: {
@@ -44629,7 +44802,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44679,7 +44852,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.",
     inputSchema: {
       type: "object",
       properties: {
@@ -44720,6 +44893,18 @@ function getTool(name) {
 }
 
 // src/server.ts
+function parseStructuredContent(content) {
+  const first = content[0];
+  if (first?.type !== "text" || typeof first.text !== "string") return void 0;
+  try {
+    const parsed = JSON.parse(first.text);
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+  }
+  return void 0;
+}
 function createSimpleServer() {
   const _config = getConfig();
   getAvailableTools();
@@ -44746,7 +44931,8 @@ function createSimpleServer() {
         name: tool.name,
         description: tool.description,
         inputSchema: tool.inputSchema,
-        annotations: tool.annotations
+        annotations: tool.annotations,
+        ...tool.outputSchema ? { outputSchema: tool.outputSchema } : {}
       }))
     };
     debug2("MCP response: tools/list", { count: response.tools.length, success: true });
@@ -44771,11 +44957,16 @@ function createSimpleServer() {
     }
     try {
       const result = await tool.handler(args ?? {});
-      const response = {
-        content: result.content ?? [
-          { type: "text", text: result.error ?? "Tool executed successfully" }
-        ]
-      };
+      const content = result.content ?? [
+        { type: "text", text: result.error ?? "Tool executed successfully" }
+      ];
+      const response = { content };
+      if (tool.outputSchema && result.success !== false) {
+        const structured = parseStructuredContent(content);
+        if (structured !== void 0) {
+          response.structuredContent = structured;
+        }
+      }
       const duration = Date.now() - started;
       const success = result?.success !== false;
       debug2("MCP response: tools/call", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -82,6 +82,8 @@
     "@types/node": "^25.0.2",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
     "@typescript-eslint/parser": "^8.58.0",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "esbuild": "^0.28.0",
     "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",

package/server.json

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