@daghis/teamcity-mcp 2.7.0 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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.8.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();
 }
@@ -39169,6 +39334,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "List TeamCity projects (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_projects,
     inputSchema: {
       type: "object",
       properties: {
@@ -39242,6 +39408,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "Get details of a specific project",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_project,
     inputSchema: {
       type: "object",
       properties: {
@@ -39273,6 +39440,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "List TeamCity builds (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_builds,
     inputSchema: {
       type: "object",
       properties: {
@@ -39367,6 +39535,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "Get details of a specific build (works for both queued and running/finished builds)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build,
     inputSchema: {
       type: "object",
       properties: {
@@ -39616,6 +39785,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "Get build status with optional test/problem and queue context details",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_status,
     inputSchema: {
       type: "object",
       properties: {
@@ -40073,6 +40243,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "List build configurations (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_build_configs,
     inputSchema: {
       type: "object",
       properties: {
@@ -40146,6 +40317,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "Get details of a build configuration",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_config,
     inputSchema: {
       type: "object",
       properties: {
@@ -41139,6 +41311,7 @@ var DEV_TOOLS = [
       openWorldHint: true
     },
     description: "Get detailed results of a build including tests, artifacts, changes, and statistics",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_results,
     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.8.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.8.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.7.0",
+      "version": "2.8.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {