{"_rev":"7-1c32b4970ff7292c8add03edabbfa1c3","time":{"created":"2026-09-05T02:24:53.466Z","modified":"2026-09-05T02:24:54.088Z","1.0.0":"2026-09-05T00:07:51.027Z","1.1.0":"2026-09-05T00:30:19.161Z","1.1.2":"2026-09-05T02:24:53.692Z"},"_id":"@dnbeu/bamboo-mcp-server","name":"@dnbeu/bamboo-mcp-server","dist-tags":{"latest":"1.1.2"},"versions":{"1.1.2":{"name":"@dnbeu/bamboo-mcp-server","version":"1.1.2","description":"MCP server for Atlassian Bamboo CI/CD — builds, deployments, plans, agents, and logs","type":"module","main":"dist/index.js","bin":{"bamboo-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","bamboo","atlassian","ci-cd","builds","deployments","claude","ai"],"author":{"name":"D&B Europe"},"license":"MIT","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"gitHead":"92a9f5afca75f7724a3d12c756874cd05c2f8f77","types":"./dist/index.d.ts","_id":"@dnbeu/bamboo-mcp-server@1.1.2","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-pss+iHl2JpgzPOMx93GKOCQRql+x4fV75FOGkDG3JKSNERd2n+ZeJpDRvOebneIbzg7IrXPWq2v1jHotWd302w==","shasum":"a04404699c321d7319ccfbc263b75d5308497bd4","tarball":"https://registry.npmjs.org/@dnbeu/bamboo-mcp-server/-/bamboo-mcp-server-1.1.2.tgz","fileCount":17,"unpackedSize":63806,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHJzprbPRj7tfSIDxbo8rl3yra946fZo4Y6W7ozXjqUxAiATep5um+pvHLmDlCbsApHuFSM9eYaiRovc8SBydXAbnA=="}]},"_npmUser":{"name":"dnbeu","email":"alipoursimakanik@dnb.com"},"directories":{},"maintainers":[{"name":"dnbeu","email":"alipoursimakanik@dnb.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bamboo-mcp-server_1.1.2_1788575093562_0.14373218388895626"},"_hasShrinkwrap":false}},"maintainers":[{"name":"dnbeu","email":"alipoursimakanik@dnb.com"}],"description":"MCP server for Atlassian Bamboo CI/CD — builds, deployments, plans, agents, and logs","keywords":["mcp","model-context-protocol","bamboo","atlassian","ci-cd","builds","deployments","claude","ai"],"author":{"name":"D&B Europe"},"license":"MIT","readme":"# Bamboo MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for Atlassian Bamboo CI/CD. Gives AI assistants like Claude Code read and write access to Bamboo build plans, results, deployments, agents, and logs through a structured tool interface.\n\nBuilt for troubleshooting CI/CD pipelines — trace a failing build from plan to log to deployment to Kubernetes pod in a single conversation.\n\nPublished on npm as [@dnbeu/bamboo-mcp-server](https://www.npmjs.com/package/@dnbeu/bamboo-mcp-server) by D&B Europe.\n\n## Quick Start\n\n```bash\n# Add to Claude Code (no clone or build needed)\nclaude mcp add bamboo -s user \\\n  -e BAMBOO_URL=https://bamboo.bisnode.com \\\n  -e BAMBOO_TOKEN=your-pat \\\n  -e BAMBOO_USERNAME=your-user \\\n  -- npx -y @dnbeu/bamboo-mcp-server\n```\n\nThat's it. Restart Claude Code and the Bamboo tools are available.\n\nOr use the Makefile:\n\n```bash\nmake add-bamboo BAMBOO_URL=https://bamboo.bisnode.com BAMBOO_TOKEN=your-pat BAMBOO_USERNAME=your-user\n```\n\n## Multiple Bamboo Instances\n\nIf you have more than one Bamboo server (e.g. current + legacy), add them as separate MCP servers:\n\n```bash\n# Current (LTS)\nmake add-bamboo BAMBOO_URL=https://bamboo.bisnode.com BAMBOO_TOKEN=your-pat BAMBOO_USERNAME=your-user\n\n# Legacy\nmake add-bamboo-legacy BAMBOO_LEGACY_URL=https://buildtools.bisnode.com/bamboo BAMBOO_LEGACY_TOKEN=your-pat BAMBOO_USERNAME=your-user\n```\n\nThis gives you two tool namespaces — `bamboo__*` and `bamboo-legacy__*` — so you can query both instances in the same conversation.\n\n## Tools\n\n### Projects\n| Tool | Description |\n|------|-------------|\n| `list_projects` | List all Bamboo projects |\n| `get_project` | Get project details |\n| `get_project_permissions` | Get user/group permissions for a project |\n| `grant_project_permission` | Grant permissions on a project |\n| `revoke_project_permission` | Revoke permissions from a project |\n\n### Plans\n| Tool | Description |\n|------|-------------|\n| `list_plans` | List build plans, optionally filtered by project |\n| `get_plan` | Get plan details including stages, branches, and variables |\n| `search_plans` | Search plans by name or key |\n| `list_plan_branches` | List all branches for a plan |\n| `get_plan_branch` | Get branch details with latest build result |\n| `get_plan_repositories` | Get source repositories linked to a plan |\n| `get_plan_permissions` | Get user/group permissions for a plan |\n| `grant_plan_permission` | Grant permissions on a plan |\n| `revoke_plan_permission` | Revoke permissions from a plan |\n\n### Builds\n| Tool | Description |\n|------|-------------|\n| `get_recent_failed_builds` | Get recent failures from the RSS feed (fast) |\n| `get_latest_build_results` | Bulk query build results across projects with date/state filters |\n| `list_build_results` | List results for a specific plan |\n| `get_build_result` | Get detailed result including changes, artifacts, JIRA issues |\n| `get_build_log` | Get build log with tail/range/grep support |\n| `get_build_queue` | View the current build queue |\n| `queue_build` | Trigger a new build |\n| `stop_build` | Stop a running or queued build |\n\n### Deployments\n| Tool | Description |\n|------|-------------|\n| `get_deployment_dashboard` | Dashboard of latest deployment results across all environments |\n| `list_deployment_projects` | List all deployment projects |\n| `get_deployment_project` | Get deployment project details and environments |\n| `get_deployments_for_plan` | Find deployment projects linked to a build plan |\n| `list_deployment_versions` | List release versions for a deployment project |\n| `get_version_status` | Get version deployment status across all environments |\n| `get_deployment_results` | Get deployment results for an environment |\n| `get_deployment_log` | Get deployment log with tail/range/grep support |\n| `get_deployment_queue` | View the current deployment queue |\n| `trigger_deployment` | Deploy a version to an environment |\n| `get_environment_permissions` | Get permissions for a deployment environment |\n| `grant_environment_permission` | Grant permissions on an environment |\n| `revoke_environment_permission` | Revoke permissions from an environment |\n\n### Agents\n| Tool | Description |\n|------|-------------|\n| `list_agents` | List all build agents and their status |\n| `get_agent` | Get agent details and capabilities |\n| `enable_agent` | Enable a build agent |\n| `disable_agent` | Disable a build agent |\n\n## Prerequisites\n\n- Node.js 18+\n- A Bamboo Personal Access Token (PAT) with API access\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or another MCP-compatible client\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BAMBOO_URL` | Yes | Bamboo base URL (e.g. `https://bamboo.bisnode.com`) |\n| `BAMBOO_TOKEN` | Yes | Personal Access Token for API authentication |\n| `BAMBOO_USERNAME` | Yes | Username for Basic auth fallback (required for log downloads) |\n\n## Companion MCP Servers\n\nFor a complete CI/CD troubleshooting setup, pair this server with:\n\n| Server | Purpose | Install |\n|--------|---------|---------|\n| [kubernetes-mcp-server](https://github.com/containers/kubernetes-mcp-server) | Kubernetes cluster access (pods, logs, events) | `make add-kubernetes` |\n| [github-mcp-server](https://github.com/github/github-mcp-server) | GitHub repos, PRs, code changes | `make add-github GITHUB_TOKEN=...` |\n| [Atlassian Rovo MCP](https://www.atlassian.com/platform/rovo-mcp) | Jira + Confluence + Teamwork Graph | Org-managed (authenticate on first use) |\n\nRun `make add-all` to configure Bamboo, Kubernetes, and GitHub in one command.\n\n## Example Workflow\n\n```\nYou: \"Why did the last build fail and what's the current state in dev?\"\n\nClaude traces: build result -> deployment log -> GitHub diff -> k8s pod status\n  1. get_build_result PROJ-PLAN-42           (build details + changes)\n  2. get_build_log PROJ-PLAN-JOB1-42         (grep for ERROR)\n  3. get_deployments_for_plan PROJ-PLAN       (find linked environments)\n  4. get_deployment_results <envId>           (latest deployment status)\n  5. k8s pods_list app=my-service             (pod health in cluster)\n  6. GitHub get_pull_request_files            (what changed in the commit)\n```\n\n## License\n\nMIT — D&B Europe\n","readmeFilename":"README.md"}