Buildkite
Start and cancel Buildkite builds, compare runs, and dig into failing job logs.
Tools
71 available tools
Search the tool definitions captured from the MCP server. The live list can vary with version, deployment, and credentials.
71 tools found.
Access token
Tool name:
access_tokenGet information about the current API access token including its scopes and UUID
Cancel build
Tool name:
cancel_buildCancel a running build on a Buildkite pipeline
Compare builds
Tool name:
compare_buildsCompare step outcomes, final-attempt retry counts and execution/scheduling times between builds in one pipeline.
Create annotation
Tool name:
create_annotationCreate an annotation on a build or specific job.
Create build
Tool name:
create_buildTrigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information
Create cache registry
Tool name:
create_cache_registryCreate a cache registry in a cluster.
Create cluster
Tool name:
create_clusterCreate a new cluster in an organization
Create cluster queue
Tool name:
create_cluster_queueCreate a new queue in a cluster
Create cluster secret
Tool name:
create_cluster_secretCreate cluster secret
Create pipeline
Tool name:
create_pipelineSet up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment
Create pipeline schedule
Tool name:
create_pipeline_scheduleCreate a new pipeline schedule that triggers builds on a cron-driven interval
Create pipeline webhook
Tool name:
create_pipeline_webhookCreate a GitHub webhook for an existing pipeline configured with a compatible Buildkite GitHub App
Current user
Tool name:
current_userGet details about the user account that owns the API token, including name, email, avatar, and account creation date
Get agent
Tool name:
get_agentGet detailed information about a specific agent including its connection state, host details, current job, metadata, and pause status
Get artifact
Tool name:
get_artifactGet a specific artifact by organization, pipeline, build, job, and artifact identifiers.
Get build
Tool name:
get_buildGet a single build with lightweight annotation summaries.
Get build failure summary
Tool name:
get_build_failure_summaryDiagnose a Buildkite build failure in one call.
Get build test engine runs
Tool name:
get_build_test_engine_runsGet test engine runs data for a specific build in Buildkite.
Get cache registry
Tool name:
get_cache_registryGet a cache registry by UUID, including its structured access policy
Get cluster
Tool name:
get_clusterGet detailed information about a specific cluster including its name, description, default queue, and configuration
Get cluster queue
Tool name:
get_cluster_queueGet detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration
Get cluster secret
Tool name:
get_cluster_secretGet cluster secret information
Get failed executions
Tool name:
get_failed_executionsGet failed test executions for a specific test run in Buildkite Test Engine.
Get job
Tool name:
get_jobGet a single job by its UUID.
Get job env
Tool name:
get_job_envGet the environment variables for a specific job in a Buildkite build
Get pipeline
Tool name:
get_pipelineGet detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics
Get pipeline schedule
Tool name:
get_pipeline_scheduleGet detailed information about a single pipeline schedule including its cron expression, target branch, environment variables, enabled state, last failure, and next build time
Get repository connection
Tool name:
get_repository_connectionGet a repository connection's service account, host, and provider rate limit.
Get step upload
Tool name:
get_step_uploadGet a single dynamic pipeline upload including its pipeline definition rendered as YAML (definition_yaml).
Get test
Tool name:
get_testGet a specific test in Buildkite Test Engine, including execution metrics aggregated over a selected time window.
Get test run
Tool name:
get_test_runGet a specific test run in Buildkite Test Engine
List agents
Tool name:
list_agentsList agents in an organization with their connection state, host details, version, current job, and pause status
List annotations
Tool name:
list_annotationsList annotations for a build or a specific job.
List artifacts for build
Tool name:
list_artifacts_for_buildList all artifacts for a build across all jobs, including filenames, paths, sizes, and MIME types.
List artifacts for job
Tool name:
list_artifacts_for_jobList all artifacts for an individual job, including filenames, paths, sizes, and MIME types.
List builds
Tool name:
list_buildsList builds for a pipeline or across all pipelines in an organization, returning a lightweight summary of each build.
List cache registries
Tool name:
list_cache_registriesList cache registries in a cluster, ordered by slug.
List cluster queues
Tool name:
list_cluster_queuesList all queues in a cluster with their keys, descriptions, dispatch status, and agent configuration
List cluster secrets
Tool name:
list_cluster_secretsList cluster secrets
List clusters
Tool name:
list_clustersList all clusters in an organization with their names, descriptions, default queues, and creation details
List jobs
Tool name:
list_jobsList jobs for a Buildkite build, returning an actionable summary by default.
List pipeline schedules
Tool name:
list_pipeline_schedulesList the pipeline schedules for a pipeline, including cron expression, target branch, environment variables, enabled state, and next scheduled build time
List pipelines
Tool name:
list_pipelinesList all pipelines in an organization with their basic details, build counts, and current status
List repository connections
Tool name:
list_repository_connectionsList an organization's source control repository connections, such as GitHub apps, Bitbucket Server, and GitLab Self-Managed.
List skills
Tool name:
list_skillsList available skill guides that document usage patterns, pitfalls, and workflows for Buildkite MCP tools
List step uploads
Tool name:
list_step_uploadsList the dynamic pipeline uploads (buildkite-agent pipeline upload) a build received, newest first, without their definitions.
List test runs
Tool name:
list_test_runsList all test runs for a test suite in Buildkite Test Engine
List test suites for pipeline
Tool name:
list_test_suites_for_pipelineList the Buildkite Test Engine suites that have recorded at least one run attributed to a pipeline, ordered by creation time.
List tests
Tool name:
list_testsList tests in a Buildkite Test Engine suite with execution metrics aggregated over a selected time window.
List tests for build
Tool name:
list_tests_for_buildList tests and their execution metrics for a Buildkite build.
Load skill
Tool name:
load_skillLoad the full content of a skill guide by name
Pause cluster queue dispatch
Tool name:
pause_cluster_queue_dispatchPause dispatch on a cluster queue, preventing new jobs from being dispatched to agents
Read execution trace
Tool name:
read_execution_traceRead an OpenTelemetry trace summary for a Buildkite Test Engine execution, including category rollups and slowest spans
Read logs
Tool name:
read_logsRead log entries from the file, optionally starting from a specific row number.
Rebuild build
Tool name:
rebuild_buildRebuild/retry an entire build on a Buildkite pipeline
Resume cluster queue dispatch
Tool name:
resume_cluster_queue_dispatchResume dispatch on a paused cluster queue, allowing jobs to be dispatched to agents again
Retry failed jobs
Tool name:
retry_failed_jobsRetry the failed jobs in a build that are safe to retry, and report every job retried or skipped with a reason.
Retry job
Tool name:
retry_jobRetry a specific failed or timed out job in a Buildkite build
Search logs
Tool name:
search_logsSearch log entries using regex patterns with optional context lines.
Set default cache registry
Tool name:
set_default_cache_registrySet a cluster's default cache registry by UUID.
Slowest executions for build
Tool name:
slowest_executions_for_buildList the slowest test executions for a Buildkite build across every visible Test Engine suite, slowest first.
Tail logs
Tool name:
tail_logsShow the last N entries from the log file.
Unblock job
Tool name:
unblock_jobUnblock a blocked job in a Buildkite build to allow it to continue execution
Update cache registry
Tool name:
update_cache_registryUpdate a cache registry by UUID.
Update cluster
Tool name:
update_clusterUpdate an existing cluster's name, description, emoji, color, or default queue
Update cluster queue
Tool name:
update_cluster_queueUpdate an existing cluster queue's description or retry agent affinity
Update pipeline
Tool name:
update_pipelineModify an existing Buildkite pipeline's configuration, repository, settings, or metadata
Update pipeline schedule
Tool name:
update_pipeline_scheduleModify an existing pipeline schedule's cron expression, branch, environment variables, or enabled state
User token organization
Tool name:
user_token_organizationGet the organization associated with the user token used for this request
Validate pipeline
Tool name:
validate_pipelineValidate Buildkite pipeline YAML against the official pipeline schema without calling the Buildkite API.
Wait for build
Tool name:
wait_for_buildWait for a build to reach a terminal state (passed, failed, canceled, skipped, not_run, or blocked on a block step), polling for up to 45 seconds.
Compatibility
Connect Buildkite to the clients your teams already use
27 AI clients can connect to Buildkite through Runlayer. Pick one for its setup steps and controls.
Why Runlayer
Why connect Buildkite through Runlayer?
One approved path
Approve Buildkite once and everyone gets it in the AI clients they already use. Runlayer holds the credentials, so nothing sits in client configuration.
Fine-grained policy
Control who can use each server, tool, and resource, and under which runtime conditions.
Runtime security
Scan tool inputs and outputs for prompt injection, credential exposure, PII, and data exfiltration, then alert, mask, or block.
Audit and observability
Trace every request across users, clients, tools, policies, scanner decisions, and downstream systems.
