@daghis/teamcity-mcp 2.6.3 → 2.8.0

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.6.3",
+  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",
@@ -1306,8 +1308,9 @@ var package_default = {
     "@hono/node-server": "^1.19.13",
     axios: "^1.15.0",
     "body-parser": "^2.2.1",
+    "follow-redirects": "^1.16.0",
     "glob@>=10.2.0 <10.5.0": "^10.5.0",
-    hono: "^4.12.12",
+    hono: "^4.12.14",
     "js-yaml@<4.0.0": "^3.14.2",
     "lodash-es": "^4.18.0",
     "picomatch@>=2 <2.3.2": "^2.3.2",
@@ -4604,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;
   }
 }
 
@@ -39051,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();
 }
@@ -39058,6 +39224,12 @@ var DEV_TOOLS = [
   // === Basic Tools ===
   {
     name: "ping",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Test MCP server connectivity",
     inputSchema: {
       type: "object",
@@ -39080,6 +39252,12 @@ var DEV_TOOLS = [
   // === Mode Management Tools ===
   {
     name: "get_mcp_mode",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "Get current MCP mode. Dev mode: read-only tools for safe exploration. Full mode: all tools including admin operations.",
     inputSchema: {
       type: "object",
@@ -39100,6 +39278,12 @@ var DEV_TOOLS = [
   },
   {
     name: "set_mcp_mode",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      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.",
     inputSchema: {
       type: "object",
@@ -39143,7 +39327,14 @@ var DEV_TOOLS = [
   // === Project Tools ===
   {
     name: "list_projects",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List TeamCity projects (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_projects,
     inputSchema: {
       type: "object",
       properties: {
@@ -39210,7 +39401,14 @@ var DEV_TOOLS = [
   },
   {
     name: "get_project",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get details of a specific project",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_project,
     inputSchema: {
       type: "object",
       properties: {
@@ -39235,7 +39433,14 @@ var DEV_TOOLS = [
   // === Build Tools ===
   {
     name: "list_builds",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List TeamCity builds (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_builds,
     inputSchema: {
       type: "object",
       properties: {
@@ -39323,7 +39528,14 @@ var DEV_TOOLS = [
   },
   {
     name: "get_build",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      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: {
@@ -39362,6 +39574,12 @@ var DEV_TOOLS = [
   },
   {
     name: "trigger_build",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Trigger a new build",
     inputSchema: {
       type: "object",
@@ -39477,6 +39695,12 @@ var DEV_TOOLS = [
   },
   {
     name: "cancel_queued_build",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Cancel a queued build by ID",
     inputSchema: {
       type: "object",
@@ -39502,6 +39726,12 @@ var DEV_TOOLS = [
   },
   {
     name: "cancel_build",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Cancel or stop a running (or queued) build by ID. Supports an optional comment and requeue flag.",
     inputSchema: {
       type: "object",
@@ -39548,7 +39778,14 @@ var DEV_TOOLS = [
   },
   {
     name: "get_build_status",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      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: {
@@ -39644,6 +39881,12 @@ var DEV_TOOLS = [
   },
   {
     name: "wait_for_build",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Wait for a build to complete by polling until it reaches a terminal state (finished, canceled, failed) or timeout",
     inputSchema: {
       type: "object",
@@ -39733,6 +39976,12 @@ var DEV_TOOLS = [
   },
   {
     name: "fetch_build_log",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Fetch build log with pagination (by lines)",
     inputSchema: {
       type: "object",
@@ -39987,7 +40236,14 @@ var DEV_TOOLS = [
   // === Build Configuration Tools ===
   {
     name: "list_build_configs",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List build configurations (supports pagination)",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.list_build_configs,
     inputSchema: {
       type: "object",
       properties: {
@@ -40054,7 +40310,14 @@ var DEV_TOOLS = [
   },
   {
     name: "get_build_config",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get details of a build configuration",
+    outputSchema: FIRST_BATCH_OUTPUT_SCHEMAS.get_build_config,
     inputSchema: {
       type: "object",
       properties: {
@@ -40079,6 +40342,12 @@ var DEV_TOOLS = [
   // === Test Tools ===
   {
     name: "list_test_failures",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List test failures for a build (supports pagination)",
     inputSchema: {
       type: "object",
@@ -40141,6 +40410,12 @@ var DEV_TOOLS = [
   // === VCS Tools ===
   {
     name: "list_vcs_roots",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List VCS roots (supports pagination)",
     inputSchema: {
       type: "object",
@@ -40206,6 +40481,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_vcs_root",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get details of a VCS root (including properties)",
     inputSchema: {
       type: "object",
@@ -40238,6 +40519,12 @@ var DEV_TOOLS = [
   },
   {
     name: "set_vcs_root_property",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Set a single VCS root property (e.g., branch, branchSpec, url)",
     inputSchema: {
       type: "object",
@@ -40276,6 +40563,12 @@ var DEV_TOOLS = [
   },
   {
     name: "delete_vcs_root_property",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete a single VCS root property",
     inputSchema: {
       type: "object",
@@ -40307,6 +40600,12 @@ var DEV_TOOLS = [
   },
   {
     name: "update_vcs_root_properties",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update common VCS root properties in one call",
     inputSchema: {
       type: "object",
@@ -40377,6 +40676,12 @@ var DEV_TOOLS = [
   // === Queue (read-only) ===
   {
     name: "list_queued_builds",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List queued builds (supports TeamCity queue locator + pagination)",
     inputSchema: {
       type: "object",
@@ -40445,6 +40750,12 @@ var DEV_TOOLS = [
   // === Server Health & Metrics (read-only) ===
   {
     name: "get_server_metrics",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Fetch server metrics (CPU/memory/disk/load) if available",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
@@ -40463,6 +40774,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_server_info",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get TeamCity server info (version, build number, state)",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
@@ -40480,6 +40797,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_server_health_items",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List server health items (warnings/errors) for readiness checks",
     inputSchema: {
       type: "object",
@@ -40545,6 +40868,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_server_health_item",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get a single server health item by locator",
     inputSchema: {
       type: "object",
@@ -40569,6 +40898,12 @@ var DEV_TOOLS = [
   // === Availability Policy Guard (read-only) ===
   {
     name: "check_availability_guard",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Evaluate server health; returns ok=false if critical health items found (severity ERROR)",
     inputSchema: {
       type: "object",
@@ -40601,6 +40936,12 @@ var DEV_TOOLS = [
   // === Agent Compatibility (read-only lookups) ===
   {
     name: "get_compatible_build_types_for_agent",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get build types compatible with the specified agent",
     inputSchema: {
       type: "object",
@@ -40624,6 +40965,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_incompatible_build_types_for_agent",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get build types incompatible with the specified agent",
     inputSchema: {
       type: "object",
@@ -40647,6 +40994,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_agent_enabled_info",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get the enabled/disabled state for an agent, including comment and switch time",
     inputSchema: {
       type: "object",
@@ -40670,6 +41023,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_compatible_agents_for_build_type",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List agents compatible with a build type (optionally filter enabled only)",
     inputSchema: {
       type: "object",
@@ -40705,6 +41064,12 @@ var DEV_TOOLS = [
   },
   {
     name: "count_compatible_agents_for_build_type",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Return only the count of enabled compatible agents for a build type",
     inputSchema: {
       type: "object",
@@ -40741,6 +41106,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_compatible_agents_for_queued_build",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List agents compatible with a queued/running build by buildId (optionally filter enabled only)",
     inputSchema: {
       type: "object",
@@ -40779,6 +41150,12 @@ var DEV_TOOLS = [
   },
   {
     name: "check_teamcity_connection",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Check connectivity to TeamCity server and basic readiness",
     inputSchema: { type: "object", properties: {} },
     handler: async (_args) => {
@@ -40791,6 +41168,12 @@ var DEV_TOOLS = [
   // === Agent Tools ===
   {
     name: "list_agents",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List build agents (supports pagination)",
     inputSchema: {
       type: "object",
@@ -40852,6 +41235,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_agent_pools",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List agent pools (supports pagination)",
     inputSchema: {
       type: "object",
@@ -40915,7 +41304,14 @@ var DEV_TOOLS = [
   // Build Analysis Tools
   {
     name: "get_build_results",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      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: {
@@ -41031,6 +41427,12 @@ var DEV_TOOLS = [
   },
   {
     name: "download_build_artifact",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Download a single artifact with optional streaming output",
     inputSchema: {
       type: "object",
@@ -41093,6 +41495,12 @@ var DEV_TOOLS = [
   },
   {
     name: "download_build_artifacts",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Download multiple artifacts with optional streaming output",
     inputSchema: {
       type: "object",
@@ -41255,6 +41663,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_test_details",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get detailed information about test failures",
     inputSchema: {
       type: "object",
@@ -41286,6 +41700,12 @@ var DEV_TOOLS = [
   },
   {
     name: "analyze_build_problems",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Analyze and report build problems and failures",
     inputSchema: {
       type: "object",
@@ -41318,6 +41738,12 @@ var DEV_TOOLS = [
   // === Changes, Problems & Diagnostics ===
   {
     name: "list_changes",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List VCS changes (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41388,6 +41814,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_problems",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List build problems (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41458,6 +41890,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_problem_occurrences",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List problem occurrences (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41534,6 +41972,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_investigations",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List open investigations (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41617,6 +42061,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_muted_tests",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List muted tests (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41693,6 +42143,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_versioned_settings_status",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get Versioned Settings status for a locator",
     inputSchema: {
       type: "object",
@@ -41731,6 +42187,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_users",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List TeamCity users (supports pagination)",
     inputSchema: {
       type: "object",
@@ -41796,6 +42258,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_roles",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List defined roles and their permissions",
     inputSchema: {
       type: "object",
@@ -41824,6 +42292,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_branches",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List branches for a project or build configuration",
     inputSchema: {
       type: "object",
@@ -41858,6 +42332,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_parameters",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List parameters for a build configuration",
     inputSchema: {
       type: "object",
@@ -41885,6 +42365,12 @@ var DEV_TOOLS = [
   },
   {
     name: "list_project_hierarchy",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List project hierarchy showing parent-child relationships",
     inputSchema: {
       type: "object",
@@ -41935,6 +42421,12 @@ var FULL_MODE_TOOLS = [
   // === Project Management Tools ===
   {
     name: "create_project",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Create a new TeamCity project",
     inputSchema: {
       type: "object",
@@ -41976,6 +42468,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "delete_project",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete a TeamCity project",
     inputSchema: {
       type: "object",
@@ -41994,6 +42492,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "update_project_settings",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update project settings and parameters",
     inputSchema: {
       type: "object",
@@ -42084,6 +42588,12 @@ var FULL_MODE_TOOLS = [
   // === Build Configuration Management ===
   {
     name: "create_build_config",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Create a new build configuration",
     inputSchema: {
       type: "object",
@@ -42113,6 +42623,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "clone_build_config",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Clone an existing build configuration",
     inputSchema: {
       type: "object",
@@ -42207,6 +42723,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "update_build_config",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update build configuration settings",
     inputSchema: {
       type: "object",
@@ -42300,6 +42822,12 @@ var FULL_MODE_TOOLS = [
   // === Dependency, Feature, and Requirement Management ===
   {
     name: "manage_build_dependencies",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add, update, or delete artifact and snapshot dependencies for a build configuration",
     inputSchema: {
       type: "object",
@@ -42442,6 +42970,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "manage_build_features",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add, update, or delete build features such as ssh-agent or requirements enforcement",
     inputSchema: {
       type: "object",
@@ -42549,6 +43083,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "manage_agent_requirements",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add, update, or delete build agent requirements for a configuration",
     inputSchema: {
       type: "object",
@@ -42695,6 +43235,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "set_build_config_state",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Enable or disable a build configuration by toggling its paused flag",
     inputSchema: {
       type: "object",
@@ -42740,6 +43286,12 @@ var FULL_MODE_TOOLS = [
   // === VCS attachment ===
   {
     name: "add_vcs_root_to_build",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Attach a VCS root to a build configuration",
     inputSchema: {
       type: "object",
@@ -42788,6 +43340,12 @@ var FULL_MODE_TOOLS = [
   // === Parameter Management ===
   {
     name: "add_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add a parameter to a build configuration",
     inputSchema: {
       type: "object",
@@ -42829,6 +43387,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "update_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update a build configuration parameter",
     inputSchema: {
       type: "object",
@@ -42871,6 +43435,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "delete_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete a parameter from a build configuration",
     inputSchema: {
       type: "object",
@@ -42899,6 +43469,12 @@ var FULL_MODE_TOOLS = [
   // === Project Parameter Management ===
   {
     name: "list_project_parameters",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List parameters for a project",
     inputSchema: {
       type: "object",
@@ -42920,6 +43496,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "add_project_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add a parameter to a project",
     inputSchema: {
       type: "object",
@@ -42963,6 +43545,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "update_project_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update a project parameter",
     inputSchema: {
       type: "object",
@@ -43005,6 +43593,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "delete_project_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete a parameter from a project",
     inputSchema: {
       type: "object",
@@ -43030,6 +43624,12 @@ var FULL_MODE_TOOLS = [
   // === Output Parameter Management ===
   {
     name: "list_output_parameters",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List output parameters for a build configuration",
     inputSchema: {
       type: "object",
@@ -43051,6 +43651,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "add_output_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add an output parameter to a build configuration (for build chains)",
     inputSchema: {
       type: "object",
@@ -43085,6 +43691,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "update_output_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Update an output parameter in a build configuration",
     inputSchema: {
       type: "object",
@@ -43119,6 +43731,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "delete_output_parameter",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete an output parameter from a build configuration",
     inputSchema: {
       type: "object",
@@ -43147,6 +43765,12 @@ var FULL_MODE_TOOLS = [
   // === VCS Root Management ===
   {
     name: "create_vcs_root",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Create a new VCS root",
     inputSchema: {
       type: "object",
@@ -43185,6 +43809,12 @@ var FULL_MODE_TOOLS = [
   // === Agent Management ===
   {
     name: "authorize_agent",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Authorize or unauthorize a build agent",
     inputSchema: {
       type: "object",
@@ -43214,6 +43844,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "assign_agent_to_pool",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Assign an agent to a different pool",
     inputSchema: {
       type: "object",
@@ -43240,6 +43876,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "remove_agent",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Remove (delete) a build agent from the TeamCity server. Use this to clean up disconnected or ghost agent entries.",
     inputSchema: {
       type: "object",
@@ -43259,6 +43901,12 @@ var FULL_MODE_TOOLS = [
   // === Build Step Management ===
   {
     name: "manage_build_steps",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add, update, or delete build steps",
     inputSchema: {
       type: "object",
@@ -43452,6 +44100,12 @@ var FULL_MODE_TOOLS = [
   // === Build Trigger Management ===
   {
     name: "manage_build_triggers",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Add, update, or delete build triggers",
     inputSchema: {
       type: "object",
@@ -43519,6 +44173,12 @@ var FULL_MODE_TOOLS = [
   // === Batch pause/unpause specific build configurations ===
   {
     name: "set_build_configs_paused",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Set paused/unpaused for a list of build configurations; optionally cancel queued",
     inputSchema: {
       type: "object",
@@ -43580,6 +44240,12 @@ var FULL_MODE_TOOLS = [
   // === Test Administration ===
   {
     name: "mute_tests",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Mute tests within a project or build configuration scope",
     inputSchema: {
       type: "object",
@@ -43671,6 +44337,12 @@ var FULL_MODE_TOOLS = [
   // === Queue Maintenance ===
   {
     name: "move_queued_build_to_top",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Move a queued build to the top of the queue",
     inputSchema: {
       type: "object",
@@ -43700,6 +44372,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "reorder_queued_builds",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Reorder queued builds by providing the desired sequence of IDs",
     inputSchema: {
       type: "object",
@@ -43729,6 +44407,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "cancel_queued_builds_for_build_type",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Cancel all queued builds for a specific build configuration",
     inputSchema: {
       type: "object",
@@ -43765,6 +44449,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "cancel_queued_builds_by_locator",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     description: "Cancel all queued builds matching a queue locator expression",
     inputSchema: {
       type: "object",
@@ -43801,6 +44491,12 @@ var FULL_MODE_TOOLS = [
   // === Scoped Pause/Resume (by pool) ===
   {
     name: "pause_queue_for_pool",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Disable all agents in a pool to pause queue processing; optionally cancel queued builds for a build type",
     inputSchema: {
       type: "object",
@@ -43873,6 +44569,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "resume_queue_for_pool",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Re-enable all agents in a pool to resume queue processing",
     inputSchema: {
       type: "object",
@@ -43917,6 +44619,12 @@ var FULL_MODE_TOOLS = [
   // === Agent Enable/Disable ===
   {
     name: "set_agent_enabled",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Enable/disable an agent, with optional comment and schedule",
     inputSchema: {
       type: "object",
@@ -43963,6 +44671,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "bulk_set_agents_enabled",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Bulk enable/disable agents selected by pool or locator; supports comment/schedule",
     inputSchema: {
       type: "object",
@@ -44050,6 +44764,12 @@ var FULL_MODE_TOOLS = [
   // === SSH Key Management ===
   {
     name: "list_project_ssh_keys",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List SSH keys configured for a project",
     inputSchema: {
       type: "object",
@@ -44076,6 +44796,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "upload_project_ssh_key",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      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.",
     inputSchema: {
       type: "object",
@@ -44120,6 +44846,12 @@ var FULL_MODE_TOOLS = [
   },
   {
     name: "delete_project_ssh_key",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Delete an SSH key from a project",
     inputSchema: {
       type: "object",
@@ -44161,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();
@@ -44186,7 +44930,9 @@ function createSimpleServer() {
       tools: currentTools.map((tool) => ({
         name: tool.name,
         description: tool.description,
-        inputSchema: tool.inputSchema
+        inputSchema: tool.inputSchema,
+        annotations: tool.annotations,
+        ...tool.outputSchema ? { outputSchema: tool.outputSchema } : {}
       }))
     };
     debug2("MCP response: tools/list", { count: response.tools.length, success: true });
@@ -44211,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", {