# Buildkite

SecureOfficial RemoteDevOps & Infrastructure

**Summary:** Official connector to monitor pipelines, builds, jobs, logs, artifacts, and test runs in Buildkite via MCP.

**How Teams Use It:** The Buildkite MCP server enables agents to monitor CI/CD pipelines, trigger and cancel builds, inspect job logs, and analyze test results, making it efficient for automated build management and failure triage workflows.

## Tools

| Tool Name                            | Tool Description                                                                                                                                                                           | Tool Type |
|--------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|
| access_token                         | Get information about the current API access token including its scopes and UUID                                                                                                          | Read      |
| cancel_build                         | Cancel a running build on a Buildkite pipeline                                                                                                                                             | Update    |
| create_build                         | Trigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information                                          | Create    |
| create_cluster                       | Create a new cluster in an organization                                                                                                                                                    | Create    |
| create_cluster_queue                 | Create a new queue in a cluster                                                                                                                                                            | Create    |
| create_pipeline                      | Set up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment                                                                            | Create    |
| current_user                         | Get details about the user account that owns the API token, including name, email, avatar, and account creation date                                                                     | Read      |
| get_artifact                         | Get detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL                                                                       | Read      |
| get_build                            | Get build information including job IDs, names, and states. Use job_state to filter (e.g. 'failed,broken'). Returns enough detail to identify which jobs to investigate with log and artifact tools | Read      |
| get_build_test_engine_runs           | Get test engine runs data for a specific build in Buildkite. This can be used to look up Test Runs.                                                                                      | Read      |
| get_cluster                          | Get detailed information about a specific cluster including its name, description, default queue, and configuration                                                                       | Read      |
| get_cluster_queue                    | Get detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration                                                            | Read      |
| get_failed_executions                | Get failed test executions for a specific test run in Buildkite Test Engine. Optionally get the expanded failure details such as full error messages and stack traces.                      | Read      |
| get_job_env                          | Get the environment variables for a specific job in a Buildkite build                                                                                                                    | Read      |
| get_pipeline                         | Get detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics                                                          | Read      |
| get_test                             | Get a specific test in Buildkite Test Engine. This provides additional metadata for failed test executions                                                                                | Read      |
| get_test_run                         | Get a specific test run in Buildkite Test Engine                                                                                                                                           | Read      |
| list_annotations                     | List all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps                                               | Read      |
| list_artifacts_for_build            | List all artifacts for a build across all jobs, including file details, paths, sizes, MIME types, and download URLs                                                                       | Read      |
| list_artifacts_for_job              | List all artifacts for an individual job, including file details, paths, sizes, MIME types, and download URLs                                                                             | Read      |