Buildkite MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'buildkitemcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Buildkite MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'buildkitemcp_list_skills',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "buildkitemcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Buildkite MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="buildkitemcp_list_skills",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Build wait for, rebuild, cancel — 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
• Skill load — Load the full content of a skill guide by name
• List tests, skills, jobs — List tests in a Buildkite Test Engine suite with execution metrics aggregated over a selected time window
• Get job, build failure summary, test run — Get a single job by its UUID
• Organization user token — Get the organization associated with the user token used for this request
• Update pipeline schedule, pipeline, cluster queue — Modify an existing pipeline schedule’s cron expression, branch, environment variables, or enabled state

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

buildkitemcp_access_token#Get information about the current API access token including its scopes and UUID0 params▾

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

buildkitemcp_cancel_build#Cancel a running build on a Buildkite pipeline3 params▾

Cancel a running build on a Buildkite pipeline

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_create_annotation#Create an annotation on a build or specific job. Use scope='build' (default) or scope='job' with job_id10 params▾

Create an annotation on a build or specific job. Use scope='build' (default) or scope='job' with job_id

NameTypeRequiredDescription

bodystringrequiredThe annotation body as HTML or Markdown

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

appendbooleanoptionalAppend the body to an existing annotation with the same context

contextstringoptionalOptional annotation context used to identify or append to an annotation

job_idstringoptionalJob ID required when scope is job

priorityintegeroptionalOptional annotation priority from 1 to 10

scopestringoptionalAnnotation scope: 'build' (default) or 'job'. When 'job', job_id is required.

stylestringoptionalOptional annotation style: success, info, warning, or error

buildkitemcp_create_build#Trigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information8 params▾

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

NameTypeRequiredDescription

branchstringrequiredNo description.

commitstringrequiredThe commit SHA to build

messagestringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

environmentstringoptionalEnvironment variables to set for the build

ignore_branch_filtersbooleanoptionalWhether to ignore branch filters when triggering the build

metadatastringoptionalMeta-data values to set for the build

buildkitemcp_create_cluster#Create a new cluster in an organization5 params▾

Create a new cluster in an organization

NameTypeRequiredDescription

namestringrequiredNo description.

org_slugstringrequiredNo description.

colorstringoptionalHex color code for the cluster (e.g. #A9CCE3)

descriptionstringoptionalDescription of the cluster

emojistringoptionalEmoji for the cluster (e.g. :toolbox:)

buildkitemcp_create_cluster_queue#Create a new queue in a cluster4 params▾

Create a new queue in a cluster

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

keystringrequiredNo description.

org_slugstringrequiredNo description.

descriptionstringoptionalDescription of the queue

buildkitemcp_create_pipeline#Set up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment11 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredThe cluster ID to assign the pipeline to

configurationstringrequiredThe pipeline configuration in YAML format

namestringrequiredNo description.

org_slugstringrequiredNo description.

repository_urlstringrequiredThe Git repository URL

cancel_running_branch_buildsbooleanoptionalCancel running builds when new builds are created on the same branch

create_webhookbooleanoptionalCreate a GitHub webhook to trigger builds on pull-request and push events

default_branchstringoptionalThe default branch for builds and metrics filtering

descriptionstringoptionalNo description.

skip_queued_branch_buildsbooleanoptionalSkip intermediate builds when new builds are created on the same branch

tagsstringoptionalTags to apply to the pipeline for filtering and organization

buildkitemcp_create_pipeline_schedule#Create a new pipeline schedule that triggers builds on a cron-driven interval9 params▾

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

NameTypeRequiredDescription

cronlinestringrequiredSchedule interval as a crontab expression (e.g. '0 0 * * *') or predefined value (e.g. '@daily'\, '@hourly'\, '@weekly'\, '@monthly'\, '@yearly')

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

branchstringoptionalTarget branch (defaults to the pipeline default branch)

commitstringoptionalCommit reference (defaults to HEAD)

enabledstringoptionalWhether the schedule is active. Defaults to true if unset.

envobjectoptionalEnvironment variables to set on triggered builds

labelstringoptionalDescriptive label for the schedule

messagestringoptionalMessage attached to triggered builds

buildkitemcp_current_user#Get details about the user account that owns the API token, including name, email, avatar, and account creation date0 params▾

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

buildkitemcp_get_agent#Get detailed information about a specific agent including its connection state, host details, current job, metadata, and pause status3 params▾

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

NameTypeRequiredDescription

agent_idstringrequiredNo description.

org_slugstringrequiredNo description.

detail_levelstringoptionalResponse detail level: 'summary'\, 'detailed'\, or 'full' (default)

buildkitemcp_get_artifact#Download a specific artifact's content, identified by its organization, pipeline, build, job, and artifact identifiers. The content is returned base64-encoded5 params▾

Download a specific artifact's content, identified by its organization, pipeline, build, job, and artifact identifiers. The content is returned base64-encoded

NameTypeRequiredDescription

artifact_idstringrequiredThe UUID of the artifact to download

build_numberstringrequiredNo description.

job_idstringrequiredThe UUID of the job that produced the artifact

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_get_build#Get build information. To inspect that build's jobs (IDs, names, states, filtering by job state), use list_jobs with the build_number instead.3 params▾

Get build information. To inspect that build's jobs (IDs, names, states, filtering by job state), use list_jobs with the build_number instead.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_get_build_failure_summary#Diagnose a Buildkite build failure in one call. Returns build state, terminal problem jobs, downstream failed or broken jobs, promised failures from running jobs, and size-bounded diagnostic content from logs, annotations, and failed Test Engine executions. Start with this tool before calling individual job, log, annotation, or test tools.13 params▾

Diagnose a Buildkite build failure in one call. Returns build state, terminal problem jobs, downstream failed or broken jobs, promised failures from running jobs, and size-bounded diagnostic content from logs, annotations, and failed Test Engine executions. Start with this tool before calling individual job, log, annotation, or test tools.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

include_annotationsbooleanoptionalInclude error and warning annotation bodies (default true)

include_failed_testsbooleanoptionalInclude failed Test Engine executions when the build has Test Engine runs (default true)

include_failure_expandedbooleanoptionalInclude expanded test failure details such as stack traces within the summary's bounded test-content budget

include_logsbooleanoptionalInclude a bounded log tail for failed, timed-out, canceled, and promised-failing jobs (default true)

log_tailintegeroptionalLog lines to include for each failed, timed-out, canceled, or promised-failing job (default 50, max 200)

max_annotationsintegeroptionalMaximum error or warning annotations to return (default 20, max 100); the server scans at most 500 total annotations

max_failed_testsintegeroptionalMaximum failed test executions to return across all Test Engine runs (default 100, max 200)

max_failed_tests_per_runintegeroptionalMaximum failed test executions to return per Test Engine run (default 20, max 100)

max_jobsintegeroptionalMaximum terminal problem or downstream-failed jobs to return (default 10, server may enforce a lower maximum, absolute max 50)

max_test_runsintegeroptionalMaximum Test Engine runs to inspect (default 5, max 20)

buildkitemcp_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.3 params▾

Get test engine runs data for a specific build in Buildkite. This can be used to look up Test Runs.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_get_cluster#Get detailed information about a specific cluster including its name, description, default queue, and configuration2 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

buildkitemcp_get_cluster_queue#Get detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration3 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

queue_idstringrequiredNo description.

buildkitemcp_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.6 params▾

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.

NameTypeRequiredDescription

org_slugstringrequiredNo description.

run_idstringrequiredNo description.

test_suite_slugstringrequiredNo description.

include_failure_expandedbooleanoptionalInclude expanded failure details such as full error messages and stack traces

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_get_job#Get a single job by its UUID. Provide 'pipeline_slug' and 'build_number' for a build-scoped lookup, or omit both to look the job up by organization and job ID alone5 params▾

Get a single job by its UUID. Provide 'pipeline_slug' and 'build_number' for a build-scoped lookup, or omit both to look the job up by organization and job ID alone

NameTypeRequiredDescription

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

build_numberstringoptionalBuild number. Provide together with 'pipeline_slug' for a build-scoped lookup. Omit both to look up the job by organization and job ID alone

include_agentbooleanoptionalInclude full agent details in job objects. When false (default), only agent.id is included

pipeline_slugstringoptionalPipeline slug. Provide together with 'build_number' for a build-scoped lookup. Omit both to look up the job by organization and job ID alone

buildkitemcp_get_job_env#Get the environment variables for a specific job in a Buildkite build4 params▾

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

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_get_pipeline#Get detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics3 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

detail_levelstringoptionalResponse detail level: 'summary'\, 'detailed'\, or 'full' (default)

buildkitemcp_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 time3 params▾

Get detailed information about a single pipeline schedule including its cron expression, target branch, environment variables, enabled state, last failure, and next build time

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

schedule_idstringrequiredNo description.

buildkitemcp_get_test#Get a specific test in Buildkite Test Engine. This provides additional metadata for failed test executions3 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

test_idstringrequiredNo description.

test_suite_slugstringrequiredNo description.

buildkitemcp_get_test_run#Get a specific test run in Buildkite Test Engine3 params▾

Get a specific test run in Buildkite Test Engine

NameTypeRequiredDescription

org_slugstringrequiredNo description.

run_idstringrequiredNo description.

test_suite_slugstringrequiredNo description.

buildkitemcp_list_agents#List agents in an organization with their connection state, host details, version, current job, and pause status7 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

detail_levelstringoptionalResponse detail level: 'summary' (default)\, 'detailed'\, or 'full'

hostnamestringoptionalNo description.

namestringoptionalNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

versionstringoptionalNo description.

buildkitemcp_list_annotations#List annotations for a build or a specific job. Use scope='build' (default) or scope='job' with job_id7 params▾

List annotations for a build or a specific job. Use scope='build' (default) or scope='job' with job_id

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

job_idstringoptionalJob ID required when scope is job

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

scopestringoptionalAnnotation scope: 'build' (default) or 'job'. When 'job', job_id is required.

buildkitemcp_list_artifacts_for_build#List all artifacts for a build across all jobs, including file details, paths, sizes, MIME types, and download URLs5 params▾

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

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_artifacts_for_job#List all artifacts for an individual job, including file details, paths, sizes, MIME types, and download URLs6 params▾

List all artifacts for an individual job, including file details, paths, sizes, MIME types, and download URLs

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_builds#List builds for a pipeline or across all pipelines in an organization. When pipeline_slug is omitted, lists builds across all pipelines in the organization8 params▾

List builds for a pipeline or across all pipelines in an organization. When pipeline_slug is omitted, lists builds across all pipelines in the organization

NameTypeRequiredDescription

org_slugstringrequiredNo description.

branchstringoptionalFilter builds by git branch name

commitstringoptionalFilter builds by specific commit SHA

creatorstringoptionalFilter builds by build creator

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

pipeline_slugstringoptionalFilter builds by pipeline. When omitted\, lists builds across all pipelines in the organization

statestringoptionalFilter builds by state (scheduled\, running\, passed\, failed\, canceled\, skipped)

buildkitemcp_list_cluster_queues#List all queues in a cluster with their keys, descriptions, dispatch status, and agent configuration4 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_clusters#List all clusters in an organization with their names, descriptions, default queues, and creation details3 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_jobs#List jobs for a Buildkite build, returning an actionable summary by default. For CI failure diagnosis, use state='failed,broken' to avoid returning successful jobs. Use detail_level='detailed' for execution metadata or 'full' for the existing full MCP job response. Returns 'items' and cursor pagination 'links'12 params▾

List jobs for a Buildkite build, returning an actionable summary by default. For CI failure diagnosis, use state='failed,broken' to avoid returning successful jobs. Use detail_level='detailed' for execution metadata or 'full' for the existing full MCP job response. Returns 'items' and cursor pagination 'links'

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

afterstringoptionalCursor for the next page. Take this from the 'links.next' URL of a previous response. Mutually exclusive with 'before'

beforestringoptionalCursor for the previous page. Take this from a previous response. Mutually exclusive with 'after'

detail_levelstringoptionalResponse detail level: 'summary' (default), 'detailed', or 'full'

group_keystringoptionalFilter jobs by group key. Includes all jobs in the group

include_agentbooleanoptionalInclude full agent details at the detailed and full levels. When false (default), detailed and full responses include only agent.id

include_retried_jobsbooleanoptionalInclude retried jobs in the response. Defaults to true on the server when omitted

per_pageintegeroptionalResults per page for cursor pagination (min 1, max 100, default 30)

statestringoptionalFilter jobs by state. Comma-separated for multiple states (e.g., 'passed,failed,running')

step_keystringoptionalFilter jobs by step key. Includes all parallel jobs for the step

buildkitemcp_list_pipeline_schedules#List the pipeline schedules for a pipeline, including cron expression, target branch, environment variables, enabled state, and next scheduled build time4 params▾

List the pipeline schedules for a pipeline, including cron expression, target branch, environment variables, enabled state, and next scheduled build time

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_pipelines#List all pipelines in an organization with their basic details, build counts, and current status6 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

detail_levelstringoptionalResponse detail level: 'summary' (default)\, 'detailed'\, or 'full'

namestringoptionalFilter pipelines by name

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

repositorystringoptionalFilter pipelines by repository URL

buildkitemcp_list_skills#List available skill guides that document usage patterns, pitfalls, and workflows for Buildkite MCP tools1 param▾

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

NameTypeRequiredDescription

querystringoptionalOptional case-insensitive filter over skill name and description

buildkitemcp_list_test_runs#List all test runs for a test suite in Buildkite Test Engine4 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

test_suite_slugstringrequiredNo description.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1\, max 100)

buildkitemcp_list_tests#List tests in a Buildkite Test Engine suite with execution metrics aggregated over a selected time window. Supports filtering, metric sorting, and pagination.14 params▾

List tests in a Buildkite Test Engine suite with execution metrics aggregated over a selected time window. Supports filtering, metric sorting, and pagination.

NameTypeRequiredDescription

org_slugstringrequiredNo description.

test_suite_slugstringrequiredNo description.

branchstringoptionalFilter executions included in the metrics by branch. Prefix with '!' to exclude an exact branch or suffix with '*' to match by prefix, for example '!main' or 'feature*'. Use at most one operator.

labelsstringoptionalFilter by comma-separated test labels. Prefix a label with '!' to exclude it, for example 'flaky,!slow'.

max_timestampstringoptionalEnd of the aggregation window in RFC3339 format. Defaults to the current time when omitted.

min_timestampstringoptionalStart of the aggregation window in RFC3339 format. When omitted, defaults to the organization's default Test Engine period before the current time.

orderstringoptionalSort direction: 'asc' or 'desc'. Defaults to 'desc'.

ownersstringoptionalFilter by comma-separated test owner slugs. Prefix an owner with '!' to exclude it, for example 'payments,!platform'.

pageintegeroptionalPage number for pagination (min 1)

per_pageintegeroptionalResults per page for pagination (min 1, max 100)

periodstringoptionalRelative aggregation window, such as '7days' or '28days'. Whether selected by period or timestamps, the aggregation window cannot exceed the organization's maximum Test Engine window. Cannot be combined with min_timestamp or max_timestamp.

sort_bystringoptionalMetric used to sort results: 'duration_avg', 'duration_sum', 'duration_min', 'duration_max', or 'reliability'. Defaults to 'duration_avg'. Metrics cover only executions in the selected window.

statestringoptionalFilter by test state: 'enabled', 'muted', or 'skipped'.

tagsstringoptionalFilter by comma-separated execution tags in key:value form. Values support '!' for exclusion and '*' for prefix matching. Result values additionally support '~' for any matching execution and '^' for every execution matching, for example 'framework:!rspec,scm.branch:feature*,result:^passed'.

buildkitemcp_load_skill#Load the full content of a skill guide by name1 param▾

Load the full content of a skill guide by name

NameTypeRequiredDescription

skill_namestringrequiredName of the skill to load, as returned by list_skills

buildkitemcp_pause_cluster_queue_dispatch#Pause dispatch on a cluster queue, preventing new jobs from being dispatched to agents4 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

queue_idstringrequiredNo description.

notestringoptionalReason for pausing dispatch

buildkitemcp_read_logs#Read log entries from the file, optionally starting from a specific row number. ALWAYS use 'limit' parameter to avoid excessive tokens. For recent failures, use 'tail_logs' instead. Recommended limits: investigation (100-500), exploration (use seek + small limits). The json format: {ts: timestamp_ms, c: content, rn: row_number}.8 params▾

Read log entries from the file, optionally starting from a specific row number. ALWAYS use 'limit' parameter to avoid excessive tokens. For recent failures, use 'tail_logs' instead. Recommended limits: investigation (100-500), exploration (use seek + small limits). The json format: {ts: timestamp_ms, c: content, rn: row_number}.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

cache_ttlstringoptionalNo description.

force_refreshbooleanoptionalNo description.

limitintegeroptionalNo description.

seekintegeroptionalNo description.

buildkitemcp_rebuild_build#Rebuild/retry an entire build on a Buildkite pipeline3 params▾

Rebuild/retry an entire build on a Buildkite pipeline

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_resume_cluster_queue_dispatch#Resume dispatch on a paused cluster queue, allowing jobs to be dispatched to agents again3 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

queue_idstringrequiredNo description.

buildkitemcp_retry_job#Retry a specific failed or timed out job in a Buildkite build4 params▾

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

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

buildkitemcp_search_logs#Search log entries using regex patterns with optional context lines. For recent failures, try 'tail_logs' first, then use search_logs with patterns like 'error|failed|exception' and limit: 10-20. The json format: {ts: timestamp_ms, c: content, rn: row_number}.15 params▾

Search log entries using regex patterns with optional context lines. For recent failures, try 'tail_logs' first, then use search_logs with patterns like 'error|failed|exception' and limit: 10-20. The json format: {ts: timestamp_ms, c: content, rn: row_number}.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

patternstringrequiredNo description.

pipeline_slugstringrequiredNo description.

after_contextintegeroptionalNo description.

before_contextintegeroptionalNo description.

cache_ttlstringoptionalNo description.

case_sensitivebooleanoptionalNo description.

contextintegeroptionalNo description.

force_refreshbooleanoptionalNo description.

invert_matchbooleanoptionalNo description.

limitintegeroptionalNo description.

reversebooleanoptionalNo description.

seek_startintegeroptionalNo description.

buildkitemcp_tail_logs#Show the last N entries from the log file. RECOMMENDED for failure diagnosis - most build failures appear in the final log entries. More token-efficient than read_logs for recent issues. The json format: {ts: timestamp_ms, c: content, rn: row_number}.7 params▾

Show the last N entries from the log file. RECOMMENDED for failure diagnosis - most build failures appear in the final log entries. More token-efficient than read_logs for recent issues. The json format: {ts: timestamp_ms, c: content, rn: row_number}.

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

cache_ttlstringoptionalNo description.

force_refreshbooleanoptionalNo description.

tailintegeroptionalNo description.

buildkitemcp_unblock_job#Unblock a blocked job in a Buildkite build to allow it to continue execution5 params▾

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

NameTypeRequiredDescription

build_numberstringrequiredNo description.

job_idstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

fieldsobjectoptionalJSON object containing string values for block step fields

buildkitemcp_update_cluster#Update an existing cluster's name, description, emoji, color, or default queue7 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

colorstringoptionalNew hex color code for the cluster

default_queue_idstringoptionalID of the default queue for the cluster

descriptionstringoptionalNew description for the cluster

emojistringoptionalNew emoji for the cluster

namestringoptionalNew name for the cluster

buildkitemcp_update_cluster_queue#Update an existing cluster queue's description or retry agent affinity5 params▾

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

NameTypeRequiredDescription

cluster_idstringrequiredNo description.

org_slugstringrequiredNo description.

queue_idstringrequiredNo description.

descriptionstringoptionalNew description for the queue

retry_agent_affinitystringoptionalAgent retry affinity: prefer-warmest or prefer-different

buildkitemcp_update_pipeline#Modify an existing Buildkite pipeline's configuration, repository, settings, or metadata11 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

cancel_running_branch_buildsstringoptionalCancel running builds when new builds are created on the same branch

cluster_idstringoptionalNo description.

configurationstringoptionalThe pipeline configuration in YAML format

default_branchstringoptionalThe default branch for builds and metrics filtering

descriptionstringoptionalNo description.

namestringoptionalNo description.

repository_urlstringoptionalThe Git repository URL

skip_queued_branch_buildsstringoptionalSkip intermediate builds when new builds are created on the same branch

tagsstringoptionalTags to apply to the pipeline for filtering and organization

buildkitemcp_update_pipeline_schedule#Modify an existing pipeline schedule's cron expression, branch, environment variables, or enabled state10 params▾

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

NameTypeRequiredDescription

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.

schedule_idstringrequiredNo description.

branchstringoptionalNo description.

commitstringoptionalNo description.

cronlinestringoptionalSchedule interval as a crontab expression or predefined value

enabledstringoptionalWhether the schedule is active. Re-enabling clears previous failure data.

envobjectoptionalEnvironment variables to set on triggered builds. Providing this field REPLACES the existing env map entirely — include all keys you want to retain.

labelstringoptionalNo description.

messagestringoptionalNo description.

buildkitemcp_user_token_organization#Get the organization associated with the user token used for this request0 params▾

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

buildkitemcp_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. Returns finished=true along with the build once it settles. If the build is still in progress when the window closes it returns finished=false and the current state only, with no build detail — call this tool again to keep waiting. Judge a long build by build_elapsed_seconds, which counts from the build's own start time and does not reset between calls; waited_seconds covers only the latest call. Do not wait indefinitely: after roughly ten consecutive calls, stop and report the build as still running with its elapsed time rather than continuing to poll. Jobs and annotation bodies are never included — use list_jobs or get_job for job detail, and list_annotations to read annotations3 params▾

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. Returns finished=true along with the build once it settles. If the build is still in progress when the window closes it returns finished=false and the current state only, with no build detail — call this tool again to keep waiting. Judge a long build by build_elapsed_seconds, which counts from the build's own start time and does not reset between calls; waited_seconds covers only the latest call. Do not wait indefinitely: after roughly ten consecutive calls, stop and report the build as still running with its elapsed time rather than continuing to poll. Jobs and annotation bodies are never included — use list_jobs or get_job for job detail, and list_annotations to read annotations

NameTypeRequiredDescription

build_numberstringrequiredNo description.

org_slugstringrequiredNo description.

pipeline_slugstringrequiredNo description.