TeamCity MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Server port | 3000 |
| MCP_MODE | No | MCP mode (dev or full) | dev |
| NODE_ENV | No | Node environment | development |
| LOG_LEVEL | No | Log level | info |
| TEAMCITY_URL | No | TeamCity server URL | |
| TEAMCITY_TOKEN | No | TeamCity authentication token | |
| TEAMCITY_TIMEOUT | No | TeamCity connection timeout | 30000 |
| TEAMCITY_API_TOKEN | No | TeamCity authentication token (alias for TEAMCITY_TOKEN) | |
| TEAMCITY_PAGE_SIZE | No | Default page size for pagination | 100 |
| TEAMCITY_KEEP_ALIVE | No | Keep alive connections | true |
| TEAMCITY_SERVER_URL | No | TeamCity server URL (alias for TEAMCITY_URL) | |
| TEAMCITY_COMPRESSION | No | Enable compression | true |
| TEAMCITY_MAX_RETRIES | No | Maximum number of retries | 3 |
| TEAMCITY_RETRY_DELAY | No | Retry delay in milliseconds | 1000 |
| TEAMCITY_MAX_PAGE_SIZE | No | Maximum page size for pagination | 1000 |
| TEAMCITY_RETRY_ENABLED | No | Enable retry mechanism | true |
| TEAMCITY_AUTO_FETCH_ALL | No | Auto fetch all pages | false |
| TEAMCITY_MAX_CONCURRENT | No | Maximum concurrent connections | 10 |
| TEAMCITY_CIRCUIT_BREAKER | No | Enable circuit breaker | true |
| TEAMCITY_MAX_RETRY_DELAY | No | Maximum retry delay in milliseconds | 30000 |
| TEAMCITY_CB_RESET_TIMEOUT | No | Circuit breaker reset timeout | 60000 |
| TEAMCITY_CB_FAILURE_THRESHOLD | No | Circuit breaker failure threshold | 5 |
| TEAMCITY_CB_SUCCESS_THRESHOLD | No | Circuit breaker success threshold | 2 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingA | Test MCP server connectivity. Returns a confirmation echo and optional message. |
| get_mcp_modeA | Get the current MCP mode. Dev mode is read-only; full mode enables all operations. |
| set_mcp_modeA | Switch MCP mode at runtime. Returns previous and current modes with the updated tool count; idempotent and notifies clients of the list change. |
| list_projectsA | List TeamCity projects. Supports pagination and locator filtering. |
| get_projectB | Get details of a specific project. |
| list_buildsA | List TeamCity builds. Supports pagination and locator filtering. |
| get_buildA | Get details of a specific build. Works for queued, running, and finished builds. |
| trigger_buildA | Trigger a new build; runs asynchronously, use |
| cancel_queued_buildA | Cancel a queued (not-yet-running) build. Idempotent; returns 404 if the build already started or was cancelled. |
| cancel_buildA | Cancel or stop a running or queued build, with optional comment and requeue flag. Returns the cancelled build; returns 404 if the build is unknown. |
| get_build_statusB | Get build status. Optionally includes test and problem summaries plus queue context. |
| wait_for_buildA | Wait for a build to reach a terminal state (finished, canceled, failed). Long-running; polls until completion or timeout. |
| fetch_build_logA | Fetch a build log. Supports line-based pagination and streaming output. |
| list_build_configsB | List build configurations. Supports pagination and locator filtering. |
| get_build_configB | Get details of a build configuration. |
| list_test_failuresA | List test failures for a build. Supports pagination. |
| list_queued_buildsA | List queued builds. Supports TeamCity queue locator filtering and pagination. |
| get_server_infoA | Get TeamCity server info including version, build number, and state. |
| get_build_resultsA | Get detailed results of a build. Optionally includes tests, artifacts, changes, statistics, and dependencies. |
| list_build_artifactsA | List artifact files and directories for a build, optionally browsing into subdirectories. Returns an array of artifact entries with name, path, size, and isDirectory flag. |
| download_build_artifactA | 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. |
| download_build_artifactsA | 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. |
| get_test_detailsC | Get detailed information about test failures. |
| analyze_build_problemsB | Analyze and report build problems and failures. |
| list_changesA | List VCS changes. Supports pagination. |
| list_problemsB | List build problems. Supports pagination. |
| list_problem_occurrencesB | List build problem occurrences. Supports pagination. |
| list_investigationsB | List open investigations. Supports pagination. |
| list_muted_testsB | List muted tests. Supports pagination. |
| list_branchesA | List branches for a project or build configuration. |
| list_parametersA | List parameters for a build configuration. |
| list_project_hierarchyA | List project hierarchy showing parent-child relationships. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Daghis/teamcity-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server