{"_id":"azure-board-mcp","_rev":"8-5a25cb8534b2dddc0f2f842c8c65f03b","name":"azure-board-mcp","dist-tags":{"latest":"1.7.0"},"versions":{"1.0.0":{"name":"azure-board-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards"],"license":"MIT","_id":"azure-board-mcp@1.0.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-boards-mcp":"src/index.ts"},"dist":{"shasum":"c099a52d71197cc170a082f57facb805a1c09fa4","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.0.0.tgz","fileCount":5,"integrity":"sha512-QJAUvdAJEgBXrIClwicDtcubJimliJiHJOk+G8yRvq8yF5oh23RmluACgMbAT8udDshK6OXF6VlGztmwsODYdg==","signatures":[{"sig":"MEUCIAINiz12ca96G5YfYLKNXbhI1dTnNltdNRQklYOSaO5IAiEAiyQ2vBU3wWPptdxCotpIeEdBG84nHhg+Mue7DmnwDLQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97145},"type":"module","module":"index.ts","engines":{"bun":">=1.0.0"},"gitHead":"57869eff3795a5ac790c19f206e598d997370614","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","lint":"bunx tsc --noEmit","start":"bun run src/index.ts"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Azure DevOps Boards (work items). Stdio transport; requires Bun.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.0.0_1774589580639_0.7626625854055087","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"azure-board-mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.1.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"d6ecd5fc2155cc5a8d89c38fd09609acc952723d","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.1.0.tgz","fileCount":3,"integrity":"sha512-yegd8wmacVZIQdf/9x6vf6EvoZJJOZLZY1RfqhjrRSQajuj41XPeJU7EvEFBL9y6GDRw2Rco5qu/Xv4EW3DO8Q==","signatures":[{"sig":"MEUCIG09mCmscKE0ZyZulMOumaypp/Pv49zxjShsZMfwlipeAiEAjWZ9Ksq+dbXGqg4nlzjWkvGsy8acCBpFHlXUUjzg8pQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1073242},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"cb7f73214978f5da24b716d11694d2f417fc032c","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"bun run src/index.ts","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@azure/msal-node":"^2.16.2","@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.1.0_1782289103666_0.7223362356272736","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"azure-board-mcp","version":"1.2.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.2.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"fc9acdc9cbe2eb8715ec0276bbd569bcbef1c8ac","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.2.0.tgz","fileCount":3,"integrity":"sha512-5Qp6CNfyQVGpYy/sIBkDHKLNR+ne/jJ+f+8ePlDGG4c9CH3tZs9LjuJ6bfoaNkbiIUnaSdtT5IvzrketOJyu6g==","signatures":[{"sig":"MEYCIQDoGpOjaBDWcTd/lyhmT0s78K5dLh5bdLl+SlFwy000aAIhAPe+0gnqbEYmMt4fOR3PwdBlzptJGh6rIg/Vx3QAtn5a","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":543189},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"cb7f73214978f5da24b716d11694d2f417fc032c","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@azure/msal-node":"^2.16.2","@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.2.0_1782293399978_0.7046911064712136","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"azure-board-mcp","version":"1.4.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.4.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"ce3a374cc6a4839e75ea9613888d801d4563f0d1","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.4.0.tgz","fileCount":3,"integrity":"sha512-yUMpMrsoa817/6iP6h8vYOZ67Lb41wNvnnGJdGUkZ/i2IqoqslOW0T0Jc5mH/tmaP9du+LPawrNStCnWmWUpjA==","signatures":[{"sig":"MEQCIBeOd+GZrHVlBr+xsSt0vpyliioV16QiWpsGpFIpcdDWAiBeILKJ9F+lburS/GU9RVBiKgpH6PKbBMGEf2LE1FG2qQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":570525},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c8e5df324f48297419f28ab5af2b8a7976992517","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.4.0_1782295178454_0.7490505783167518","host":"s3://npm-registry-packages-npm-production"}},"1.4.2":{"name":"azure-board-mcp","version":"1.4.2","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.4.2","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"b159e085bb54a4c2bd3b4ccc80e7541946e5e0ac","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.4.2.tgz","fileCount":3,"integrity":"sha512-VrxDqgKuPYiL4zHk5mbw49bVpCgFT9Jtbm1+VRUO/L9kMKRLttV2rsQJPpqNO3IwJCCEug6A9fgUGHW3qqz8wg==","signatures":[{"sig":"MEQCIB15tkhhWaHgHBRHdGdYu0pz74l8S9sPFPqaR8Sv/ht+AiBwDYnqR1oCQ/zgjFQyHT/cSEBjvPt8Fn8ouCgXhZWikw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":572769},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c8e5df324f48297419f28ab5af2b8a7976992517","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.4.2_1782299326184_0.05588907218956218","host":"s3://npm-registry-packages-npm-production"}},"1.5.0":{"name":"azure-board-mcp","version":"1.5.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.5.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"1cc0023327acab6b3becec806d9fdf1978590911","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.5.0.tgz","fileCount":3,"integrity":"sha512-c1ndcEbKZUqjDNi3tH2Y57jGbNvIaT1YslyciG4XjFiwcRQjLJCUmZjE2bb+3YMJDKJdhUcFrTY14eRUNb3xyA==","signatures":[{"sig":"MEUCIQDBb8wcQRDzObArVLfvH+ksuhn2z55gF0L8h+AYWQoNtgIgC9bUmVmgbK3727q5O1yqjHYPMS8sGPjnjpSaEAa8o/g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":568732},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c8e5df324f48297419f28ab5af2b8a7976992517","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.5.0_1782302414028_0.6912934828442296","host":"s3://npm-registry-packages-npm-production"}},"1.6.0":{"name":"azure-board-mcp","version":"1.6.0","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"license":"MIT","_id":"azure-board-mcp@1.6.0","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"homepage":"https://github.com/broisnischal/azure-mcp#readme","bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"dist":{"shasum":"3cd3e4f8fd3ed67a81f80b61671efd42e9a8b286","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.6.0.tgz","fileCount":3,"integrity":"sha512-8Eh5dom6D3dlTKOHjRMnty0GAFHq8ft1cH7TogRyxv3XyrKoopsVIB38ZVrkGuCRAuBa5DpCL7HYit6ebd78ow==","signatures":[{"sig":"MEUCIQD+zYLD/KyhNLVk1q6VQ7RydkiSI0SnCwbhYvQzVh2l6gIgEU5LBT5jHBNqWwZMeoZ2Mr5B3qBmL2gm/yHxOKsv4ew=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":586629},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"87bb1d825d4911afae0dd020e5dfddd3f28d6bac","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/azure-board-mcp_1.6.0_1782449076813_0.7879060442853938","host":"s3://npm-registry-packages-npm-production"}},"1.7.0":{"_id":"azure-board-mcp@1.7.0","bin":{"azure-mcp":"dist/index.js","azure-board-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"dist":{"shasum":"54c7beab4ce3d208c81f241400e68a452224e1ad","tarball":"https://registry.npmjs.org/azure-board-mcp/-/azure-board-mcp-1.7.0.tgz","fileCount":3,"integrity":"sha512-9L0xPZBm/OtdzqGDrgqw30ErkNQO+Jb5OQCmMmhRnlsOC92vnhnLVTDMuiSKgamND7L5WBwehswokrkeQvS3qA==","signatures":[{"sig":"MEQCIBN+dA/BMBtpQFSVfunoctQ88YwEhzMwu0MovBYHQHUHAiBoQFNmkibLb7D9X5GLm/i5q33Lktbfx2UWImSXWeurGg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDjdKNujUXt9rcJx8HRP8W8xUnL5mY0C/b6T/0lzvzjZAiAgv+v4IfevIDsKaO/P6HRV6TdFk2Y5FKV4Gk+2BxTyoA=="}],"unpackedSize":609727},"main":"./dist/index.js","name":"azure-board-mcp","type":"module","engines":{"node":">=18.0.0"},"gitHead":"4f5773d529b1ad5dd9a07077e8f79f9b7a76e7c2","license":"MIT","mcpName":"io.github.broisnischal/azure-mcp","scripts":{"dev":"bun run src/index.ts","auth":"node dist/index.js authenticate","link":"bun run build && npm link","lint":"bunx tsc --noEmit","build":"bun build src/index.ts --outfile dist/index.js --target node","start":"node dist/index.js","unlink":"npm unlink -g azure-board-mcp","auth:pat":"node dist/index.js authenticate --pat","auth:check":"node dist/index.js check","auth:logout":"node dist/index.js logout","publish:npm":"npm publish --access public","prepublishOnly":"bun run build"},"version":"1.7.0","_npmUser":{"name":"neeswebservice","email":"neeswebservice@gmail.com"},"homepage":"https://github.com/broisnischal/azure-mcp#readme","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","directories":{},"maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"_nodeVersion":"25.0.0","dependencies":{"@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/azure-board-mcp_1.7.0_1793172365482_0.35247199389300143"}}},"time":{"created":"2026-03-27T05:33:00.524Z","modified":"2026-10-28T07:26:05.917Z","1.0.0":"2026-03-27T05:33:00.806Z","1.1.0":"2026-06-24T08:18:23.794Z","1.2.0":"2026-06-24T09:30:00.115Z","1.4.0":"2026-06-24T09:59:38.600Z","1.4.2":"2026-06-24T11:08:46.366Z","1.5.0":"2026-06-24T12:00:14.191Z","1.6.0":"2026-06-26T04:44:36.950Z","1.7.0":"2026-10-28T07:26:05.687Z"},"bugs":{"url":"https://github.com/broisnischal/azure-mcp/issues"},"license":"MIT","homepage":"https://github.com/broisnischal/azure-mcp#readme","keywords":["mcp","model-context-protocol","azure-devops","azure-boards","azure-pipelines"],"repository":{"url":"git+https://github.com/broisnischal/azure-mcp.git","type":"git"},"description":"MCP server for Azure DevOps — work items, builds, and PRs. Installable via npx/bunx with OAuth or PAT auth.","maintainers":[{"name":"neeswebservice","email":"neeswebservice@gmail.com"}],"readme":"# azure-board-mcp\n\nMCP server for [Azure DevOps](https://azure.microsoft.com/en-us/products/devops). Work with tasks, sprints, bugs, pull requests, repositories, and pipelines directly from Claude, Cursor, or any MCP-compatible AI.\n\n---\n\n## Quick start\n\n```bash\n# 1. Configure your editors (Claude Code, Cursor, VS Code, Claude Desktop)\nnpx azure-board-mcp install\n\n# 2. Sign in once\nnpx azure-board-mcp authenticate\n\n# 3. Restart your editor — done\n```\n\nOn first use the AI will ask which Azure DevOps project to work on and remember it.\n\n---\n\n## Install & authenticate\n\n### Browser sign-in (default)\n\n```bash\nnpx azure-board-mcp authenticate\n```\n\nOpens your browser for Microsoft sign-in. Picks your org from a list. No Azure AD app setup required — uses a shared app registration built into the package.\n\n### PAT — Personal Access Token\n\nFor headless / CI environments or orgs that block third-party OAuth:\n\n```bash\nnpx azure-board-mcp authenticate --pat\n```\n\nCreate a PAT at `https://dev.azure.com/{org}/_usersSettings/tokens` with scopes: **Work Items (Read & Write)**, **Build (Read)**, **Code (Read)**.\n\n---\n\n## Editor setup\n\n### Option A — automatic (recommended)\n\n```bash\nnpx azure-board-mcp install\n```\n\nDetects and configures Claude Code, Cursor, VS Code, and Claude Desktop automatically.\n\n### Option B — manual\n\n**Claude Code** (`~/.claude/settings.json`):\n```json\n{\n  \"mcpServers\": {\n    \"azure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"azure-board-mcp@latest\"]\n    }\n  }\n}\n```\n\n**Cursor** (`~/.cursor/mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"azure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"azure-board-mcp@latest\"]\n    }\n  }\n}\n```\n\n**VS Code** (User `settings.json`):\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"azure\": {\n        \"type\": \"stdio\",\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"azure-board-mcp@latest\"]\n      }\n    }\n  }\n}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"azure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"azure-board-mcp@latest\"]\n    }\n  }\n}\n```\n\n---\n\n## Claude Code skill\n\nInstall a skill so Claude automatically knows when to use this MCP:\n\n```bash\nnpx azure-board-mcp skills\n```\n\nThis installs `~/.claude/skills/azure-board-mcp/SKILL.md`. After restarting Claude Code, it will proactively use Azure DevOps tools whenever you ask about tasks, sprints, PRs, builds, etc.\n\n---\n\n## CLI reference\n\n```\nnpx azure-board-mcp <command>\n\nCOMMANDS\n  install               Auto-configure MCP in detected editors\n  skills                Install the Claude Code skill\n  authenticate          Browser OAuth sign-in\n  authenticate --pat    Personal Access Token sign-in\n  check                 Validate stored credentials\n  logout                Clear stored credentials\n  help                  Show help\n\nAUTHENTICATE FLAGS\n  --pat                 Use PAT instead of browser OAuth\n  --read-only           Request read-only OAuth scopes\n  --client-id <id>      Use your own Azure AD app\n  --tenant-id <id>      Specify tenant (single-tenant apps only)\n```\n\n---\n\n## Tools (30)\n\n> Work-item, commit, and PR lists are **paginated** — they return a compact page\n> (default 15, max 50) with a `Showing X–Y of N` header. Pass `skip` to page\n> through results instead of requesting a large `top`. List views fetch only the\n> fields they render, so they're fast and light on context.\n\n### Auth & project\n| Tool | When to use |\n|---|---|\n| `auth_status` | Diagnose auth issues, check which project is active |\n| `switch_project` | Change the active project, or list available ones |\n\n### Work items\n| Tool | When to use |\n|---|---|\n| `list_work_items` | My tasks, sprint board, filter by state/type/keyword (paginated) |\n| `get_work_item` | Full detail on a specific ticket: every field (custom ones like Definition of Done too), all comments, PRs. Nothing truncated |\n| `create_work_item` | Create a task, bug, user story, epic, feature |\n| `update_work_item` | Close, reassign, move sprint, update estimates |\n| `add_comment` | Post a note or status update on a ticket |\n| `list_comments` / `update_comment` / `delete_comment` | Read, edit, or delete ticket comments by ID |\n| `list_child_work_items` | Subtasks of a ticket, optionally the whole subtree |\n| `delete_work_item` | Move to Recycle Bin, or destroy permanently |\n| `link_work_items` | Set parent/child, related, or dependency links |\n| `query_wiql` | Advanced queries with custom WIQL (paginated) |\n| `get_work_item_history` | Audit trail — which fields changed, when, by whom |\n| `get_backlog` | Ordered, priority-ranked product backlog |\n\n### Boards, sprints & teams\n| Tool | When to use |\n|---|---|\n| `get_sprint` | Current sprint dates and team capacity |\n| `list_sprints` | All sprints with start/end dates |\n| `get_board` | Kanban columns, state mappings, WIP limits |\n| `list_team_members` | Who's on a team (names, emails, admin flag) |\n| `list_paths` | Valid area / iteration path values for create/update |\n\n### Repositories\n| Tool | When to use |\n|---|---|\n| `list_repos` | Discover repo names and URLs |\n| `list_files` | Browse directory structure |\n| `get_file` | Read file contents (up to 500 lines) |\n| `list_commits` | Recent commits on a branch (paginated) |\n| `list_pull_requests` | Open PRs, reviewer votes, merge status (paginated) |\n| `list_branches` | Branches with ahead/behind counts |\n| `create_pr` | Open a PR with reviewers (by email), linked work items, optional auto-complete |\n| `get_pull_request` | Full PR: description, reviewers and votes, linked work items, changed files |\n| `list_pr_comments` | Comment threads with file/line context and replies |\n| `add_pr_comment` | General comment, inline file comment, or reply to a thread |\n| `update_pr_thread` | Resolve or reopen a thread |\n| `vote_pr` | Approve, approve with suggestions, wait for author, reject, reset |\n| `manage_pr_reviewers` | Add (optionally required) or remove reviewers |\n| `update_pr` | Edit title/description/draft, complete (merge), auto-complete, abandon, reactivate |\n\n### Pipelines, builds & releases\n| Tool | When to use |\n|---|---|\n| `list_pipelines` | Discover pipeline definitions |\n| `list_builds` | Recent builds — status, result, branch, link |\n| `run_pipeline` | Trigger a pipeline run |\n| `get_build_timeline` | Which stage/job/task failed, with error/warning counts |\n| `get_build_logs` | Full logs and error messages of failed steps, or any step by name or log ID |\n| `cancel_build` | Cancel an in-progress build |\n| `list_releases` | Recent releases with per-environment deploy status |\n| `create_release` | Create and trigger a release from a definition |\n\n---\n\n## Environment variables\n\nOverride stored credentials — useful for CI/Docker:\n\n```bash\nAZURE_ORG=my-org\nAZURE_PROJECT=my-project\nAZURE_PAT=my-pat        # PAT auth\nAUTH_TOKEN=my-token     # OAuth bearer token\n```\n\n---\n\n## Using your own Azure AD app\n\nBy default everyone shares the built-in app registration. If your org blocks it, or you need full control:\n\n**1. Register the app**\n\n1. [Azure Portal → App registrations → New registration](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps)\n2. Name: anything (e.g. `azure-board-mcp`)\n3. Supported account types: **\"Any organizational directory\"** (multitenant) or **\"My organization only\"**\n4. Click **Register**\n\n**2. Configure it**\n\nIn **Authentication**:\n1. **Add a platform → Mobile and desktop applications** → check `http://localhost` → Configure\n2. **Allow public client flows → Yes → Save**\n\nIn **API permissions**:\n1. Add a permission → **APIs my organization uses** → search `Azure DevOps`\n2. Select **`user_impersonation`** (delegated) → Add\n3. Click **Grant admin consent** (optional — skips the per-user consent prompt)\n\n**3. Use it**\n\n```bash\nnpx azure-board-mcp authenticate --client-id <your-app-id>\n\n# Single-tenant:\nnpx azure-board-mcp authenticate --client-id <your-app-id> --tenant-id <your-tenant-id>\n```\n\n**For org admins** — pre-approve for everyone in your org:\n\n```\nhttps://login.microsoftonline.com/{tenant-id}/adminconsent\n  ?client_id=e2ba32e7-6d24-4919-ba7b-37199c495247\n  &redirect_uri=http://localhost\n```\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}