https://github.com/buildkite/buildkite-mcp-server

Official MCP Server for Buildkite.
https://github.com/buildkite/buildkite-mcp-server

buildkite mcp-server

Last synced: 3 months ago
JSON representation

Official MCP Server for Buildkite.

Host: GitHub
URL: https://github.com/buildkite/buildkite-mcp-server
Owner: buildkite
License: mit
Created: 2025-04-08T21:28:47.000Z (6 months ago)
Default Branch: main
Last Pushed: 2025-06-26T08:15:18.000Z (3 months ago)
Last Synced: 2025-06-26T08:40:21.498Z (3 months ago)
Topics: buildkite, mcp-server
Language: Go
Homepage:
Size: 396 KB
Stars: 13
Watchers: 5
Forks: 12
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-mcp-servers - buildkite/buildkite-mcp-server
awesome-mcp-servers - **buildkite-mcp-server** - Official MCP Server for Buildkite. `http` `git` `github` `go` `buildkite` `go install buildkite/buildkite-mcp-server@latest` (Other)
awesome-mcp-servers - **buildkite-mcp-server** - Official MCP Server for Buildkite. `http` `git` `github` `go` `buildkite` `go install buildkite/buildkite-mcp-server@latest` (Other)
awesome-mcp-servers - Buildkite - Manage [Buildkite](https://buildkite.com) pipelines and builds. (Official Servers)

README

          # buildkite-mcp-server 🚀

[![Build status](https://badge.buildkite.com/79fefd75bc7f1898fb35249f7ebd8541a99beef6776e7da1b4.svg?branch=main)](https://buildkite.com/buildkite/buildkite-mcp-server)

> **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.**

---

## ⚡ TL;DR Quick-start

```bash

# 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

```

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.png)](https://cursor.com/install-mcp?name=buildkite&config=eyJjb21tYW5kIjoiZG9ja2VyIHJ1biAtaSAtLXJtIC1lIEJVSUxES0lURV9BUElfVE9LRU4gZ2hjci5pby9idWlsZGtpdGUvYnVpbGRraXRlLW1jcC1zZXJ2ZXIgc3RkaW8iLCJlbnYiOnsiQlVJTERLSVRFX0FQSV9UT0tFTiI6ImJrdWFfeHh4eHh4eHgifX0%3D)

---

## 🗂️ Table of Contents

- [Prerequisites](#prerequisites)

- [API Token Scopes](#api-token-scopes)

- [Installation](#installation)

- [Configuration & Usage](#configuration--usage)

  - [Editors & Tools](#editors--tools)

- [Features](#features)

- [Screenshots](#screenshots)

- [Security](#security)

- [Contributing](#contributing)

- [License](#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](https://buildkite.com/user/api-access-tokens/new?scopes[]=read_clusters&scopes[]=read_pipelines&scopes[]=read_builds&scopes[]=read_build_logs&scopes[]=read_user&scopes[]=read_organizations&scopes[]=read_artifacts&scopes[]=read_suites)

| 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](https://buildkite.com/user/api-access-tokens/new?scopes[]=read_builds&scopes[]=read_pipelines&scopes[]=read_user)

| Scope | Purpose |

|-------|---------|

| `read_builds` | Builds, jobs & annotations |

| `read_pipelines` | Pipeline information |

| `read_user` | User identification |

---

## 📦 Installation

### 1. Docker (recommended)

```bash

docker pull ghcr.io/buildkite/buildkite-mcp-server

```

Run:

```bash

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](https://github.com/buildkite/buildkite-mcp-server/releases). Binaries are fully-static and require no libc.

### 3. Build from source

```bash

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

```jsonc

{

  "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:

```jsonc

{

  "mcpServers": {

    "buildkite": {

      "command": "buildkite-mcp-server",

      "args": ["stdio"],

      "env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }

    }

  }

}

```

## Goose

- For Docker with [Goose](https://block.github.io/goose/) (recommended):

Goose

```yaml

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:

```yaml

extensions:

  fetch:

    name: Buildkite

    cmd: buildkite-mcp-server

    args: [stdio]

    enabled: true

    envs: { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }

    type: stdio

    timeout: 300

```

VS Code

```jsonc

{

  "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

```jsonc

{

  "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:

```jsonc

{

  "mcpServers": {

    "buildkite": {

      "command": "buildkite-mcp-server",

      "args": ["stdio"],

      "env": { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }

    }

  }

}

```

## Zed

- There is a Zed [editor extension](https://zed.dev) available in the [official extension gallery](https://zed.dev/extensions?query=buildkite). During installation it will ask for an API token which will be added to your settings, or you can manually configure:

Zed

```jsonc

// ~/.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

![Get Pipeline Tool](docs/images/get_pipeline.png)

---

## 🔒 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](https://images.chainguard.dev/directory/image/static/versions) and runs as an unprivileged user.

---

## 🤝 Contributing

Development guidelines are in [`DEVELOPMENT.md`](DEVELOPMENT.md).

Run the test suite:

```bash

go test ./...

```

---

## 📝 License

MIT © Buildkite

SPDX-License-Identifier: MIT

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/buildkite/buildkite-mcp-server

Awesome Lists containing this project

README