mcp/buildkite

Verified Publisher

By mcp

•Updated 15 days ago

Buildkite MCP lets agents interact with Buildkite Builds, Jobs, Logs, Packages and Test Suites

Image

Machine learning & AI

9.3K

View on MCP:Hub

Overview Tags

mcp/buildkite repository overview

⁠Buildkite MCP Server

Buildkite MCP lets agents interact with Buildkite Builds, Jobs, Logs, Packages and Test Suites.

What is an MCP Server?⁠

⁠MCP Info

Attribute	Details
Docker Image	mcp/buildkite⁠
Author	buildkite⁠
Repository	https://github.com/buildkite/buildkite-mcp-server⁠

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/buildkite/buildkite-mcp-server/blob/4f160065488644ac90552e728907d319c46a43df/Dockerfile.local⁠
Commit	`4f160065488644ac90552e728907d319c46a43df`
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/buildkite --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	MIT License

⁠Available Tools (24)

Tools provided by this Server	Short Description
`access_token`	Get Access Token
`create_build`	Create Build
`create_pipeline`	Create Pipeline
`current_user`	Get Current User
`get_artifact`	Get Artifact
`get_build`	Get Build
`get_build_test_engine_runs`	Get Build Test Engine Runs
`get_cluster`	Get Cluster
`get_cluster_queue`	Get Cluster Queue
`get_failed_executions`	Get Failed Test Executions
`get_job_logs`	Get Job Logs
`get_jobs`	Get Jobs
`get_pipeline`	Get Pipeline
`get_test`	Get Test
`get_test_run`	Get Test Run
`list_annotations`	List Annotations
`list_artifacts`	Artifact List
`list_builds`	List Builds
`list_cluster_queues`	List Cluster Queues
`list_clusters`	List Clusters
`list_pipelines`	List Pipelines
`list_test_runs`	List Test Runs
`update_pipeline`	Update Pipeline
`user_token_organization`	Get Organization for User Token

⁠Tools Details

⁠Tool: `access_token`

Get information about the current API access token including its scopes and UUID

⁠Tool: `create_build`

Trigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information

Parameters	Type	Description
`branch`	`string`	The branch to build
`commit`	`string`	The commit SHA to build
`message`	`string`	The commit message for the build
`org_slug`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline
`environment`	`array` optional	Environment variables to set for the build
`metadata`	`array` optional	Meta-data values to set for the build

⁠Tool: `create_pipeline`

Set up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment

Parameters	Type	Description
`cluster_id`	`string`	The ID value of the cluster the pipeline will be associated with
`configuration`	`string`	The pipeline configuration in YAML format. Contains the build steps and pipeline settings. If not provided, a basic configuration will be used
`name`	`string`	The name of the pipeline
`org_slug`	`string`	The organization slug for the owner of the pipeline. This is used to determine where to create the pipeline
`repository_url`	`string`	The Git repository URL to use for the pipeline
`cancel_running_branch_builds`	`boolean` optional	Cancel running builds when new builds are created on the same branch
`default_branch`	`string` optional	The default branch for builds and metrics filtering
`description`	`string` optional	The description of the pipeline
`skip_queued_branch_builds`	`boolean` optional	Skip intermediate builds when new builds are created on the same branch
`tags`	`array` optional	Tags to apply to the pipeline. These can be used for filtering and organization

⁠Tool: `current_user`

Get details about the user account that owns the API token, including name, email, avatar, and account creation date

⁠Tool: `get_artifact`

Get detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL

Parameters	Type	Description
`url`	`string`	The URL of the artifact to get

This tool is read-only. It does not modify its environment.

⁠Tool: `get_build`

Get detailed information about a specific build including its jobs, timing, and execution details

Parameters	Type	Description
`build_number`	`string`	The number of the build
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline

This tool is read-only. It does not modify its environment.

⁠Tool: `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.

Parameters	Type	Description
`build_number`	`string`	The number of the build
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline

This tool is read-only. It does not modify its environment.

⁠Tool: `get_cluster`

Get detailed information about a specific cluster including its name, description, default queue, and configuration

Parameters	Type	Description
`cluster_id`	`string`	The id of the cluster
`org`	`string`	The organization slug for the owner of the pipeline

This tool is read-only. It does not modify its environment.

⁠Tool: `get_cluster_queue`

Get detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration

Parameters	Type	Description
`cluster_id`	`string`	The id of the cluster
`org`	`string`	The organization slug for the owner of the pipeline
`queue_id`	`string`	The id of the queue

This tool is read-only. It does not modify its environment.

⁠Tool: `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.

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the test suite
`run_id`	`string`	The ID of the test run
`test_suite_slug`	`string`	The slug of the test suite the run belongs to
`include_failure_expanded`	`boolean` optional	Include the expanded failure details such as full error messages and stack traces. This can be used to explain and diganose the cause of test failures.
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `get_job_logs`

Get the log output and metadata for a specific job, including content, size, and header timestamps. Automatically saves to file for large logs to avoid token limits.

Parameters	Type	Description
`build_number`	`string`	The build number
`job_uuid`	`string`	The UUID of the job
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline

⁠Tool: `get_jobs`

Get all jobs for a specific build including their state, timing, commands, and execution details

Parameters	Type	Description
`build_number`	`string`	The number of the build
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline
`include_agent`	`boolean` optional	Include detailed agent information in the response. When false (default), only agent ID is included to reduce response size.
`job_state`	`string` optional	Filter jobs by state. Supports actual states (scheduled, running, passed, failed, canceled, skipped, etc.)
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 50)

This tool is read-only. It does not modify its environment.

⁠Tool: `get_pipeline`

Get detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline

This tool is read-only. It does not modify its environment.

⁠Tool: `get_test`

Get a specific test in Buildkite Test Engine. This provides additional metadata for failed test executions

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the test suite
`test_id`	`string`	The ID of the test
`test_suite_slug`	`string`	The slug of the test suite

This tool is read-only. It does not modify its environment.

⁠Tool: `get_test_run`

Get a specific test run in Buildkite Test Engine

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the test suite
`run_id`	`string`	The ID of the test run
`test_suite_slug`	`string`	The slug of the test suite

This tool is read-only. It does not modify its environment.

⁠Tool: `list_annotations`

List all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps

Parameters	Type	Description
`build_number`	`string`	The build number
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `list_artifacts`

List all artifacts for a build across all jobs, including file details, paths, sizes, MIME types, and download URLs

Parameters	Type	Description
`build_number`	`string`	The build number
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline

This tool is read-only. It does not modify its environment.

⁠Tool: `list_builds`

List all builds for a pipeline with their status, commit information, and metadata

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the pipeline
`pipeline_slug`	`string`	The slug of the pipeline
`branch`	`string` optional	Filter builds by git branch name
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `list_cluster_queues`

List all queues in a cluster with their keys, descriptions, dispatch status, and agent configuration

Parameters	Type	Description
`cluster_id`	`string`	The id of the cluster
`org`	`string`	The organization slug for the owner of the pipeline
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `list_clusters`

List all clusters in an organization with their names, descriptions, default queues, and creation details

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the pipeline
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `list_pipelines`

List all pipelines in an organization with their basic details, build counts, and current status

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the pipeline
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `list_test_runs`

List all test runs for a test suite in Buildkite Test Engine

Parameters	Type	Description
`org`	`string`	The organization slug for the owner of the test suite
`test_suite_slug`	`string`	The slug of the test suite
`page`	`number` optional	Page number for pagination (min 1)
`perPage`	`number` optional	Results per page for pagination (min 1, max 100)

This tool is read-only. It does not modify its environment.

⁠Tool: `update_pipeline`

Modify an existing Buildkite pipeline's configuration, repository, settings, or metadata

Parameters	Type	Description
`org_slug`	`string`	The organization slug for the owner of the pipeline. This is used to determine where to update the pipeline
`pipeline_slug`	`string`	The slug of the pipeline to update
`cancel_running_branch_builds`	`boolean` optional	Cancel running builds when new builds are created on the same branch
`cluster_id`	`string` optional	The ID value of the cluster the pipeline will be associated with
`configuration`	`string` optional	The pipeline configuration in YAML format. Contains the build steps and pipeline settings. If not provided, the existing configuration will be used
`default_branch`	`string` optional	The default branch for builds and metrics filtering
`description`	`string` optional	The description of the pipeline
`name`	`string` optional	The name of the pipeline
`repository_url`	`string` optional	The Git repository URL to use for the pipeline
`skip_queued_branch_builds`	`boolean` optional	Skip intermediate builds when new builds are created on the same branch
`tags`	`array` optional	Tags to apply to the pipeline. These can be used for filtering and organization

⁠Tool: `user_token_organization`

Get the organization associated with the user token used for this request

⁠Use this MCP Server

{
  "mcpServers": {
    "buildkite": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "mcp/buildkite"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "bkua_xxxxx"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Install from MCP:Hub

Buildkite

View and Install from MCP:Hub

Tag summary

Recent tags

Content type

Image

Digest

sha256:00e13d174…

Size

28.7 MB

Last updated

15 days ago

docker pull mcp/buildkite

This week's pulls

Pulls:

1,040

Last week

Learn more⁠

mcp/buildkite

mcp/buildkite repository overview

⁠Buildkite MCP Server

⁠MCP Info

⁠Image Building Info

⁠Available Tools (24)

⁠Tools Details

⁠Tool: access_token

⁠Tool: create_build

⁠Tool: create_pipeline

⁠Tool: current_user

⁠Tool: get_artifact

⁠Tool: get_build

⁠Tool: get_build_test_engine_runs

⁠Tool: get_cluster

⁠Tool: get_cluster_queue

⁠Tool: get_failed_executions

⁠Tool: get_job_logs

⁠Tool: get_jobs

⁠Tool: get_pipeline

⁠Tool: get_test

⁠Tool: get_test_run

⁠Tool: list_annotations

⁠Tool: list_artifacts

⁠Tool: list_builds

⁠Tool: list_cluster_queues

⁠Tool: list_clusters

⁠Tool: list_pipelines

⁠Tool: list_test_runs

⁠Tool: update_pipeline

⁠Tool: user_token_organization

⁠Use this MCP Server

Install from MCP:Hub

Buildkite

Tag summary

This week's pulls

⁠Tool: `access_token`

⁠Tool: `create_build`

⁠Tool: `create_pipeline`

⁠Tool: `current_user`

⁠Tool: `get_artifact`

⁠Tool: `get_build`

⁠Tool: `get_build_test_engine_runs`

⁠Tool: `get_cluster`

⁠Tool: `get_cluster_queue`

⁠Tool: `get_failed_executions`

⁠Tool: `get_job_logs`

⁠Tool: `get_jobs`

⁠Tool: `get_pipeline`

⁠Tool: `get_test`

⁠Tool: `get_test_run`

⁠Tool: `list_annotations`

⁠Tool: `list_artifacts`

⁠Tool: `list_builds`

⁠Tool: `list_cluster_queues`

⁠Tool: `list_clusters`

⁠Tool: `list_pipelines`

⁠Tool: `list_test_runs`

⁠Tool: `update_pipeline`

⁠Tool: `user_token_organization`