Buildkite MCP Server
buildkite-mcp-server
Official Buildkite MCP server: pipelines, builds, jobs, logs and test results for the agent
Install
claude mcp add --transport http buildkite https://mcp.buildkite.com/mcpHosted server with OAuth, command from Buildkite docs.
This is third-party code. Review the repository files before installing.
What it does
The server exposes Buildkite data to the agent: pipelines, builds, jobs, logs and tests. The agent can diagnose a failed build from its logs without opening the web UI. Buildkite hosts a server with OAuth sign-in, a read-only variant and a variant that takes an API token. The tool set can be narrowed to selected groups. It can also run locally via Docker, Homebrew or from source.
Who it is for. For teams whose CI and CD run on Buildkite.
Good fit when
- You need to find why a build failed from job logs
- You want to check a pipeline's status for a branch
- You need to give a CI agent token-based access to Buildkite data
Not a fit when
- Your CI is not on Buildkite
- Local test logs are enough for the agent
Example request
Why did the latest web pipeline build on main fail? Show the error from the logsLimitations
Requires a Buildkite account. Permissions come from the user's OAuth grant or API token scopes. The module's Go API is considered unstable. Access to Buildkite from Russia without a VPN is not verified.
How to disable. Run claude mcp remove buildkite or delete the server from the client config; for OAuth revoke access in Buildkite settings.
MCP
- Transport
- http, stdio
- Authentication
- OAuth
| Environment variables | |
|---|---|
| BUILDKITE_API_TOKEN secret | API token for the local run |
| BUILDKITE_PASSTHROUGH_HTTP_HEADERS | Headers forwarded to the Buildkite API in HTTP mode |
Security check
- Reads build logs that may contain secrets
- With write scopes it can affect pipelines
README in short
The README is short and points to Buildkite docs. It recommends running the server in a container built on a minimal unprivileged Chainguard image. It also covers header passthrough in HTTP mode, including authenticating each request with its own token. MIT licensed.
FAQ
Can I give the agent read-only access?
Yes, Buildkite docs describe /readonly URLs such as https://mcp.buildkite.com/mcp/readonly.
How do I run it locally?
Use docker run with the buildkite/mcp-server image and BUILDKITE_API_TOKEN, or brew install buildkite/buildkite/buildkite-mcp-server.
Related
An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant
GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent
A GitHub Action that runs Claude Code in pull requests and issues: answers mentions, reviews and makes changes
An AI assistant for Kubernetes that turns plain-language requests into kubectl operations and doubles as an MCP server