@daghis/teamcity-mcp 2.6.3 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.7.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.6.3...teamcity-mcp-v2.7.0) (2026-04-23)
+
+
+### Features
+
+* add MCP behavioral annotations to all 93 tool registrations ([#473](https://github.com/Daghis/teamcity-mcp/issues/473)) ([be71f71](https://github.com/Daghis/teamcity-mcp/commit/be71f71730ad9ac87a17dbcad999b0f02a23868b))
+
 ## [2.6.3](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.6.2...teamcity-mcp-v2.6.3) (2026-04-20)
 
 

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.7.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1306,8 +1306,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",
@@ -39058,6 +39059,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 +39087,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 +39113,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,6 +39162,12 @@ var DEV_TOOLS = [
   // === Project Tools ===
   {
     name: "list_projects",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List TeamCity projects (supports pagination)",
     inputSchema: {
       type: "object",
@@ -39210,6 +39235,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_project",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get details of a specific project",
     inputSchema: {
       type: "object",
@@ -39235,6 +39266,12 @@ var DEV_TOOLS = [
   // === Build Tools ===
   {
     name: "list_builds",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "List TeamCity builds (supports pagination)",
     inputSchema: {
       type: "object",
@@ -39323,6 +39360,12 @@ 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)",
     inputSchema: {
       type: "object",
@@ -39362,6 +39405,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 +39526,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 +39557,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,6 +39609,12 @@ 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",
     inputSchema: {
       type: "object",
@@ -39644,6 +39711,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 +39806,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,6 +40066,12 @@ 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)",
     inputSchema: {
       type: "object",
@@ -40054,6 +40139,12 @@ var DEV_TOOLS = [
   },
   {
     name: "get_build_config",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Get details of a build configuration",
     inputSchema: {
       type: "object",
@@ -40079,6 +40170,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 +40238,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 +40309,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 +40347,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 +40391,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 +40428,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 +40504,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 +40578,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 +40602,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 +40625,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 +40696,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 +40726,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 +40764,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 +40793,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 +40822,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 +40851,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 +40892,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 +40934,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 +40978,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 +40996,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 +41063,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,6 +41132,12 @@ 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",
     inputSchema: {
       type: "object",
@@ -41031,6 +41254,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 +41322,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 +41490,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 +41527,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 +41565,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 +41641,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 +41717,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 +41799,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 +41888,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 +41970,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 +42014,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 +42085,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 +42119,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 +42159,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 +42192,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 +42248,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 +42295,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 +42319,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 +42415,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 +42450,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 +42550,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 +42649,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 +42797,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 +42910,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 +43062,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 +43113,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 +43167,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 +43214,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 +43262,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 +43296,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 +43323,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 +43372,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 +43420,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 +43451,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 +43478,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 +43518,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 +43558,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 +43592,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 +43636,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 +43671,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 +43703,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 +43728,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 +43927,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 +44000,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 +44067,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 +44164,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 +44199,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 +44234,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 +44276,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 +44318,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 +44396,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 +44446,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 +44498,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 +44591,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 +44623,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 +44673,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",
@@ -44186,7 +44745,8 @@ function createSimpleServer() {
       tools: currentTools.map((tool) => ({
         name: tool.name,
         description: tool.description,
-        inputSchema: tool.inputSchema
+        inputSchema: tool.inputSchema,
+        annotations: tool.annotations
       }))
     };
     debug2("MCP response: tools/list", { count: response.tools.length, success: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -101,8 +101,9 @@
     "@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",

package/server.json

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