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 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ping | Test MCP server connectivity |
| list_projects | List TeamCity projects (supports pagination) |
| get_project | Get details of a specific project |
| list_builds | List TeamCity builds (supports pagination) |
| get_build | Get details of a specific build |
| trigger_build | Trigger a new build |
| cancel_queued_build | Cancel a queued build by ID |
| get_build_status | Get build status with optional test/problem and queue context details |
| fetch_build_log | Fetch build log with pagination (by lines) |
| list_build_configs | List build configurations (supports pagination) |
| get_build_config | Get details of a build configuration |
| list_test_failures | List test failures for a build (supports pagination) |
| list_vcs_roots | List VCS roots (supports pagination) |
| get_vcs_root | Get details of a VCS root (including properties) |
| list_queued_builds | List queued builds (supports TeamCity queue locator + pagination) |
| get_server_info | Get TeamCity server info (version, build number, state) |
| check_availability_guard | Evaluate server health; returns ok=false if critical health items found (severity ERROR) |
| get_compatible_build_types_for_agent | Get build types compatible with the specified agent |
| get_incompatible_build_types_for_agent | Get build types incompatible with the specified agent |
| get_agent_enabled_info | Get the enabled/disabled state for an agent, including comment and switch time |
| get_compatible_agents_for_build_type | List agents compatible with a build type (optionally filter enabled only) |
| count_compatible_agents_for_build_type | Return only the count of enabled compatible agents for a build type |
| get_compatible_agents_for_queued_build | List agents compatible with a queued/running build by buildId (optionally filter enabled only) |
| check_teamcity_connection | Check connectivity to TeamCity server and basic readiness |
| list_agents | List build agents (supports pagination) |
| list_agent_pools | List agent pools (supports pagination) |
| get_build_results | Get detailed results of a build including tests, artifacts, changes, and statistics |
| get_test_details | Get detailed information about test failures |
| analyze_build_problems | Analyze and report build problems and failures |
| list_changes | List VCS changes (supports pagination) |
| list_problems | List build problems (supports pagination) |
| list_problem_occurrences | List problem occurrences (supports pagination) |
| list_investigations | List open investigations (supports pagination) |
| list_muted_tests | List muted tests (supports pagination) |
| get_versioned_settings_status | Get Versioned Settings status for a locator |
| list_users | List TeamCity users (supports pagination) |
| list_roles | List defined roles and their permissions |
| list_branches | List branches for a project or build configuration |
| list_parameters | List parameters for a build configuration |
| list_project_hierarchy | List project hierarchy showing parent-child relationships |