mcplist
BU

Buildkite

Created 4 months ago

Buildkite MCP server exposing Buildkite data to AI tooling and editors.

Visit Homepage
development documentation public

What is Buildkite?

Exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.

Documentation

buildkite-mcp-server

TL;DR Quick-start

Create a Buildkite API Token

docker run -it --rm -e BUILDKITE_API_TOKEN=bkua_xxxxx ghcr.io/buildkite/buildkite-mcp-server stdio

Prerequisites

Requirement Notes
Docker ≥ 20.x Recommended path – run in an isolated container
OR Go ≥ 1.24 Needed only for building 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

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

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.

3. Build from source

go install github.com/buildkite/buildkite-mcp-server@latest

Configuration & Usage# Environment Variables

Variable Description Default Usage
BUILDKITE_API_TOKEN Your Buildkite API access token Required Authentication for all API requests
JOB_LOG_TOKEN_THRESHOLD Token threshold for job logs 0 (disabled) Downloads logs to temp directory when exceeded

License

MIT © Buildkite SPDX-License-Identifier: MIT

Server Config 

{
  "mcpServers": {
    "buildkite-server": {
      "command": "npx",
      "args": [
        "buildkite"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 22, 2025
Updated At: Aug 07, 2025
Author: Buildkite
Category: official
License: MIT
Tags:
development documentation public