Teamcity

Count enabled agents compatible with a build type.

Create a new build configuration. Returns the created configuration (id and name); returns 409 if a configuration with the same id already exists.

Create a new TeamCity project. Returns the created project (id and name); returns 409 if a project with the same id already exists.

Create a new VCS root. Returns the created VCS root id; returns 409 if a VCS root with the same id already exists.

Delete an output parameter from a build configuration. Idempotent; returns 404 if the configuration is unknown.

Delete a parameter from a build configuration. Idempotent; returns 404 if the configuration is unknown.

Delete a TeamCity project. Irreversible; returns 404 if the project does not exist.

Delete a parameter from a project. Idempotent; returns 404 if the project does not exist.

Delete an SSH key from a project. Idempotent; returns 404 if the project or key is unknown.

Delete a single VCS root property. Idempotent; returns 404 if the VCS root is unknown.

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 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.

Fetch a build log. Supports line-based pagination and streaming output.

Get an agent's enabled/disabled state, including comment and switch time.

Get details of a specific build. Works for queued, running, and finished builds.

Get details of a build configuration.

Get detailed results of a build. Optionally includes tests, artifacts, changes, statistics, and dependencies.

Get build status. Optionally includes test and problem summaries plus queue context.

List agents compatible with a build type. Optionally filters to enabled agents only.

List agents compatible with a queued or running build. Optionally filters to enabled agents only.

List build types compatible with the specified agent.

List build types incompatible with the specified agent.

Get the current MCP mode. Dev mode is read-only; full mode enables all operations.

Get details of a specific project.

Get a single server health item by locator.

Get TeamCity server info including version, build number, and state.

Fetch TeamCity server metrics (CPU, memory, disk, load) when available.

Get detailed information about test failures.

Get details of a VCS root, including its properties.

Get Versioned Settings status for a project locator.

List agent pools. Supports pagination.

List build agents. Supports pagination.

List branches for a project or build configuration.

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.

List build configurations. Supports pagination and locator filtering.

List TeamCity builds. Supports pagination and locator filtering.

List VCS changes. Supports pagination.

List open investigations. Supports pagination.

List muted tests. Supports pagination.

List output parameters for a build configuration.

List parameters for a build configuration.

List build problem occurrences. Supports pagination.

List build problems. Supports pagination.

List project hierarchy showing parent-child relationships.

List parameters for a project.

List SSH keys configured for a project.

List TeamCity projects. Supports pagination and locator filtering.

List queued builds. Supports TeamCity queue locator filtering and pagination.

List defined roles and their permissions.

List server health items (warnings and errors). Useful for readiness checks.

List test failures for a build. Supports pagination.

List TeamCity users. Supports pagination.

List VCS roots. Supports pagination.

Add, update, or delete agent requirements for a build configuration. Returns the affected requirement or a delete confirmation; returns 404 if the configuration or requirement id is unknown.

Add, update, or delete artifact and snapshot dependencies for a build configuration. Returns the affected dependency or a delete confirmation; returns 404 if the configuration or dependency id is unknown.

Add, update, or delete build features such as ssh-agent or requirements enforcement. Returns the affected feature or a delete confirmation; returns 404 if the configuration or feature id is unknown.

Add, update, or delete build steps. Returns the affected step or a delete confirmation; returns 404 if the configuration or step id is unknown.

Add, update, or delete build triggers. Returns the affected trigger or a delete confirmation; returns 404 if the configuration or trigger id is unknown.

Move a queued build to the top of the queue. Idempotent; returns 404 if the build is no longer queued.

Mute tests within a project or build configuration scope. Returns the created mute id; returns 404 if the scope id is unknown.

Pause queue processing by disabling all agents in a pool, optionally cancelling queued builds for a build type. Returns counts of agents disabled and builds cancelled; returns 404 if the pool is unknown.

Test MCP server connectivity. Returns a confirmation echo and optional message.

Remove a build agent from the TeamCity server, useful for cleaning up disconnected or ghost agent entries. Idempotent; returns 404 if the agent is unknown.

Reorder queued builds by providing the desired sequence of IDs. Returns the new queue order; returns 404 if any build id is no longer queued.

Resume queue processing by re-enabling all agents in a pool. Returns the count of agents re-enabled; returns 404 if the pool is unknown.

Enable or disable an agent, with optional comment and schedule. Returns the new enabled state; returns 404 if the agent is unknown.

Enable or disable a build configuration by toggling its paused flag. Returns the new paused state; returns 404 if the configuration is unknown.

Pause or unpause a list of build configurations, optionally cancelling their queued builds. Returns the count of configurations updated; returns 404 if any configuration is unknown.

Switch MCP mode at runtime. Returns previous and current modes with the updated tool count; idempotent and notifies clients of the list change.

Set a single VCS root property such as branch, branchSpec, or url. Returns the updated value; returns 404 if the VCS root or property is unknown.

Trigger a new build; runs asynchronously, use `wait_for_build` to monitor. Returns the queued build id; returns 404 if buildTypeId is unknown.

Update build configuration settings. Returns the updated configuration; returns 404 if the configuration is unknown.

Update an output parameter in a build configuration. Returns the updated parameter; returns 404 if the configuration or parameter name is unknown.

Update a build configuration parameter. Returns the updated parameter; returns 404 if the configuration or parameter name is unknown.

Update a project parameter. Returns the updated parameter; returns 404 if the project or parameter name is unknown.

Update project settings and parameters. Returns the updated project; returns 404 if the project does not exist.

Update common VCS root properties in a single call. Returns the updated VCS root; returns 404 if the VCS root is unknown.

Upload an SSH key to a project; provide either privateKeyContent or privateKeyPath, not both. Returns the uploaded key's name; returns 404 if the project does not exist.

Wait for a build to reach a terminal state (finished, canceled, failed). Long-running; polls until completion or timeout.