Summary
Connects to the Buildkite API to surface your CI/CD data directly in Claude. You get access to pipelines, builds, jobs, and test analytics without switching contexts. Useful when debugging failing builds, investigating flaky tests, or checking deployment status during development conversations. The server runs in a container built on Chainguard's minimal static image for security. Buildkite maintains this officially, so it tracks their API changes. If you're already using Buildkite for CI/CD and want your AI assistant to help troubleshoot pipeline issues or query build history, this bridges that gap cleanly.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
33 tools
access_tokenGet information about the current API access token including its scopes and UUID
Get information about the current API access token including its scopes and UUID
No parameter schema in public metadata yet.
create_buildTrigger 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
Parameters* required
branchstringcommitstringThe commit SHA to build
messagestringmetadataarrayMeta-data values to set for the build
org_slugstringenvironmentarrayEnvironment variables to set for the build
pipeline_slugstringignore_branch_filtersbooleanWhether to ignore branch filters when triggering the build
create_clusterCreate a new cluster in an organization5 params
Create a new cluster in an organization
Parameters* required
namestringcolorstringHex color code for the cluster (e.g. #A9CCE3)
emojistringEmoji for the cluster (e.g. :toolbox:)
org_slugstringdescriptionstringDescription of the cluster
create_cluster_queueCreate a new queue in a cluster4 params
Create a new queue in a cluster
Parameters* required
keystringorg_slugstringcluster_idstringdescriptionstringDescription of the queue
create_pipelineSet 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
Parameters* required
namestringtagsarrayTags to apply to the pipeline for filtering and organization
org_slugstringcluster_idstringThe cluster ID to assign the pipeline to
descriptionstringconfigurationstringThe pipeline configuration in YAML format
create_webhookbooleanCreate a GitHub webhook to trigger builds on pull-request and push events
default_branchstringThe default branch for builds and metrics filtering
repository_urlstringThe Git repository URL
skip_queued_branch_buildsbooleanSkip intermediate builds when new builds are created on the same branch
cancel_running_branch_buildsbooleanCancel running builds when new builds are created on the same branch
current_userGet details about the user account that owns the API token, including name, email, avatar, and account creation date
Get details about the user account that owns the API token, including name, email, avatar, and account creation date
No parameter schema in public metadata yet.
get_artifactGet detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL1 params
Get detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL
Parameters* required
urlstringget_buildGet 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 tools6 params
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
Parameters* required
org_slugstringjob_statestringFilter jobs by state. Comma-separated for multiple states (e.g.\, 'failed\,broken\,canceled')
build_numberstringdetail_levelstringResponse detail level: 'detailed' (default) or 'full'. Detailed includes job IDs/names/states; full includes complete job objects
include_agentbooleanInclude full agent details in job objects. When false (default)\, only agent.id is included
pipeline_slugstringget_build_test_engine_runsGet 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.
Parameters* required
org_slugstringbuild_numberstringpipeline_slugstringget_clusterGet 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
Parameters* required
org_slugstringcluster_idstringget_cluster_queueGet 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
Parameters* required
org_slugstringqueue_idstringcluster_idstringget_failed_executionsGet 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.
Parameters* required
pageintegerPage number for pagination (min 1)
run_idstringorg_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
test_suite_slugstringinclude_failure_expandedbooleanInclude expanded failure details such as full error messages and stack traces
get_pipelineGet 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
Parameters* required
org_slugstringdetail_levelstringResponse detail level: 'summary'\, 'detailed'\, or 'full' (default)
pipeline_slugstringget_testGet 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
Parameters* required
test_idstringorg_slugstringtest_suite_slugstringget_test_runGet a specific test run in Buildkite Test Engine3 params
Get a specific test run in Buildkite Test Engine
Parameters* required
run_idstringorg_slugstringtest_suite_slugstringlist_annotationsList all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps5 params
List all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps
Parameters* required
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
build_numberstringpipeline_slugstringlist_artifacts_for_buildList 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
Parameters* required
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
build_numberstringpipeline_slugstringlist_artifacts_for_jobList 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
Parameters* required
pageintegerPage number for pagination (min 1)
job_idstringorg_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
build_numberstringpipeline_slugstringlist_buildsList builds for a pipeline or across all pipelines in an organization. When pipeline_slug is omitted, lists builds across all pipelines in the organization9 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
Parameters* required
pageintegerPage number for pagination (min 1)
statestringFilter builds by state (scheduled\, running\, passed\, failed\, canceled\, skipped)
branchstringFilter builds by git branch name
commitstringFilter builds by specific commit SHA
creatorstringFilter builds by build creator
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
detail_levelstringResponse detail level: 'summary' (default)\, 'detailed'\, or 'full'
pipeline_slugstringFilter builds by pipeline. When omitted\, lists builds across all pipelines in the organization
list_cluster_queuesList 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
Parameters* required
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
cluster_idstringlist_clustersList 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
Parameters* required
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
list_pipelinesList 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
Parameters* required
namestringFilter pipelines by name
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
repositorystringFilter pipelines by repository URL
detail_levelstringResponse detail level: 'summary' (default)\, 'detailed'\, or 'full'
list_test_runsList all test runs for a test suite in Buildkite Test Engine4 params
List all test runs for a test suite in Buildkite Test Engine
Parameters* required
pageintegerPage number for pagination (min 1)
org_slugstringper_pageintegerResults per page for pagination (min 1\, max 100)
test_suite_slugstringpause_cluster_queue_dispatchPause 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
Parameters* required
notestringReason for pausing dispatch
org_slugstringqueue_idstringcluster_idstringread_logsRead 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 fo...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 fo...
Parameters* required
seekintegerlimitintegerjob_idstringorg_slugstringcache_ttlstringbuild_numberstringforce_refreshbooleanpipeline_slugstringresume_cluster_queue_dispatchResume 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
Parameters* required
org_slugstringqueue_idstringcluster_idstringsearch_logsSearch 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}.
Parameters* required
limitintegerjob_idstringcontextintegerpatternstringreversebooleanorg_slugstringcache_ttlstringseek_startintegerbuild_numberstringinvert_matchbooleanafter_contextintegerforce_refreshbooleanpipeline_slugstringbefore_contextintegercase_sensitivebooleantail_logsShow 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}.
Parameters* required
tailintegerjob_idstringorg_slugstringcache_ttlstringbuild_numberstringforce_refreshbooleanpipeline_slugstringunblock_jobUnblock 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
Parameters* required
fieldsobjectJSON object containing string values for block step fields
job_idstringorg_slugstringbuild_numberstringpipeline_slugstringupdate_clusterUpdate an existing cluster's name, description, emoji, color, or default queue7 params
Update an existing cluster's name, description, emoji, color, or default queue
Parameters* required
namestringNew name for the cluster
colorstringNew hex color code for the cluster
emojistringNew emoji for the cluster
org_slugstringcluster_idstringdescriptionstringNew description for the cluster
default_queue_idstringID of the default queue for the cluster
update_cluster_queueUpdate an existing cluster queue's description or retry agent affinity5 params
Update an existing cluster queue's description or retry agent affinity
Parameters* required
org_slugstringqueue_idstringcluster_idstringdescriptionstringNew description for the queue
retry_agent_affinitystringAgent retry affinity: prefer-warmest or prefer-different
update_pipelineModify an existing Buildkite pipeline's configuration, repository, settings, or metadata11 params
Modify an existing Buildkite pipeline's configuration, repository, settings, or metadata
Parameters* required
namestringtagsarrayTags to apply to the pipeline for filtering and organization
org_slugstringcluster_idstringdescriptionstringconfigurationstringThe pipeline configuration in YAML format
pipeline_slugstringdefault_branchstringThe default branch for builds and metrics filtering
repository_urlstringThe Git repository URL
skip_queued_branch_buildsbooleanSkip intermediate builds when new builds are created on the same branch
cancel_running_branch_buildsbooleanCancel running builds when new builds are created on the same branch
user_token_organizationGet the organization associated with the user token used for this request
Get the organization associated with the user token used for this request
No parameter schema in public metadata yet.
buildkite-mcp-server
Model Context Protocol (MCP) server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.
Full documentation is available at buildkite.com/docs/apis/mcp-server.
Library Usage
The exported Go API of this module should be considered unstable, and subject to breaking changes as we evolve this project.
Security
To ensure the MCP server is run in a secure environment, we recommend running it in a container.
This image is built from cgr.dev/chainguard/static and runs as an unprivileged user.
Contributing
Development guidelines are in DEVELOPMENT.md.
License
MIT © Buildkite
SPDX-License-Identifier: MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
BUILDKITE_API_TOKEN*secretBuildkite API token for authentication. Get one from https://buildkite.com/user/api-access-tokens
Categories
Registryactive
Packageghcr.io/buildkite/buildkite-mcp-server:0.7.0
TransportSTDIO
AuthRequired
UpdatedOct 10, 2025
