buildkite/mcp-server
Official MCP Server for Buildkite.
Image
Machine learning & AI
Developer tools
0
50K+
buildkite/mcp-server repository overview
ā buildkite-mcp-server š
Model Context Protocol (MCP)ā server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.
ā š ļø Prerequisites
Buildkite API token which can be create at https://buildkite.com/user/api-access-tokensā
ā š 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 |
ā āļø Configuration & Usage
ā Editors & Tools
Claude Desktop
{
"mcpServers": {
"buildkite": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN",
"buildkite/mcp-server", "stdio"
],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Goose
ā Goose
- For Docker with Gooseā (recommended):
extensions:
fetch:
name: Buildkite
cmd: docker
args: ["run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN", "buildkite/mcp-server", "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",
"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",
"buildkite/mcp-server", "stdio"
],
"env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
}
}
}
Zed
ā 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:
// ~/.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 |
ā š License
MIT Ā© Buildkite
SPDX-License-Identifier: MIT
Tag summary
Content type
Image
Digest
sha256:8367ca8e7ā¦
Size
17.7 MB
Last updated
12 days ago
docker pull buildkite/mcp-server