--- title: "Buildkite MCP server: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/mcp-servers/buildkite-mcp-server/ description: "Exposes Buildkite pipelines, builds, jobs, and tests to an MCP client, locally or through Buildkite's remote server." --- # Buildkite MCP server: review, setup & limitations · Undominated.ai > Exposes Buildkite pipelines, builds, jobs, and tests to an MCP client, locally or through Buildkite's remote server. [← Explore all mcp servers](/mcp-servers/) DEVELOPMENT WORKFLOW / Buildkite # Buildkite MCP server Exposes Buildkite pipelines, builds, jobs, and tests to an MCP client, locally or through Buildkite's remote server. [See setup guidance ↓](#setup)[Original source ↗](https://buildkite.com/docs/apis/mcp-server) SOURCE REVIEW Reviewed 2026-10-14 Evidence 5 linked sources Publisher Buildkite Licence [MIT ↗](https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/LICENSE) Revision e437254055c3 [Read what was—and wasn’t—checked ↓](#review) “Model Context Protocol (MCP) server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.” [Buildkite · upstream description ↗](https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/README.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - The repository README at this commit says the server exposes Buildkite pipelines, builds, jobs, and tests. - Buildkite's local install page documents a Docker command, and the commit's LICENSE is MIT, Copyright (c) 2025 Buildkite. - The pinned README exposes Buildkite pipelines, builds, jobs, and tests, and it documents compare_builds as a read-only comparison. - HTTP mode can forward only headers the operator names, and a per-request Authorization mode will not fall back to a shared token. ### A good fit for - Inspecting a Buildkite build or pipeline from an MCP client you already operate - Comparing a failed Buildkite build with the last passing build on the same branch - A self-hosted HTTP deployment where each request carries its own Buildkite token ### Weigh up before choosing - Write scopes can trigger builds, unblock jobs, change/delete pipelines and create cluster secrets, potentially running pipeline commands. - The Docker launcher pulls a mutable image and the remote endpoint is independently updated; neither is pinned by the reviewed Git commit. - Logs and artifacts may contain sensitive project data even with read-only token scopes. - compare_builds searches at most 500 baseline candidates and 1,000 jobs per build. - Header passthrough does not exist in stdio mode. - The Go API is described as unstable. - A pin does not verify transitive dependencies. - This review did not execute the resource. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - README.md at e437254055c32fea1c461c861ec47f7e36bdf1e6 - LICENSE at the same commit - https://buildkite.com/docs/apis/mcp-server/local/installing.md - README.md - LICENSE ### Our findings - Minimum token scopes do not include build logs or artifacts; those require read_build_logs and read_artifacts separately. - Secret-detail reads return metadata rather than secret values; write_secrets is a separate grant. - The installation guide offers a 1Password reference mechanism, which requires an authenticated op CLI. - MCP lane cross-review matched the retained primary setup/permission evidence and the added source-specific findings before this wave was frozen. - The server exposes Buildkite pipelines, builds, jobs, and tests. compare_builds is read-only: it picks an earlier passing build on the same branch and does not change Buildkite state. - HTTP passthrough forwards only headers the operator listed, and only to the Buildkite origin. If Authorization is the per-request credential, a missing header is HTTP 401 and the server never falls back to a shared token. - That header passthrough is not available in stdio mode. Baseline search stops at 500 candidates, and a build with more than 1,000 jobs returns an error instead of a partial inventory. ### Not established by this review - No server installation, authentication, live API operation or isolation test was performed. - The server was not started and its tools were not called. - A pin does not verify transitive dependencies. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Connect a server deliberately. [Upstream setup instructions ↗](https://buildkite.com/docs/apis/mcp-server/local/installing.md) DOCUMENTED COMMAND docker run --pull=always -q -it --rm -e BUILDKITE_API_TOKEN= buildkite/mcp-server stdio Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - Replace with a token that has only the scopes you intend. The command was not run. - Prefer the remote server only if you accept that its endpoint is not pinned to this reviewed commit. ### Before you start - Docker 20 or later for that command - A Buildkite API access token ### Documented configuration example Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts. { "mcpServers": { "buildkite": { "command": "docker", "args": [ "run", "--pull=always", "-q", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN", "buildkite/mcp-server", "stdio" ], "env": { "BUILDKITE_API_TOKEN": "bkua_xxxxx" } } } } Copy configuration ↗ ### Compatibility Docker · MCP stdio clients · Amp · Claude Code · Claude Desktop · Cursor · Goose · Visual Studio Code · Windsurf · Zed ### Implementation Go ### Transports stdio · Streamable HTTP ### Local process or hosted HTTP with a Buildkite token or OAuth - Reads builds and pipelines available to the token - Write scopes, if granted, can create builds and change pipelines ### Cost model MIT server source. Buildkite organization entitlements apply. No price was reviewed. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Buildkite MCP README ↗](https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/README.md) Checked 2026-10-14 https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/README.md Supports: Server purpose, MIT notice - [Installing the Buildkite MCP server ↗](https://buildkite.com/docs/apis/mcp-server/local/installing.md) Checked 2026-10-14 https://buildkite.com/docs/apis/mcp-server/local/installing.md Supports: Docker install command, Token scope names - [Buildkite MCP LICENSE ↗](https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/LICENSE) Checked 2026-10-08 https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/LICENSE Supports: MIT License, Copyright (c) 2025 Buildkite - [Buildkite MCP README ↗](https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/README.md) Checked 2026-10-08 https://github.com/buildkite/buildkite-mcp-server/blob/e437254055c32fea1c461c861ec47f7e36bdf1e6/README.md Supports: Server purpose, MIT notice - [Installing the Buildkite MCP server ↗](https://buildkite.com/docs/apis/mcp-server/local/installing.md) Checked 2026-10-08 https://buildkite.com/docs/apis/mcp-server/local/installing.md Supports: Docker install command, Token scope names KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### CircleCI MCP ↗ Inspects CircleCI pipeline failures and performs explicitly authorized workflow actions through its hosted MCP service.](/mcp-servers/circleci/)[### Apollo MCP Server ↗ Exposes a chosen set of GraphQL operations as MCP tools backed by an existing graph.](/mcp-servers/apollo/)[### Postman MCP ↗ Connects assistants to Postman collections, workspaces and environments through selectable tool sets.](/mcp-servers/postman/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Inspect resource evidence](/tools/) - [Choose a host](/agents/) - [Inspect reusable workflows](/skills/) - [Use Undominated data](/api/)