Buildkite MCP Server
Manage Buildkite CI/CD pipelines and builds. Monitor build status, trigger deployments, and analyze failures.
- Maintained by
- Buildkite
- Hosting
- Hosted endpoint, or run it locally
- Authentication
- OAuth sign-in
- Last checked
Headless agents can use https://mcp.buildkite.com/direct with an API token instead of OAuth.
How to connect the Buildkite MCP server
Pick your AI client and paste the snippet. Swap the YOUR_… placeholders for your own values. New to this? Our guide to how MCP clients and servers fit together explains what each piece does.
Claude Code
claude mcp add --transport http buildkite https://mcp.buildkite.com/mcpThen run /mcp inside Claude Code and choose Authenticate to sign in.
Full Claude Code setup guide →Claude Desktop and claude.ai
Name: Buildkite
Remote MCP server URL: https://mcp.buildkite.com/mcpCustom connectors need a Pro, Max, Team or Enterprise plan. On Team and Enterprise an owner adds them in admin settings.
Full Claude Desktop setup guide →Cursor
{
"mcpServers": {
"buildkite": {
"url": "https://mcp.buildkite.com/mcp"
}
}
}VS Code
{
"servers": {
"buildkite": {
"type": "http",
"url": "https://mcp.buildkite.com/mcp"
}
}
}ChatGPT
Business, Enterprise and Edu plans (and Pro, read-only) can add this endpoint as an app in developer mode. ChatGPT setup guide →
+ − Run it locally instead
Claude Code
claude mcp add --env BUILDKITE_API_TOKEN=YOUR_API_TOKEN --transport stdio buildkite \
-- docker run --pull=always -q -i --rm -e BUILDKITE_API_TOKEN buildkite/mcp-server stdioClaude Desktop
{
"mcpServers": {
"buildkite": {
"command": "docker",
"args": [
"run",
"--pull=always",
"-q",
"-i",
"--rm",
"-e",
"BUILDKITE_API_TOKEN",
"buildkite/mcp-server",
"stdio"
],
"env": {
"BUILDKITE_API_TOKEN": "YOUR_API_TOKEN"
}
}
}
}Fully quit and reopen Claude Desktop after saving.
Full Claude Desktop setup guide →Cursor
{
"mcpServers": {
"buildkite": {
"command": "docker",
"args": [
"run",
"--pull=always",
"-q",
"-i",
"--rm",
"-e",
"BUILDKITE_API_TOKEN",
"buildkite/mcp-server",
"stdio"
],
"env": {
"BUILDKITE_API_TOKEN": "YOUR_API_TOKEN"
}
}
}
}VS Code
{
"servers": {
"buildkite": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"--pull=always",
"-q",
"-i",
"--rm",
"-e",
"BUILDKITE_API_TOKEN",
"buildkite/mcp-server",
"stdio"
],
"env": {
"BUILDKITE_API_TOKEN": "YOUR_API_TOKEN"
}
}
}
}Frequently asked questions
What is the Buildkite MCP server?
It is a Model Context Protocol (MCP) server — a small piece of software that gives AI assistants like Claude a secure, governed connection to Buildkite. Manage Buildkite CI/CD pipelines and builds. Monitor build status, trigger deployments, and analyze failures.
Is there an official Buildkite MCP server?
Yes. The Buildkite MCP server is an official integration, maintained by the vendor or the Model Context Protocol project, which makes it the safest default for business use. It is maintained by Buildkite.
Is the Buildkite MCP server hosted, or do I run it myself?
Both. Buildkite runs a hosted endpoint at https://mcp.buildkite.com/mcp, so most people just paste that URL into their AI client. You can also run the server locally with docker, supplying your own credentials.
Do I need an API key for the Buildkite MCP server?
No API key is needed for the hosted server. You sign in through Buildkite's own OAuth screen, and the assistant only gets the access your account has.
What can an AI assistant actually do with Buildkite?
Through this server an assistant can work with pipelines, builds, agents, artifacts — reading from and acting on Buildkite directly instead of you copy-pasting between windows. What you allow it to do is controlled by the permissions you grant.
How do I set this up for my business?
The setup section above has copy-paste config for Claude Code, Claude Desktop, Cursor and VS Code. If you want it rolled out across a team with permissions, governance and support handled, that is what Crox's Build engagement covers.
New to MCP? Start with our plain-English guide to the Model Context Protocol or see how to connect AI to your business tools without writing code .
Want this connected to your business — with governance handled?
Crox maps your processes, connects AI to the tools you already use, and keeps it working as models change. Start with a readiness assessment or talk to us about a build.