@daghis/teamcity-mcp 2.0.7 → 2.1.1

package/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "teamcity-mcp": {
+      "type": "stdio",
+      "command": "sh",
+      "args": [
+        "-c",
+        "cd /Users/marc/Developer/teamcity-mcp && node dist/index.js"
+      ],
+      "env": {}
+    }
+  }
+}

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.1.1](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.1.0...teamcity-mcp-v2.1.1) (2026-01-10)
+
+
+### Bug Fixes
+
+* correct parameter endpoints and add full CRUD for all parameter types ([#358](https://github.com/Daghis/teamcity-mcp/issues/358)) ([79e92ba](https://github.com/Daghis/teamcity-mcp/commit/79e92ba1c1a9642a0253bf9d040c15d0ec072803))
+
+## [2.1.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.0.7...teamcity-mcp-v2.1.0) (2026-01-08)
+
+
+### Features
+
+* add runtime MCP mode switching with list_changed notifications ([#355](https://github.com/Daghis/teamcity-mcp/issues/355)) ([873ba82](https://github.com/Daghis/teamcity-mcp/commit/873ba82e1329b0bc6271c15ec042093daa92499a))
+
 ## [2.0.7](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.0.6...teamcity-mcp-v2.0.7) (2026-01-05)
 
 

package/CLAUDE.md

@@ -0,0 +1,59 @@
+# Claude Code Instructions for teamcity-mcp
+
+## Project Overview
+
+TeamCity MCP Server - An MCP (Model Context Protocol) server that provides tools for interacting with TeamCity CI/CD.
+
+## Development Commands
+
+```bash
+npm run build              # Build the project
+npm run lint               # Run ESLint
+npm run format             # Run Prettier
+npm run check              # Run all checks (build, lint, format)
+```
+
+## Testing
+
+### Unit tests
+```bash
+npm test                   # Run all unit tests
+npm run test:coverage      # Run with coverage report
+```
+
+### Integration tests
+
+Requires `TEAMCITY_URL` and `TEAMCITY_TOKEN` in `.env` or environment.
+
+```bash
+npm run test:integration                           # Run integration tests (some suites skipped)
+SERIAL_BUILD_TESTS=true npm run test:integration   # Run ALL integration tests including serial suites
+```
+
+Serial suites are skipped by default because they need exclusive access to TeamCity resources (queue operations, streaming artifacts). The `SERIAL_BUILD_TESTS=true` flag enables them.
+
+## Code Conventions
+
+- TypeScript strict mode, no `any`
+- Test code must be at the same quality as production code
+- Use existing logger utilities, avoid `console.log`
+- Follow Conventional Commits for commit messages
+
+## Key Patterns
+
+### Auto-generated API client
+
+The TeamCity API client in `src/teamcity-client/api/` is auto-generated from OpenAPI specs. Method names with numeric suffixes (e.g., `createBuildParameterOfBuildType_1`) differentiate between endpoints with similar operations:
+- Non-suffixed methods often target `/output-parameters`
+- `_1`, `_7`, etc. suffixed methods target `/parameters`
+
+Always verify the endpoint path in the generated code when using these methods.
+
+### Parameter tools
+
+Three parameter sets exist:
+- **Project parameters**: `/projects/{id}/parameters` (supports types)
+- **Build config input parameters**: `/buildTypes/{id}/parameters` (supports types)
+- **Build config output parameters**: `/buildTypes/{id}/output-parameters` (no type support)
+
+Type support includes: `password`, `text`, `checkbox`, `select` with spec format in `type.rawValue`.

package/dist/index.js

@@ -678,9 +678,23 @@ function getConfig() {
 function isTest() {
   return false;
 }
+var runtimeMCPMode = null;
+var serverInstance = null;
 function getMCPMode() {
+  if (runtimeMCPMode !== null) {
+    return runtimeMCPMode;
+  }
   return process.env["MCP_MODE"] ?? "dev";
 }
+function setMCPMode(mode) {
+  runtimeMCPMode = mode;
+}
+function setServerInstance(server) {
+  serverInstance = server;
+}
+function getServerInstance() {
+  return serverInstance;
+}
 function getTeamCityUrl() {
   const config2 = getConfig();
   if (!config2.teamcity?.url || config2.teamcity.url.length === 0) {
@@ -1195,7 +1209,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.0.7",
+  version: "2.1.1",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1260,31 +1274,22 @@ var package_default = {
   },
   dependencies: {
     "@modelcontextprotocol/sdk": "^1.24.0",
-    ajv: "^8.17.1",
-    "ajv-formats": "^3.0.1",
     axios: "^1.13.2",
+    "axios-retry": "^4.5.0",
     dotenv: "17.2.3",
-    express: "^5.1.0",
-    inversify: "^7.10.4",
-    morgan: "^1.10.0",
-    "reflect-metadata": "^0.2.2",
     tslib: "^2.8.1",
     winston: "^3.11.0",
-    zod: "^4.1.12"
+    zod: "^4.3.5"
   },
   devDependencies: {
     "@codecov/bundler-plugin-core": "^1.9.1",
     "@esbuild-plugins/tsconfig-paths": "^0.1.2",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
-    "@types/ajv": "^1.0.4",
-    "@types/express": "^5.0.5",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.1",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/morgan": "^1.9.9",
     "@types/node": "^25.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.46.3",
-    "@typescript-eslint/parser": "^8.46.3",
-    "axios-retry": "^4.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
     esbuild: "^0.27.0",
     eslint: "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
@@ -39064,6 +39069,69 @@ var DEV_TOOLS = [
       };
     }
   },
+  // === Mode Management Tools ===
+  {
+    name: "get_mcp_mode",
+    description: "Get current MCP mode. Dev mode: read-only tools for safe exploration. Full mode: all tools including admin operations.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async () => {
+      const mode = getMCPMode2();
+      const toolCount = getAvailableTools().length;
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ mode, toolCount }, null, 2)
+          }
+        ]
+      };
+    }
+  },
+  {
+    name: "set_mcp_mode",
+    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",
+      properties: {
+        mode: {
+          type: "string",
+          enum: ["dev", "full"],
+          description: "Target mode: dev (read-only) or full (all operations)"
+        }
+      },
+      required: ["mode"]
+    },
+    handler: async (args) => {
+      const typed = args;
+      const previousMode = getMCPMode2();
+      setMCPMode(typed.mode);
+      const server = getServerInstance();
+      if (server) {
+        await server.sendToolListChanged();
+      }
+      const toolCount = getAvailableTools().length;
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                previousMode,
+                currentMode: typed.mode,
+                toolCount,
+                message: `Mode switched. ${toolCount} tools now available.`
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  },
   // === Project Tools ===
   {
     name: "list_projects",
@@ -42571,7 +42639,11 @@ var FULL_MODE_TOOLS = [
       properties: {
         buildTypeId: { type: "string", description: "Build type ID" },
         name: { type: "string", description: "Parameter name" },
-        value: { type: "string", description: "Parameter value" }
+        value: { type: "string", description: "Parameter value" },
+        type: {
+          type: "string",
+          description: `Parameter type spec (optional): "password", "text", "checkbox checkedValue='true' uncheckedValue='false'", "select data_1='opt1' data_2='opt2'"`
+        }
       },
       required: ["buildTypeId", "name", "value"]
     },
@@ -42582,7 +42654,10 @@ var FULL_MODE_TOOLS = [
         name: typedArgs.name,
         value: typedArgs.value
       };
-      await adapter.modules.buildTypes.createBuildParameterOfBuildType(
+      if (typedArgs.type) {
+        parameter.type = { rawValue: typedArgs.type };
+      }
+      await adapter.modules.buildTypes.createBuildParameterOfBuildType_1(
         typedArgs.buildTypeId,
         void 0,
         parameter,
@@ -42600,6 +42675,262 @@ var FULL_MODE_TOOLS = [
   {
     name: "update_parameter",
     description: "Update a build configuration parameter",
+    inputSchema: {
+      type: "object",
+      properties: {
+        buildTypeId: { type: "string", description: "Build type ID" },
+        name: { type: "string", description: "Parameter name" },
+        value: { type: "string", description: "New parameter value" },
+        type: {
+          type: "string",
+          description: `Parameter type spec (optional): "password", "text", "checkbox checkedValue='true' uncheckedValue='false'", "select data_1='opt1' data_2='opt2'"`
+        }
+      },
+      required: ["buildTypeId", "name", "value"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const parameter = {
+        name: typedArgs.name,
+        value: typedArgs.value
+      };
+      if (typedArgs.type) {
+        parameter.type = { rawValue: typedArgs.type };
+      }
+      await adapter.modules.buildTypes.updateBuildParameterOfBuildType_7(
+        typedArgs.name,
+        typedArgs.buildTypeId,
+        void 0,
+        parameter,
+        { headers: { "Content-Type": "application/json", Accept: "application/json" } }
+      );
+      return json({
+        success: true,
+        action: "update_parameter",
+        buildTypeId: typedArgs.buildTypeId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  {
+    name: "delete_parameter",
+    description: "Delete a parameter from a build configuration",
+    inputSchema: {
+      type: "object",
+      properties: {
+        buildTypeId: { type: "string", description: "Build type ID" },
+        name: { type: "string", description: "Parameter name" }
+      },
+      required: ["buildTypeId", "name"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      await adapter.modules.buildTypes.deleteBuildParameterOfBuildType_2(
+        typedArgs.name,
+        typedArgs.buildTypeId
+      );
+      return json({
+        success: true,
+        action: "delete_parameter",
+        buildTypeId: typedArgs.buildTypeId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  // === Project Parameter Management ===
+  {
+    name: "list_project_parameters",
+    description: "List parameters for a project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" }
+      },
+      required: ["projectId"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const response = await adapter.modules.projects.getBuildParameters(typedArgs.projectId);
+      const parameters = response.data?.property ?? [];
+      return json({
+        parameters,
+        count: parameters.length
+      });
+    }
+  },
+  {
+    name: "add_project_parameter",
+    description: "Add a parameter to a project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        name: { type: "string", description: "Parameter name" },
+        value: { type: "string", description: "Parameter value" },
+        type: {
+          type: "string",
+          description: `Parameter type spec (optional): "password", "text", "checkbox checkedValue='true' uncheckedValue='false'", "select data_1='opt1' data_2='opt2'"`
+        }
+      },
+      required: ["projectId", "name", "value"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const parameter = {
+        name: typedArgs.name,
+        value: typedArgs.value
+      };
+      if (typedArgs.type) {
+        parameter.type = { rawValue: typedArgs.type };
+      }
+      await adapter.modules.projects.createBuildParameter(
+        typedArgs.projectId,
+        void 0,
+        parameter,
+        {
+          headers: { "Content-Type": "application/json", Accept: "application/json" }
+        }
+      );
+      return json({
+        success: true,
+        action: "add_project_parameter",
+        projectId: typedArgs.projectId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  {
+    name: "update_project_parameter",
+    description: "Update a project parameter",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        name: { type: "string", description: "Parameter name" },
+        value: { type: "string", description: "New parameter value" },
+        type: {
+          type: "string",
+          description: `Parameter type spec (optional): "password", "text", "checkbox checkedValue='true' uncheckedValue='false'", "select data_1='opt1' data_2='opt2'"`
+        }
+      },
+      required: ["projectId", "name", "value"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const parameter = {
+        name: typedArgs.name,
+        value: typedArgs.value
+      };
+      if (typedArgs.type) {
+        parameter.type = { rawValue: typedArgs.type };
+      }
+      await adapter.modules.projects.updateBuildParameter(
+        typedArgs.name,
+        typedArgs.projectId,
+        void 0,
+        parameter,
+        { headers: { "Content-Type": "application/json", Accept: "application/json" } }
+      );
+      return json({
+        success: true,
+        action: "update_project_parameter",
+        projectId: typedArgs.projectId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  {
+    name: "delete_project_parameter",
+    description: "Delete a parameter from a project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        name: { type: "string", description: "Parameter name" }
+      },
+      required: ["projectId", "name"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      await adapter.modules.projects.deleteBuildParameter(typedArgs.name, typedArgs.projectId);
+      return json({
+        success: true,
+        action: "delete_project_parameter",
+        projectId: typedArgs.projectId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  // === Output Parameter Management ===
+  {
+    name: "list_output_parameters",
+    description: "List output parameters for a build configuration",
+    inputSchema: {
+      type: "object",
+      properties: {
+        buildTypeId: { type: "string", description: "Build type ID" }
+      },
+      required: ["buildTypeId"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const buildType = await adapter.getBuildType(typedArgs.buildTypeId);
+      const parameters = buildType["output-parameters"]?.property ?? [];
+      return json({
+        parameters,
+        count: parameters.length
+      });
+    }
+  },
+  {
+    name: "add_output_parameter",
+    description: "Add an output parameter to a build configuration (for build chains)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        buildTypeId: { type: "string", description: "Build type ID" },
+        name: { type: "string", description: "Parameter name" },
+        value: { type: "string", description: "Parameter value" }
+      },
+      required: ["buildTypeId", "name", "value"]
+    },
+    handler: async (args) => {
+      const typedArgs = args;
+      const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+      const parameter = {
+        name: typedArgs.name,
+        value: typedArgs.value
+      };
+      await adapter.modules.buildTypes.createBuildParameterOfBuildType(
+        typedArgs.buildTypeId,
+        void 0,
+        parameter,
+        { headers: { "Content-Type": "application/json", Accept: "application/json" } }
+      );
+      return json({
+        success: true,
+        action: "add_output_parameter",
+        buildTypeId: typedArgs.buildTypeId,
+        name: typedArgs.name
+      });
+    },
+    mode: "full"
+  },
+  {
+    name: "update_output_parameter",
+    description: "Update an output parameter in a build configuration",
     inputSchema: {
       type: "object",
       properties: {
@@ -42624,7 +42955,7 @@ var FULL_MODE_TOOLS = [
       );
       return json({
         success: true,
-        action: "update_parameter",
+        action: "update_output_parameter",
         buildTypeId: typedArgs.buildTypeId,
         name: typedArgs.name
       });
@@ -42632,8 +42963,8 @@ var FULL_MODE_TOOLS = [
     mode: "full"
   },
   {
-    name: "delete_parameter",
-    description: "Delete a parameter from a build configuration",
+    name: "delete_output_parameter",
+    description: "Delete an output parameter from a build configuration",
     inputSchema: {
       type: "object",
       properties: {
@@ -42645,13 +42976,13 @@ var FULL_MODE_TOOLS = [
     handler: async (args) => {
       const typedArgs = args;
       const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
-      await adapter.modules.buildTypes.deleteBuildParameterOfBuildType_2(
+      await adapter.modules.buildTypes.deleteBuildParameterOfBuildType(
         typedArgs.name,
         typedArgs.buildTypeId
       );
       return json({
         success: true,
-        action: "delete_parameter",
+        action: "delete_output_parameter",
         buildTypeId: typedArgs.buildTypeId,
         name: typedArgs.name
       });
@@ -43565,7 +43896,9 @@ function createSimpleServer() {
     },
     {
       capabilities: {
-        tools: {},
+        tools: {
+          listChanged: true
+        },
         prompts: void 0,
         resources: void 0
       }
@@ -43721,6 +44054,7 @@ async function main() {
     const transport = new import_stdio.StdioServerTransport();
     const lifecycle = startServerLifecycle(server, transport);
     activeServer = server;
+    setServerInstance(server);
     lifecyclePromise = lifecycle;
     process.stderr.write("TeamCity MCP Server is running and ready to accept connections\n");
     await lifecycle;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.0.7",
+  "version": "2.1.1",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -65,31 +65,22 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.0",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
     "axios": "^1.13.2",
+    "axios-retry": "^4.5.0",
     "dotenv": "17.2.3",
-    "express": "^5.1.0",
-    "inversify": "^7.10.4",
-    "morgan": "^1.10.0",
-    "reflect-metadata": "^0.2.2",
     "tslib": "^2.8.1",
     "winston": "^3.11.0",
-    "zod": "^4.1.12"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@codecov/bundler-plugin-core": "^1.9.1",
     "@esbuild-plugins/tsconfig-paths": "^0.1.2",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
-    "@types/ajv": "^1.0.4",
-    "@types/express": "^5.0.5",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.1",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/morgan": "^1.9.9",
     "@types/node": "^25.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.46.3",
-    "@typescript-eslint/parser": "^8.46.3",
-    "axios-retry": "^4.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
     "esbuild": "^0.27.0",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",

package/server.json

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