Skip to main content

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_token

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

  • Cancel build

    Tool name: cancel_build

    Cancel a running build on a Buildkite pipeline

  • Compare builds

    Tool name: compare_builds

    Compare step outcomes, final-attempt retry counts and execution/scheduling times between builds in one pipeline.

  • Create annotation

    Tool name: create_annotation

    Create an annotation on a build or specific job.

  • Create build

    Tool name: 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 cache registry

    Tool name: create_cache_registry

    Create a cache registry in a cluster.

  • Create cluster

    Tool name: create_cluster

    Create a new cluster in an organization

  • Create cluster queue

    Tool name: create_cluster_queue

    Create a new queue in a cluster

  • Create cluster secret

    Tool name: create_cluster_secret

    Create cluster secret

  • Create pipeline

    Tool name: create_pipeline

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

  • Create pipeline schedule

    Tool name: create_pipeline_schedule

    Create a new pipeline schedule that triggers builds on a cron-driven interval

  • Create pipeline webhook

    Tool name: create_pipeline_webhook

    Create a GitHub webhook for an existing pipeline configured with a compatible Buildkite GitHub App

  • Current user

    Tool name: current_user

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

  • Get agent

    Tool name: get_agent

    Get detailed information about a specific agent including its connection state, host details, current job, metadata, and pause status

  • Get artifact

    Tool name: get_artifact

    Get a specific artifact by organization, pipeline, build, job, and artifact identifiers.

  • Get build

    Tool name: get_build

    Get a single build with lightweight annotation summaries.

  • Get build failure summary

    Tool name: get_build_failure_summary

    Diagnose a Buildkite build failure in one call.

  • Get build test engine runs

    Tool name: get_build_test_engine_runs

    Get test engine runs data for a specific build in Buildkite.

  • Get cache registry

    Tool name: get_cache_registry

    Get a cache registry by UUID, including its structured access policy

  • Get cluster

    Tool name: get_cluster

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

  • Get cluster queue

    Tool name: get_cluster_queue

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

  • Get cluster secret

    Tool name: get_cluster_secret

    Get cluster secret information

  • Get failed executions

    Tool name: get_failed_executions

    Get failed test executions for a specific test run in Buildkite Test Engine.

  • Get job

    Tool name: get_job

    Get a single job by its UUID.

  • Get job env

    Tool name: get_job_env

    Get the environment variables for a specific job in a Buildkite build

  • Get pipeline

    Tool name: get_pipeline

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

  • Get pipeline schedule

    Tool name: get_pipeline_schedule

    Get 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_connection

    Get a repository connection's service account, host, and provider rate limit.

  • Get step upload

    Tool name: get_step_upload

    Get a single dynamic pipeline upload including its pipeline definition rendered as YAML (definition_yaml).

  • Get test

    Tool name: get_test

    Get a specific test in Buildkite Test Engine, including execution metrics aggregated over a selected time window.

  • Get test run

    Tool name: get_test_run

    Get a specific test run in Buildkite Test Engine

  • List agents

    Tool name: list_agents

    List agents in an organization with their connection state, host details, version, current job, and pause status

  • List annotations

    Tool name: list_annotations

    List annotations for a build or a specific job.

  • List artifacts for build

    Tool name: list_artifacts_for_build

    List all artifacts for a build across all jobs, including filenames, paths, sizes, and MIME types.

  • List artifacts for job

    Tool name: list_artifacts_for_job

    List all artifacts for an individual job, including filenames, paths, sizes, and MIME types.

  • List builds

    Tool name: list_builds

    List 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_registries

    List cache registries in a cluster, ordered by slug.

  • List cluster queues

    Tool name: list_cluster_queues

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

  • List cluster secrets

    Tool name: list_cluster_secrets

    List cluster secrets

  • List clusters

    Tool name: list_clusters

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

  • List jobs

    Tool name: list_jobs

    List jobs for a Buildkite build, returning an actionable summary by default.

  • List pipeline schedules

    Tool name: list_pipeline_schedules

    List 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_pipelines

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

  • List repository connections

    Tool name: list_repository_connections

    List an organization's source control repository connections, such as GitHub apps, Bitbucket Server, and GitLab Self-Managed.

  • List skills

    Tool name: list_skills

    List available skill guides that document usage patterns, pitfalls, and workflows for Buildkite MCP tools

  • List step uploads

    Tool name: list_step_uploads

    List the dynamic pipeline uploads (buildkite-agent pipeline upload) a build received, newest first, without their definitions.

  • List test runs

    Tool name: list_test_runs

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

  • List test suites for pipeline

    Tool name: list_test_suites_for_pipeline

    List 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_tests

    List 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_build

    List tests and their execution metrics for a Buildkite build.

  • Load skill

    Tool name: load_skill

    Load the full content of a skill guide by name

  • Pause cluster queue dispatch

    Tool name: pause_cluster_queue_dispatch

    Pause dispatch on a cluster queue, preventing new jobs from being dispatched to agents

  • Read execution trace

    Tool name: read_execution_trace

    Read an OpenTelemetry trace summary for a Buildkite Test Engine execution, including category rollups and slowest spans

  • Read logs

    Tool name: read_logs

    Read log entries from the file, optionally starting from a specific row number.

  • Rebuild build

    Tool name: rebuild_build

    Rebuild/retry an entire build on a Buildkite pipeline

  • Resume cluster queue dispatch

    Tool name: resume_cluster_queue_dispatch

    Resume dispatch on a paused cluster queue, allowing jobs to be dispatched to agents again

  • Retry failed jobs

    Tool name: retry_failed_jobs

    Retry 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_job

    Retry a specific failed or timed out job in a Buildkite build

  • Search logs

    Tool name: search_logs

    Search log entries using regex patterns with optional context lines.

  • Set default cache registry

    Tool name: set_default_cache_registry

    Set a cluster's default cache registry by UUID.

  • Slowest executions for build

    Tool name: slowest_executions_for_build

    List the slowest test executions for a Buildkite build across every visible Test Engine suite, slowest first.

  • Tail logs

    Tool name: tail_logs

    Show the last N entries from the log file.

  • Unblock job

    Tool name: unblock_job

    Unblock a blocked job in a Buildkite build to allow it to continue execution

  • Update cache registry

    Tool name: update_cache_registry

    Update a cache registry by UUID.

  • Update cluster

    Tool name: update_cluster

    Update an existing cluster's name, description, emoji, color, or default queue

  • Update cluster queue

    Tool name: update_cluster_queue

    Update an existing cluster queue's description or retry agent affinity

  • Update pipeline

    Tool name: update_pipeline

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

  • Update pipeline schedule

    Tool name: update_pipeline_schedule

    Modify an existing pipeline schedule's cron expression, branch, environment variables, or enabled state

  • User token organization

    Tool name: user_token_organization

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

  • Validate pipeline

    Tool name: validate_pipeline

    Validate Buildkite pipeline YAML against the official pipeline schema without calling the Buildkite API.

  • Wait for build

    Tool name: wait_for_build

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

Frequently asked questions