buildkite-mcp-server

This is an Model Context Protocol (MCP) server for Buildkite. The goal is to provide access to information from buildkite about pipelines, builds and jobs to tools such as Claude Desktop, GitHub Copilot and other tools, or editors.

Tools

get_pipeline - Get details of a specific pipeline in Buildkite
list_pipelines - List all pipelines in a buildkite organization
list_builds - List all builds in a pipeline in Buildkite
get_job_logs - Get logs for a specific job in Buildkite
list_artifacts - List all artifacts for a specific job in Buildkite
get_artifact - Get a specific artifact for a specific job in Buildkite
current_user - Get details of the current user in Buildkite

Example of the get_pipeline tool in action.

Get Pipeline Tool

Production

Pull the pre-built image (once published):

docker pull buildkite/buildkite-mcp-server

Or build it yourself using GoReleaser:

goreleaser build --snapshot --clean

configuration

Create a buildkite api token with read access to pipelines.

Local Installation

{
    "mcpServers": {
        "buildkite": {
            "command": "buildkite-mcp-server",
            "args": [
                "stdio"
            ],
            "env": {
                "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx"
            }
        }
    }
}

Docker Configuration

Use this configuration if you want to run the server using Docker:

{
    "mcpServers": {
        "buildkite": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "BUILDKITE_API_TOKEN",
                "buildkite/buildkite-mcp-server"
            ],
            "env": {
                "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx"
            }
        }
    }
}

Goose Configuration

YAML configuration for Goose:

extensions:
  fetch:
    name: Buildkite
    cmd: buildkite-mcp-server
    args: [stdio]
    enabled: true
    envs: { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
    type: stdio
    timeout: 300

For Docker with Goose:

extensions:
  fetch:
    name: Buildkite
    cmd: docker
    args: ["run", "-i", "--rm", "-e", "BUILDKITE_API_TOKEN", "buildkite/buildkite-mcp-server"]
    enabled: true
    envs: { "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx" }
    type: stdio
    timeout: 300

Contributing

Notes on building this project are in the Development.md

Disclaimer

This project is in the early stages of development and is not yet ready for use.

License

This project is released under MIT license.

Categories

Current Category: buildkite

buildkite-mcp-server

buildkite-mcp-server