[{"_1":2,"_265":-5,"_266":-5},"loaderData",{"_3":4,"_29":30,"_31":32,"_213":214},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","01985b0e-4218-714d-a1bb-3eb0bf708386","title","You need to sign in to access this page","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":-5},"attributes",[22],"bot","id",10028015,"membership","referenceId","019859fa-414d-7358-8190-8f91b3485a15","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_33":34,"_35":-5,"_36":37,"_38":49,"_131":132,"_212":102},"availableLocales",[],"githubUser","locale",{"_38":39,"_42":46,"_47":48},"mcpServer",{"_40":41,"_42":43,"_44":45},"description","Official MCP Server for Buildkite.","name","buildkite-mcp-server","readme","# buildkite-mcp-server 🚀\n\n[![Build status](https://badge.buildkite.com/79fefd75bc7f1898fb35249f7ebd8541a99beef6776e7da1b4.svg?branch=main)](https://buildkite.com/buildkite/buildkite-mcp-server)\n\n> **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server exposing Buildkite data (pipelines, builds, jobs, tests) to AI tooling and editors.**\n\n---\n\n## ⚡ TL;DR Quick-start\n\n[Create a Buildkite API Token](https://buildkite.com/user/api-access-tokens/new?scopes[]=read_clusters&scopes[]=read_pipelines&scopes[]=read_builds&scopes[]=read_build_logs&scopes[]=read_user&scopes[]=read_organizations&scopes[]=read_artifacts&scopes[]=read_suites)\n\n```bash\n# Run via Docker with the token from above\ndocker run -it --rm -e BUILDKITE_API_TOKEN=bkua_xxxxx ghcr.io/buildkite/buildkite-mcp-server stdio\n```\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.png)](https://cursor.com/install-mcp?name=buildkite&config=eyJjb21tYW5kIjoiZG9ja2VyIHJ1biAtaSAtLXJtIC1lIEJVSUxES0lURV9BUElfVE9LRU4gZ2hjci5pby9idWlsZGtpdGUvYnVpbGRraXRlLW1jcC1zZXJ2ZXIgc3RkaW8iLCJlbnYiOnsiQlVJTERLSVRFX0FQSV9UT0tFTiI6ImJrdWFfeHh4eHh4eHgifX0%3D)\n\n---\n\n## 🗂️ Table of Contents\n\n- [Prerequisites](#️-prerequisites)\n- [API Token Scopes](#-api-token-scopes)\n- [Installation](#-installation)\n- [Configuration & Usage](#️-configuration--usage)\n- [Features](#️-tools--features)\n- [Screenshots](#-screenshots)\n- [Security](#-security)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n---\n\n## 🛠️ Prerequisites\n\n| Requirement | Notes |\n|-------------|-------|\n| Docker ≥ 20.x | Recommended path – run in an isolated container |\n| **OR** Go ≥ 1.22 | Needed only for building/running natively |\n| Buildkite API token | Create at https://buildkite.com/user/api-access-tokens |\n| Internet access to `ghcr.io` | To pull the pre-built image |\n\n---\n\n## 🔑 API Token Scopes\n\n### Full functionality\n\n👉 **Quick add:** [Create token with Full functionality](https://buildkite.com/user/api-access-tokens/new?scopes[]=read_clusters&scopes[]=read_pipelines&scopes[]=read_builds&scopes[]=read_build_logs&scopes[]=read_user&scopes[]=read_organizations&scopes[]=read_artifacts&scopes[]=read_suites)\n\n| Scope | Purpose |\n|-------|---------|\n| `read_clusters` | Access cluster & queue information |\n| `read_pipelines` | Pipeline configuration |\n| `read_builds` | Builds, jobs & annotations |\n| `read_build_logs` | Job log output |\n| `read_user` | Current user info |\n| `read_organizations` | Organization details |\n| `read_artifacts` | Build artifacts & metadata |\n| `read_suites` | Buildkite Test Engine data |\n\n### Minimum recommended\n\n👉 **Quick add:** [Create token with Basic functionality](https://buildkite.com/user/api-access-tokens/new?scopes[]=read_builds&scopes[]=read_pipelines&scopes[]=read_user)\n\n| Scope | Purpose |\n|-------|---------|\n| `read_builds` | Builds, jobs & annotations |\n| `read_pipelines` | Pipeline information |\n| `read_user` | User identification |\n\n---\n\n## 📦 Installation\n\n### 1. Docker (recommended)\n\n```bash\ndocker pull ghcr.io/buildkite/buildkite-mcp-server\n```\n\nRun:\n\n```bash\ndocker run -it --rm -e BUILDKITE_API_TOKEN=bkua_xxxxx ghcr.io/buildkite/buildkite-mcp-server stdio\n```\n\n### 2. Pre-built binary\n\nDownload the latest release from [GitHub Releases](https://github.com/buildkite/buildkite-mcp-server/releases). Binaries are fully-static and require no libc.\n\nIf you're on macOS, you can use [Homebrew](https://brew.sh):\n\n```sh\nbrew install buildkite/buildkite/buildkite-mcp-server\n```\n\n### 3. Build from source\n\n```bash\ngo install github.com/buildkite/buildkite-mcp-server@latest\n# or\ngoreleaser build --snapshot --clean\n# or\nmake build # uses goreleaser (snapshot)\n```\n\n### 4. Docker Desktop\n\n[![Add to Docker Desktop](https://img.shields.io/badge/Add%20to%20Docker%20Desktop-17191e?style=flat&logo=docker)](https://hub.docker.com/open-desktop?url=https://open.docker.com/dashboard/mcp/servers/id/buildkite/config?enable=true)\n\n```sh\ndocker mcp server enable buildkite\n```\n\nView on [Docker MCP Hub](https://hub.docker.com/mcp/server/buildkite)\n\n---\n\n## ⚙️ Configuration & Usage\n\n\n\n

\n\nDocker (recommended):\n\n```jsonc\n# ~/.config/amp/settings.json\n{\n \"amp.mcpServers\": {\n \"buildkite\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\", \"-e\", \"BUILDKITE_API_TOKEN\",\n \"ghcr.io/buildkite/buildkite-mcp-server\", \"stdio\"\n ],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\" }\n }\n }\n}\n```\n\nLocal binary, with the [Job Log Token Threshold](#job-log-token-threshold) flag enabled:\n\n```jsonc\n# ~/.config/amp/settings.json\n{\n \"amp.mcpServers\": {\n \"buildkite\": {\n \"command\": \"buildkite-mcp-server\",\n \"args\": [\"stdio\"],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\", \"JOB_LOG_TOKEN_THRESHOLD\": 2000 }\n }\n }\n}\n```\n

\n\n

Claude Code

\n\nDocker (recommended):\n\n```\nclaude mcp add buildkite -- docker run --rm -i -e BUILDKITE_API_TOKEN=bkua_xxxxxxxx ghcr.io/buildkite/buildkite-mcp-server stdio\n```\n\nLocal binary:\n\n```\nclaude mcp add buildkite --env BUILDKITE_API_TOKEN=bkua_xxxxxxxx -- buildkite-mcp-server stdio\n```\n

\n\n

Claude Desktop

\n\nDocker (recommended):\n\n```jsonc\n{\n \"mcpServers\": {\n \"buildkite\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\", \"-e\", \"BUILDKITE_API_TOKEN\",\n \"ghcr.io/buildkite/buildkite-mcp-server\", \"stdio\"\n ],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\" }\n }\n }\n}\n```\n\nLocal binary, with the [Job Log Token Threshold](#job-log-token-threshold) flag enabled:\n\n```jsonc\n{\n \"mcpServers\": {\n \"buildkite\": {\n \"command\": \"buildkite-mcp-server\",\n \"args\": [\"stdio\"],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\", \"JOB_LOG_TOKEN_THRESHOLD\": 2000 }\n }\n }\n}\n```\n

\n\n

Goose

\n\nDocker (recommended):\n\n```yaml\nextensions:\n fetch:\n name: Buildkite\n cmd: docker\n args: [\"run\", \"-i\", \"--rm\", \"-e\", \"BUILDKITE_API_TOKEN\", \"ghcr.io/buildkite/buildkite-mcp-server\", \"stdio\"]\n enabled: true\n envs: { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\" }\n type: stdio\n timeout: 300\n```\n\nLocal binary, with the [Job Log Token Threshold](#job-log-token-threshold) flag enabled:\n\n```yaml\nextensions:\n fetch:\n name: Buildkite\n cmd: buildkite-mcp-server\n args: [stdio]\n enabled: true\n envs: { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\", \"JOB_LOG_TOKEN_THRESHOLD\": 2000 }\n type: stdio\n timeout: 300\n```\n

VS Code

\n\n```jsonc\n{\n \"inputs\": [\n {\n \"id\": \"BUILDKITE_API_TOKEN\",\n \"type\": \"promptString\",\n \"description\": \"Enter your Buildkite Access Token\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"buildkite\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\", \"-e\", \"BUILDKITE_API_TOKEN\",\n \"ghcr.io/buildkite/buildkite-mcp-server\", \"stdio\"\n ],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"${input:BUILDKITE_API_TOKEN}\" }\n }\n }\n}\n```\n

Windsurf

\n\n```jsonc\n{\n \"mcpServers\": {\n \"buildkite\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\", \"-e\", \"BUILDKITE_API_TOKEN\",\n \"ghcr.io/buildkite/buildkite-mcp-server\", \"stdio\"\n ],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\" }\n }\n }\n}\n```\n\nLocal binary, with the [Job Log Token Threshold](#job-log-token-threshold) flag enabled:\n\n```jsonc\n{\n \"mcpServers\": {\n \"buildkite\": {\n \"command\": \"buildkite-mcp-server\",\n \"args\": [\"stdio\"],\n \"env\": { \"BUILDKITE_API_TOKEN\": \"bkua_xxxxxxxx\", \"JOB_LOG_TOKEN_THRESHOLD\": 2000 }\n }\n }\n}\n```\n\n

\n\n

Zed

\n\nThere is a Zed [editor extension](https://zed.dev) available in the [official extension gallery](https://zed.dev/extensions?query=buildkite). During installation it will ask for an API token which will be added to your settings.\n\nOr you can manually configure:\n\n```jsonc\n// ~/.config/zed/settings.json\n{\n \"context_servers\": {\n \"mcp-server-buildkite\": {\n \"settings\": {\n \"buildkite_api_token\": \"your-buildkite-token-here\"\n }\n }\n }\n}\n```\n

\n\n---\n\n## 🔧 Environment Variables\n\n| Variable | Description | Default | Usage |\n|----------|-------------|---------|-------|\n| `BUILDKITE_API_TOKEN` | Your Buildkite API access token | Required | Authentication for all API requests |\n| `JOB_LOG_TOKEN_THRESHOLD` | Token threshold for job logs | `0` (disabled) | **Local installations only** - Downloads logs to temp directory when exceeded |\n\n### Job Log Token Threshold\n\nThe `JOB_LOG_TOKEN_THRESHOLD` environment variable controls when large job logs are downloaded to your local temporary directory instead of being returned directly.\n\n**⚠️ Important**: This setting should only be used with local installations as it:\n- Downloads job logs to your system's temporary directory\n- Reads log files from disk instead of returning them in the response\n- May consume local disk space for large log files\n\nWhen the threshold is exceeded, the `get_job_logs` tool will:\n1. Download the log content to a temporary file\n2. Return the file path and metadata instead of raw log content\n3. Include the reason for file-based delivery in the response\n\n---\n\n\n\n## 🛠️ Tools & Features\n\n| Tool | Description |\n|------|-------------|\n| `get_cluster` | Get detailed information about a specific cluster including its name, description, default queue, and configuration |\n| `list_clusters` | List all clusters in an organization with their names, descriptions, default queues, and creation details |\n| `get_cluster_queue` | Get detailed information about a specific queue including its key, description, dispatch status, and hosted agent configuration |\n| `list_cluster_queues` | List all queues in a cluster with their keys, descriptions, dispatch status, and agent configuration |\n| `get_pipeline` | Get detailed information about a specific pipeline including its configuration, steps, environment variables, and build statistics |\n| `list_pipelines` | List all pipelines in an organization with their basic details, build counts, and current status |\n| `create_pipeline` | Set up a new CI/CD pipeline in Buildkite with YAML configuration, repository connection, and cluster assignment |\n| `update_pipeline` | Modify an existing Buildkite pipeline's configuration, repository, settings, or metadata |\n| `list_builds` | List all builds for a pipeline with their status, commit information, and metadata |\n| `get_build` | Get detailed information about a specific build including its jobs, timing, and execution details |\n| `get_build_test_engine_runs` | Get test engine runs data for a specific build in Buildkite. This can be used to look up Test Runs. |\n| `create_build` | Trigger a new build on a Buildkite pipeline for a specific commit and branch, with optional environment variables, metadata, and author information |\n| `current_user` | Get details about the user account that owns the API token, including name, email, avatar, and account creation date |\n| `user_token_organization` | Get the organization associated with the user token used for this request |\n| `get_jobs` | Get all jobs for a specific build including their state, timing, commands, and execution details |\n| `get_job_logs` | Get the log output and metadata for a specific job, including content, size, and header timestamps |\n| `list_artifacts` | List all artifacts for a build across all jobs, including file details, paths, sizes, MIME types, and download URLs |\n| `get_artifact` | Get detailed information about a specific artifact including its metadata, file size, SHA-1 hash, and download URL |\n| `list_annotations` | List all annotations for a build, including their context, style (success/info/warning/error), rendered HTML content, and creation timestamps |\n| `list_test_runs` | List all test runs for a test suite in Buildkite Test Engine |\n| `get_test_run` | Get a specific test run in Buildkite Test Engine |\n| `get_failed_executions` | Get failed test executions for a specific test run in Buildkite Test Engine. Optionally get the expanded failure details such as full error messages and stack traces. |\n| `get_test` | Get a specific test in Buildkite Test Engine. This provides additional metadata for failed test executions |\n| `access_token` | Get information about the current API access token including its scopes and UUID |\n\n---\n\n## 📸 Screenshots\n\n![Get Pipeline Tool](docs/images/get_pipeline.png)\n\n---\n\n## Library Usage\n\nThe exported Go API of this module should be considered unstable, and subject to breaking changes as we evolve this project.\n\n---\n\n## 🔒 Security\n\nTo ensure the MCP server is run in a secure environment, we recommend running it in a container.\n\nThis image is built from [cgr.dev/chainguard/static](https://images.chainguard.dev/directory/image/static/versions) and runs as an unprivileged user.\n\n---\n\n## 🤝 Contributing\n\nDevelopment guidelines are in [`DEVELOPMENT.md`](DEVELOPMENT.md).\n\nRun the test suite:\n\n```bash\ngo test ./...\n```\n\n---\n\n## 📝 License\n\nMIT © Buildkite\n\nSPDX-License-Identifier: MIT\n","English","tag","en-US",{"_50":51,"_52":53,"_20":63,"_71":41,"_72":41,"_73":74,"_77":78,"_99":-5,"_23":100,"_101":102,"_103":104,"_42":43,"_114":90,"_115":-5,"_116":-5,"_117":-5,"_118":-5,"_119":120,"_125":-5,"_111":43,"_126":-5,"_127":-5,"_8":128,"_129":130},"addedAt","2025-07-03T07:29:39.896896351Z","argumentsJsonSchema",{"_54":55,"_60":61,"_12":62},"properties",{"_56":57},"BUILDKITE_API_TOKEN",{"_40":58,"_12":59},"Buildkite API token required for authentication. Create at https://buildkite.com/user/api-access-tokens","string","required",[56],"object",[64,65,66,67,68,69,70],"category:ci-cd","category:developer-tools","category:code-execution","environment:network","hosting:remote-capable","language:go","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_44":45,"_75":76},"url","https://github.com/buildkite/buildkite-mcp-server","githubRepository",{"_79":80,"_81":82,"_83":84,"_85":86,"_42":43,"_87":88,"_92":93,"_94":95,"_97":98},"defaultBranch","main","fullName","buildkite/buildkite-mcp-server","githubTreeId",145092,"language","Go","owner",{"_89":90,"_8":91},"login","buildkite","xJmF3V2Yxo","recentStargazers",0,"spdxLicense",{"_42":96},"MIT License","stargazers",19,"glamaJson",8730,"inspectable",false,"integrations",[105],{"_106":107,"_40":112,"_8":113},"brand",{"_108":109,"_42":110,"_111":90},"logoSvgPath","M23.613 8.143l-7.668-3.856v7.712l7.668-3.855zM8.166 15.857V8.143L.387 4.287V12l7.78 3.857zM.183 3.958a.382.382 0 01.377-.017l7.606 3.771 7.607-3.771a.386.386 0 01.346 0l7.668 3.857a.386.386 0 01.213.345v7.71a.388.388 0 01-.213.346l-7.668 3.86a.389.389 0 01-.562-.345v-7.09l-7.219 3.58a.392.392 0 01-.344 0L.215 12.346A.387.387 0 010 12V4.287a.385.385 0 01.183-.329z","Buildkite","slug","Exposes Buildkite data including pipelines, builds, jobs, and test results, allowing AI tools to interact with Buildkite CI/CD infrastructure. Provides tools for managing clusters, queues, pipelines, builds, artifacts, annotations, and test executions.","jvzzm9gasq","namespace","npmPackage","prompts","redditPostForeignId","resources","scores",{"_121":122,"_123":-5,"_124":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms","tools","1mactcyzmf","updatedAt","2025-07-29T03:15:27.148148127Z","meta",[133,135,137,144,147,149,152,155,158,161,164,166,169,172,174,176,178,180,182],{"_10":134},"buildkite-mcp-server | Glama",{"_136":41,"_42":40},"content",{"_138":139,"_140":141,"_142":143},"href","https://glama.ai/mcp/servers/@buildkite/buildkite-mcp-server","rel","canonical","tagName","link",{"_136":43,"_145":146},"property","og:title",{"_136":41,"_145":148},"og:description",{"_136":150,"_145":151},"https://glama.ai/logo.png","og:logo",{"_136":153,"_145":154},"https://glama.ai/mcp/servers/@buildkite/buildkite-mcp-server/og-image","og:image",{"_136":156,"_145":157},"630","og:image:height",{"_136":159,"_145":160},"1200","og:image:width",{"_136":162,"_145":163},"website","og:type",{"_136":139,"_145":165},"og:url",{"_136":167,"_145":168},"Glama – MCP Hosting Platform","og:site_name",{"_136":170,"_42":171},"summary_large_image","twitter:card",{"_136":167,"_42":173},"twitter:title",{"_136":41,"_42":175},"twitter:description",{"_136":153,"_42":177},"twitter:image",{"_136":156,"_42":179},"twitter:image:height",{"_136":159,"_42":181},"twitter:image:width",{"_183":184},"script:ld+json",{"_185":186,"_187":188},"@context","http://schema.org","@graph",[189],{"_185":190,"_191":192,"_193":194},"https://schema.org","@type","BreadcrumbList","itemListElement",[195,202,206,210],{"_191":196,"_197":198,"_42":199,"_200":201},"ListItem","item","https://glama.ai/","Glama","position",1,{"_191":196,"_197":203,"_42":204,"_200":205},"https://glama.ai/mcp","MCP",2,{"_191":196,"_197":207,"_42":208,"_200":209},"https://glama.ai/mcp/servers","Servers",3,{"_191":196,"_197":139,"_42":43,"_200":211},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_35":-5,"_38":215,"_131":229,"_264":-5},{"_50":51,"_52":216,"_20":220,"_71":41,"_72":41,"_73":221,"_77":222,"_99":-5,"_23":100,"_101":102,"_103":225,"_42":43,"_114":90,"_115":-5,"_116":-5,"_117":-5,"_118":-5,"_119":228,"_125":-5,"_111":43,"_126":-5,"_127":-5,"_8":128,"_129":130},{"_54":217,"_60":219,"_12":62},{"_56":218},{"_40":58,"_12":59},[56],[64,65,66,67,68,69,70],{"_44":45,"_75":76},{"_79":80,"_81":82,"_83":84,"_85":86,"_42":43,"_87":223,"_92":93,"_94":224,"_97":98},{"_89":90,"_8":91},{"_42":96},[226],{"_106":227,"_40":112,"_8":113},{"_108":109,"_42":110,"_111":90},{"_121":122,"_123":-5,"_124":-5},[230,232,234,236,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252],{"_10":231},"Reviews | buildkite-mcp-server | Glama",{"_136":233,"_42":40},"Read community reviews and feedback for buildkite-mcp-server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_138":235,"_140":141,"_142":143},"https://glama.ai/mcp/servers/@buildkite/buildkite-mcp-server/reviews",{"_136":237,"_145":146},"Reviews | buildkite-mcp-server",{"_136":233,"_145":148},{"_136":150,"_145":151},{"_136":153,"_145":154},{"_136":156,"_145":157},{"_136":159,"_145":160},{"_136":162,"_145":163},{"_136":235,"_145":165},{"_136":167,"_145":168},{"_136":170,"_42":171},{"_136":167,"_42":173},{"_136":233,"_42":175},{"_136":153,"_42":177},{"_136":156,"_42":179},{"_136":159,"_42":181},{"_183":253},{"_185":186,"_187":254},[255],{"_185":190,"_191":192,"_193":256},[257,258,259,260,261],{"_191":196,"_197":198,"_42":199,"_200":201},{"_191":196,"_197":203,"_42":204,"_200":205},{"_191":196,"_197":207,"_42":208,"_200":209},{"_191":196,"_197":139,"_42":43,"_200":211},{"_191":196,"_197":235,"_42":262,"_200":263},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API