teamcity-mcp

Overview

TeamCity MCP Server bridges AI coding assistants with TeamCity CI/CD server, exposing TeamCity operations as MCP tools. It offers two operational modes: Dev Mode (31 tools for safe CI/CD operations) and Full Mode (87 tools for complete infrastructure management). The server supports token-based authentication, provides runtime mode switching, and features a clean, performance-conscious architecture with clear module boundaries.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• TriggerBuild

  Queue a new build in TeamCity

  Try:Trigger a build for the frontend projectTry:Start a new build with branch main
• GetBuildStatus

  Check the progress and status of a specific build

  Try:What's the status of build 12345?Try:Is build 67890 complete yet?
• FetchBuildLog

  Retrieve the logs for a specific build

  Try:Get the build log for build 12345Try:Show me the complete output from build 67890
• ListBuilds

  Search and list builds based on criteria

  Try:List all builds for the last 24 hoursTry:Show me builds that failed in the last week
• ListTestFailures

  Get a list of failing tests in a build

  Try:Which tests failed in build 12345?Try:Show me all test failures from the latest build
• GetTestDetails

  Get detailed information about a specific test

  Try:Get details for test case 54321Try:Show me more information about failing test abc123
• AnalyzeBuildProblems

  Identify the root causes of build failures

  Try:Analyze why build 12345 failedTry:Investigate the problems with build 67890
• create_build_config

  Create a new TeamCity build configuration

  Try:Create a new build config for the mobile appTry:Set up a CI pipeline for the backend service
• clone_build_config

  Duplicate an existing build configuration

  Try:Clone the existing frontend config for the new branchTry:Copy the build config from project A to project B
• update_build_config

  Modify an existing build configuration

  Try:Update the build steps for config 12345Try:Change the artifact rules for the mobile build
• get_mcp_mode

  Check the current operational mode of the MCP server

  Try:What mode is the server currently running in?Try:Is the server in Full or Dev mode?
• set_mcp_mode

  Change the operational mode of the MCP server

  Try:Switch the server to Full modeTry:Set the MCP mode to Dev

Comparable tools

Installation

# Using npx with environment variables
TEAMCITY_URL="https://teamcity.example.com" \
TEAMCITY_TOKEN="<your_token>" \
MCP_MODE=dev \
npx -y @daghis/teamcity-mcp

{
  "mcpServers": {
    "teamcity": {
      "command": "npx",
      "args": [
        "-y",
        "@daghis/teamcity-mcp",
        "--url",
        "https://teamcity.example.com",
        "--token",
        "tc_<your_token>"
      ]
    }
  }
}

FAQ

What's the difference between Dev Mode and Full Mode?

Dev Mode (default) provides 31 tools for safe CI/CD operations, while Full Mode offers 87 tools for complete infrastructure management including configuration creation, agent management, and server administration.

How do I switch between modes?

You can set MCP_MODE environment variable to 'dev' or 'full'. With v2.1.0+, you can also use the 'get_mcp_mode' and 'set_mcp_mode' tools to switch at runtime without restarting.

Compare teamcity-mcp with