@daghis/teamcity-mcp 2.12.0 → 2.12.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.12.1](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.12.0...teamcity-mcp-v2.12.1) (2026-05-12)
+
+
+### Bug Fixes
+
+* **tools:** mark download_* as readOnly and idempotent ([#507](https://github.com/Daghis/teamcity-mcp/issues/507)) ([0a09663](https://github.com/Daghis/teamcity-mcp/commit/0a09663a5ff39e82f9b471e1aa7102ffc4d68163))
+
 ## [2.12.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.11.0...teamcity-mcp-v2.12.0) (2026-05-03)
 
 

package/README.md

@@ -47,6 +47,24 @@ See the [Tools Mode Matrix](docs/mcp-tools-mode-matrix.md) for the complete list
 - Performance-conscious: fast startup with minimal overhead
 - Clean codebase with clear module boundaries
 
+## Choosing between teamcity-mcp and the built-in MCP
+
+TeamCity 2026.1 ships with a built-in MCP endpoint at `<server-url>/app/mcp` exposing three tools: build log retrieval, a generic REST GET, and a build trigger (forced to `personal=true`). It is server-resident, requires no install, and is a sensible default for read-and-rerun workflows.
+
+teamcity-mcp is a different shape: an 87-tool typed surface focused on AI-driven workflows that need writes, multi-server support, or pre-2026.1 compatibility.
+
+| Use case                                                              | Recommendation                                                                             |
+| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| Read build logs, trigger builds, simple read flows                    | Built-in (TeamCity 2026.1+) — zero install                                                 |
+| Manage parameters, agents, queue, mutes, build configs, VCS roots     | teamcity-mcp                                                                               |
+| TeamCity server older than 2026.1                                     | teamcity-mcp                                                                               |
+| Multi-server / multi-tenant deployment                                | teamcity-mcp (HTTP transport — [PR #491](https://github.com/Daghis/teamcity-mcp/pull/491)) |
+| Typed tool surface for better agent reliability on chained operations | teamcity-mcp                                                                               |
+
+Both can coexist. The built-in is a good first stop; teamcity-mcp is the power tool for everything the built-in doesn't reach.
+
+For the design reasoning, see [docs/strategy.md](docs/strategy.md) and [docs/non-goals.md](docs/non-goals.md).
+
 ## Installation
 
 ### Prerequisites
@@ -110,7 +128,14 @@ On Windows, Claude Code's MCP configuration [may not properly merge environment
   "mcpServers": {
     "teamcity": {
       "command": "npx",
-      "args": ["-y", "@daghis/teamcity-mcp", "--url", "https://teamcity.example.com", "--token", "YOUR_TOKEN"]
+      "args": [
+        "-y",
+        "@daghis/teamcity-mcp",
+        "--url",
+        "https://teamcity.example.com",
+        "--token",
+        "YOUR_TOKEN"
+      ]
     }
   }
 }
@@ -359,4 +384,4 @@ This repository has GitHub secret scanning and push protection enabled. See [SEC
 
 ---
 
-Built with ❤️ for developers who love efficient CI/CD workflows
+Built with ❤️ for developers who love efficient CI/CD workflows

package/dist/index.js

@@ -1216,7 +1216,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.12.0",
+  version: "2.12.1",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1280,7 +1280,7 @@ var package_default = {
     url: "https://github.com/Daghis/teamcity-mcp/issues"
   },
   dependencies: {
-    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     axios: "^1.15.0",
     "axios-retry": "^4.5.0",
     dotenv: "17.4.2",
@@ -41544,9 +41544,9 @@ var DEV_TOOLS = [
   {
     name: "download_build_artifact",
     annotations: {
-      readOnlyHint: false,
+      readOnlyHint: true,
       destructiveHint: false,
-      idempotentHint: false,
+      idempotentHint: true,
       openWorldHint: true
     },
     description: "Download a single build artifact, with base64, text, or streaming output. Returns the artifact bytes or stream metadata; returns 404 if the build or path is unknown.",
@@ -41612,9 +41612,9 @@ var DEV_TOOLS = [
   {
     name: "download_build_artifacts",
     annotations: {
-      readOnlyHint: false,
+      readOnlyHint: true,
       destructiveHint: false,
-      idempotentHint: false,
+      idempotentHint: true,
       openWorldHint: true
     },
     description: "Download multiple build artifacts, with base64, text, or streaming output. Returns per-artifact payloads or stream metadata; returns 404 if the build or any path is unknown.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.12.0",
+  "version": "2.12.1",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -64,7 +64,7 @@
     "url": "https://github.com/Daghis/teamcity-mcp/issues"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "axios": "^1.15.0",
     "axios-retry": "^4.5.0",
     "dotenv": "17.4.2",

package/server.json

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