# buildkite/buildkite-mcp-server [Verified] [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/buildkite/buildkite-mcp-server  
**GitHub Stars:** 53  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/buildkite-buildkite-mcp-server

## Description
Official MCP server for Buildkite. Create new pipelines, diagnose and fix failures, trigger builds, monitor job queues, and more.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "buildkite-mcp-server": {
    "command": "npx",
    "args": ["-y","buildkite-buildkite-mcp-server"],
    "env": {
      "BUILDKITE_API_TOKEN": "",
      "BUILDKITE_BASE_URL": "",
      "BUILDKITE_PASSTHROUGH_HTTP_HEADERS": ""
    }
  }
}
```

**Requires environment variables:** `BUILDKITE_API_TOKEN`, `BUILDKITE_BASE_URL`, `BUILDKITE_PASSTHROUGH_HTTP_HEADERS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What buildkite/buildkite-mcp-server does

The buildkite/buildkite-mcp-server MCP server connects AI tooling and editors to Buildkite. It exposes information about pipelines, builds, jobs, and tests, and supports operational tasks such as creating pipelines, triggering builds, monitoring job queues, and investigating or fixing failures.

This is intended for developers and platform teams that want an MCP-compatible client to work with Buildkite data instead of relying only on manually opened dashboards or API requests. The available material does not enumerate every MCP tool, so the documented capabilities should be treated as the supported scope here rather than a complete tool catalog.

## How it works

The project is implemented as a Go module and provides an MCP server for Buildkite. The README indicates that it supports both stdio and HTTP operation. HTTP deployments can accept inbound MCP requests and, when configured, forward selected request headers to the Buildkite API.

Buildkite authentication can use a process-wide `BUILDKITE_API_TOKEN`. In HTTP mode, the server can instead require each `/mcp` request to provide its own `Authorization` header. When that mode is enabled, requests without exactly one non-empty authorization header receive HTTP 401; the server does not fall back to a shared token.

Before returning job logs, the server checks whether the current caller can access the relevant job. This authorization check also runs when the log content is already cached.

## Setup and configuration

The buildkite/buildkite-mcp-server MCP server should be run in a secure environment; the project recommends using a container. Its published container is built from Chainguard’s static image and runs as an unprivileged user.

For HTTP deployments, use `--passthrough-http-header` to explicitly allow selected inbound headers to reach Buildkite. The flag can be repeated, or the same configuration can be supplied through `BUILDKITE_PASSTHROUGH_HTTP_HEADERS` as a comma-separated value. Forwarding is restricted to the configured `BUILDKITE_BASE_URL` origin, and allowed headers are removed when requests are redirected elsewhere.

Header passthrough is not available in stdio mode. The available material does not provide a package-manager installation command or client-specific configuration, so deployment details must be taken from the project’s full documentation.

## Tools and capabilities

Documented use cases include:

- Creating new Buildkite pipelines
- Triggering builds
- Diagnosing and fixing build failures
- Monitoring job queues
- Inspecting pipelines, builds, jobs, and tests
- Serving job logs after checking caller access

The Go API exported by the module is described as unstable and may change in backward-incompatible ways.

## Limitations and notes

HTTP header passthrough requires explicit allowlisting and should be paired with a reverse proxy that authenticates callers and manages forwarded identity headers. The README does not list supported MCP clients, so compatibility with a particular editor cannot be confirmed from the provided material.

The project is licensed under MIT. Full product and API documentation is linked from Buildkite’s documentation site, while development guidance is maintained separately in the repository.

## Getting started with this buildkite/buildkite-mcp-server MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/buildkite-buildkite-mcp-server/readme_