buildkite-mcp-server
3.4
If you are the rightful owner of buildkite-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Buildkite MCP Server provides access to Buildkite information for tools and editors.
buildkite-mcp-server 🚀
Model Context Protocol (MCP) server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.
⚡ TL;DR Quick-start
# Requires Docker and a Buildkite API token (see scopes below)
docker run -it --rm -e BUILDKITE_API_TOKEN=BKUA_xxxxx ghcr.io/buildkite/buildkite-mcp-server stdio
🗂️ Table of Contents
- Prerequisites
- API Token Scopes
- Installation
- Configuration & Usage
- Features
- Screenshots
- Security
- Contributing
- License
🛠️ Prerequisites
| Requirement | Notes |
|---|---|
| Docker ≥ 20.x | Recommended path – run in an isolated container |
| OR Go ≥ 1.22 | Needed only for building/running natively |
| Buildkite API token | Create at https://buildkite.com/user/api-access-tokens |
Internet access to ghcr.io | To pull the pre-built image |
🔑 API Token Scopes
Full functionality
👉 Quick add: Create token with Full functionality
| Scope | Purpose |
|---|---|
read_clusters | Access cluster & queue information |
read_pipelines | Pipeline configuration |
read_builds | Builds, jobs & annotations |
read_build_logs | Job log output |
read_user | Current user info |
read_organizations | Organization details |
read_artifacts | Build artifacts & metadata |
read_suites | Buildkite Test Engine data |
Minimum recommended
👉 Quick add: Create token with Basic functionality
| Scope | Purpose |
|---|---|
read_builds | Builds, jobs & annotations |
read_pipelines | Pipeline information |
read_user | User identification |
📦 Installation
1. Docker (recommended)
docker pull ghcr.io/buildkite/buildkite-mcp-server
Run:
docker run -it --rm -e BUILDKITE_API_TOKEN=BKUA_xxxxx ghcr.io/buildkite/buildkite-mcp-server stdio
2. Pre-built binary
Download the latest release from GitHub Releases. Binaries are fully-static and require no libc.
3. Build from source
go install github.com/buildkite/buildkite-mcp-server@latest
# or
goreleaser build --snapshot --clean
# or
make build # uses goreleaser (snapshot)
⚙️ Configuration & Usage
Editors & Tools
Claude Desktop
Docker (recommended):
{
"mcpServers": {
"buildkite": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN",
"ghcr.io/buildkite/buildkite-mcp-server", "stdio"
],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Local binary:
{
"mcpServers": {
"buildkite": {
"command": "buildkite-mcp-server",
"args": ["stdio"],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Claude Code
Docker (recommended):
claude mcp add buildkite -- docker run --rm -i -e BUILDKITE_API_TOKEN=bkua_xxxxxxxx ghcr.io/buildkite/buildkite-mcp-server stdio
Local binary:
claude mcp add buildkite --env BUILDKITE_API_TOKEN=bkua_xxxxxxxx -- buildkite-mcp-server stdio
Goose
Docker (recommended):
extensions:
fetch:
name: Buildkite
cmd: docker
args: ["run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN", "ghcr.io/buildkite/buildkite-mcp-server", "stdio"]
enabled: true
envs: { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
type: stdio
timeout: 300
Local binary:
extensions:
fetch:
name: Buildkite
cmd: buildkite-mcp-server
args: [stdio]
enabled: true
envs: { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
type: stdio
timeout: 300
VS Code
{
"inputs": [
{
"id": "BUILDKITE_API_TOKEN",
"type": "promptString",
"description": "Enter your Buildkite Access Token",
"password": true
}
],
"servers": {
"buildkite": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN",
"ghcr.io/buildkite/buildkite-mcp-server", "stdio"
],
"env": { "BUILDKITE_API_TOKEN": "${input:BUILDKITE_API_TOKEN}" }
}
}
}
Windsurf
{
"mcpServers": {
"buildkite": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN",
"ghcr.io/buildkite/buildkite-mcp-server", "stdio"
],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Local binary:
{
"mcpServers": {
"buildkite": {
"command": "buildkite-mcp-server",
"args": ["stdio"],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Zed
- There is a Zed editor extension available in the official extension gallery. During installation it will ask for an API token which will be added to your settings, or you can manually configure:
Zed
// ~/.config/zed/settings.json
{
"context_servers": {
"mcp-server-buildkite": {
"settings": {
"buildkite_api_token": "your-buildkite-token-here"
}
}
}
}
🛠️ Tools & Features
| Tool | Description |
|---|---|
get_cluster | Get detailed information about a specific cluster including its name, description, default queue, and configuration |
list_clusters | List all clusters in an organization with their names, descriptions, default queues, and creation details |
get_cluster_queue | Get detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration |
list_cluster_queues | List all queues in a cluster with their keys, descriptions, dispatch status, and agent configuration |
get_pipeline | Get detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics |
list_pipelines | List all pipelines in an organization with their basic details, build counts, and current status |
create_pipeline | Set up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment |
update_pipeline | Modify an existing Buildkite pipeline's configuration, repository, settings, or metadata |
list_builds | List all builds for a pipeline with their status, commit information, and metadata |
get_build | Get detailed information about a specific build including its jobs, timing, and execution details |
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. |
create_build | Trigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information |
current_user | Get details about the user account that owns the API token, including name, email, avatar, and account creation date |
user_token_organization | Get the organization associated with the user token used for this request |
get_jobs | Get all jobs for a specific build including their state, timing, commands, and execution details |
get_job_logs | Get the log output and metadata for a specific job, including content, size, and header timestamps |
list_artifacts | List all artifacts for a build across all jobs, including file details, paths, sizes, MIME types, and download URLs |
get_artifact | Get detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL |
list_annotations | List all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps |
list_test_runs | List all test runs for a test suite in Buildkite Test Engine |
get_test_run | Get a specific test run in Buildkite Test Engine |
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. |
get_test | Get a specific test in Buildkite Test Engine. This provides additional metadata for failed test executions |
access_token | Get information about the current API access token including its scopes and UUID |
📸 Screenshots
🔒 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 .
Run the test suite:
go test ./...
📝 License
MIT © Buildkite
SPDX-License-Identifier: MIT
