{"_id":"jira-delivery-mcp","_rev":"5-98ac092095e81a2f13248a16ac79d461","name":"jira-delivery-mcp","dist-tags":{"latest":"2.0.0","beta":"2.0.0"},"versions":{"1.0.0":{"name":"jira-delivery-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","mcp-server","jira","confluence","atlassian","claude","claude-code","codex","cursor","ai-agent","developer-tools"],"author":{"name":"Teran Sarathchandra"},"license":"MIT","_id":"jira-delivery-mcp@1.0.0","maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"bin":{"jira-delivery-mcp":"dist/index.js"},"dist":{"shasum":"b8ccd5e1989b8225cf3ad10957f0d9e149f79b84","tarball":"https://registry.npmjs.org/jira-delivery-mcp/-/jira-delivery-mcp-1.0.0.tgz","fileCount":369,"integrity":"sha512-FzmOYWlCZPZoJ2m1RB2hIHIFjW39fQlKkJo4sxz3RienrG7oY25lujzxtESScbCbyOT+rcPVUVxO/W2083lPew==","signatures":[{"sig":"MEUCIQC7ec8Qc+U616pdLNzO6K0USM4ZL+vfLuwFKb5qQS0TIwIgJ0bqzCwaqY/bcccd9EQSmGsjgzweJ9oAWJyJh8kAtio=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1410549},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8a128b99f34349631230a7d2d56f16fe7e553e82","scripts":{"dev":"node --env-file=.env dist/index.js","lint":"tsc --noEmit","test":"vitest run","build":"tsc","postbuild":"node -e \"import('fs').then(fs => fs.chmodSync('dist/index.js', 0o755))\"","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build","security:audit":"npm audit --audit-level=moderate"},"_npmUser":{"name":"teransarathchandra","email":"teran8777@gmail.com"},"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"_npmVersion":"11.12.0","description":"Client-agnostic MCP server for Jira and Confluence — delivery intelligence, implementation prompts, and workflow automation for any AI coding agent","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-delivery-mcp_1.0.0_1785302158343_0.8538790690440146","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"jira-delivery-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","mcp-server","jira","confluence","atlassian","claude","claude-code","codex","cursor","ai-agent","developer-tools"],"author":{"name":"Teran Sarathchandra"},"license":"MIT","_id":"jira-delivery-mcp@1.0.1","maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"bin":{"jira-delivery-mcp":"dist/index.js"},"dist":{"shasum":"440cf202284139b66ff706a5e5d58d37a89ba465","tarball":"https://registry.npmjs.org/jira-delivery-mcp/-/jira-delivery-mcp-1.0.1.tgz","fileCount":369,"integrity":"sha512-Zp4PG2DfQqjNABRcPjOCnFjOdXb63X+rZgkwApSzqxd+533PKGOBwupypiSuOTd/DNqENCNpUchwvMGyy7trYg==","signatures":[{"sig":"MEYCIQDigZHxNI2GR1eeF0szbej3F/73GUnf60PqZBedy+8LhwIhAI16z7rfHu1XvLAxXK8K8AAHOhRVjsYcLTGOF8k4hxJQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1410918},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d9afc6f15c1ad8a84ca2df6cc2c8a69aa9e8183e","scripts":{"dev":"node --env-file=.env dist/index.js","lint":"tsc --noEmit","test":"vitest run","build":"tsc","postbuild":"node -e \"import('fs').then(fs => fs.chmodSync('dist/index.js', 0o755))\"","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build","security:audit":"npm audit --audit-level=moderate"},"_npmUser":{"name":"teransarathchandra","email":"teran8777@gmail.com"},"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"_npmVersion":"11.12.0","description":"Client-agnostic MCP server for Jira and Confluence — delivery intelligence, implementation prompts, and workflow automation for any AI coding agent","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-delivery-mcp_1.0.1_1785342721989_0.46564867591564973","host":"s3://npm-registry-packages-npm-production"}},"2.0.0-beta.1":{"name":"jira-delivery-mcp","version":"2.0.0-beta.1","keywords":["mcp","model-context-protocol","mcp-server","jira","confluence","atlassian","claude","claude-code","codex","cursor","ai-agent","developer-tools"],"author":{"name":"Teran Sarathchandra"},"license":"MIT","_id":"jira-delivery-mcp@2.0.0-beta.1","maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"bin":{"jira-delivery-mcp":"dist/index.js"},"dist":{"shasum":"518c99208cbd6fad11a647c82edf65af86c2dbbf","tarball":"https://registry.npmjs.org/jira-delivery-mcp/-/jira-delivery-mcp-2.0.0-beta.1.tgz","fileCount":454,"integrity":"sha512-G18z4pJcl74BYGD/c+7Kkp+IMg2EDJLu3e17hunPQBeRq/gQVMkT2uOoHBcjjMvDqn+AwTl2yABFn14QrU/63w==","signatures":[{"sig":"MEYCIQCOcNMDxd1ft0MZdguU1xfy6PzS5IvN3a5lLt99d8+35wIhAOVyghAfjTaBLTXyihPhnykaej2uD1V3/OXP7ETUDi8I","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQD6QIBI1+5nt12SvZKGlTaYfv+AxzZSM3UEOd+sp21nZQIgKinmNtZuOmYjVbQnPPtemC1EL2gcBZako7O8JT72gU4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1396015},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"b52035443d5e4e43be6ea76a7fc149f01b4b98a3","scripts":{"dev":"node --env-file=.env dist/index.js","lint":"tsc --noEmit","test":"vitest run","build":"tsc","postbuild":"node -e \"import('fs').then(fs => fs.chmodSync('dist/index.js', 0o755))\"","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build","security:audit":"npm audit --audit-level=moderate"},"_npmUser":{"name":"teransarathchandra","email":"teran8777@gmail.com"},"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"_npmVersion":"12.2.0","description":"Client-agnostic MCP server for Jira and Confluence — delivery intelligence, implementation prompts, and workflow automation for any AI coding agent","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^4.1.12","typescript":"^5.3.0","@types/node":"^20.19.43","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/jira-delivery-mcp_2.0.0-beta.1_1792429008560_0.36158414885032264","host":"s3://npm-registry-packages-npm-production"}},"2.0.0-beta.2":{"name":"jira-delivery-mcp","version":"2.0.0-beta.2","keywords":["mcp","model-context-protocol","mcp-server","jira","confluence","atlassian","claude","claude-code","codex","cursor","ai-agent","developer-tools"],"author":{"name":"Teran Sarathchandra"},"license":"MIT","_id":"jira-delivery-mcp@2.0.0-beta.2","maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"bin":{"jira-delivery-mcp":"dist/index.js"},"dist":{"shasum":"4bc9fdb569c5edce4ffe4f8fa54e9731ffb2c1a2","tarball":"https://registry.npmjs.org/jira-delivery-mcp/-/jira-delivery-mcp-2.0.0-beta.2.tgz","fileCount":454,"integrity":"sha512-JhX84319WBNPwIDNBbkP++XKVkUqeMVQaZA2WJF+HOy/gA7PhoGmFL0nYgDnkrGRqvtUZre6sTfMKUX5NC86iA==","signatures":[{"sig":"MEUCIFabegRzQiAYi762JDpB6D2qO9mYDLd6KSN46RRghRzIAiEA58WkRYHlYuosk6eiupXJ3p0612vnA9fxWILEJDbWgK4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCiaFxhS1JymTKrBmHC1vUJCIw16mAnj1s+RUGw5uQBbwIhALL2+I5VlIat82sxRLqj+wLnrSI2OsVrpAr5AFuxgfq4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1401965},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"279e59cc5803760e405f4ae3c32695f97c459159","scripts":{"dev":"node --env-file=.env dist/index.js","lint":"tsc --noEmit","test":"vitest run","build":"tsc","postbuild":"node -e \"import('fs').then(fs => fs.chmodSync('dist/index.js', 0o755))\"","typecheck":"tsc --noEmit","prepublishOnly":"npm run typecheck && npm run build","security:audit":"npm audit --audit-level=moderate"},"_npmUser":{"name":"teransarathchandra","email":"teran8777@gmail.com"},"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"_npmVersion":"12.2.0","description":"Client-agnostic MCP server for Jira and Confluence — delivery intelligence, implementation prompts, and workflow automation for any AI coding agent","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^4.1.12","typescript":"^5.3.0","@types/node":"^20.19.43","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/jira-delivery-mcp_2.0.0-beta.2_1792429676883_0.7578082775390151","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"_id":"jira-delivery-mcp@2.0.0","bin":{"jira-delivery-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"dist":{"shasum":"738ab8e534165f9e5f3adb06474e89c3a3f0278d","tarball":"https://registry.npmjs.org/jira-delivery-mcp/-/jira-delivery-mcp-2.0.0.tgz","fileCount":521,"integrity":"sha512-s/uFbGQ9j6Myn7tWW4PajVwr8mwcrAiFDPJbbEB+EaupNcxfBKdUgPXetvNlwK+lsKja68Rp+9AfXyfoCC6peA==","signatures":[{"sig":"MEUCIQDItavn6dIUgT7K0OxXjDxzH5A6HP1PnTvMZSPuZoVsrAIgRIKocrYgdwH9m9vLLdfIazp0uZEI/VafVUYhGKrBTes=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFDWf7o2TBbghhnxqcdMFXklF1xI5tpr6P6ny2SrVafnAiBJfvC0S+Xytgs7it/aO9kZQsBIfSqqCU+hv5Ch7afVZQ=="}],"unpackedSize":1560454},"main":"dist/index.js","name":"jira-delivery-mcp","type":"module","types":"dist/index.d.ts","author":{"name":"Teran Sarathchandra"},"engines":{"node":">=22"},"gitHead":"521a77be0111bd29d94d8713e68b9e35046697ea","license":"MIT","mcpName":"io.github.teransarathchandra/jira-delivery-mcp","scripts":{"dev":"node --env-file=.env dist/index.js","eval":"npm run build --silent && vitest run --config evals/vitest.config.ts","test":"vitest run","build":"tsc","postbuild":"node -e \"import('fs').then(fs => fs.chmodSync('dist/index.js', 0o755))\"","typecheck":"tsc --noEmit","skill:pack":"node scripts/pack-skill.mjs","prepublishOnly":"npm run typecheck && npm run build","security:audit":"npm audit --audit-level=moderate"},"version":"2.0.0","_npmUser":{"name":"teransarathchandra","email":"teran8777@gmail.com"},"homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-cloud","confluence","atlassian","claude-code","cursor","vscode","github-copilot","codex","agent-skills","ai-agents","developer-tools"],"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"_npmVersion":"12.2.0","description":"MCP server and agent skill for Jira Cloud: ready-to-build briefs, branch checks against acceptance criteria, QA handoffs and safe write-back for Claude Code, Cursor, VS Code and any MCP client","directories":{},"maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^5.0.5","typescript":"^7.0.2","@types/node":"^22.20.5","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-delivery-mcp_2.0.0_1792853321644_0.6301401040333812"}}},"time":{"created":"2026-07-29T05:15:58.171Z","modified":"2026-10-24T14:48:41.933Z","1.0.0":"2026-07-29T05:15:58.524Z","1.0.1":"2026-07-29T16:32:02.224Z","2.0.0-beta.1":"2026-10-19T16:56:48.704Z","2.0.0-beta.2":"2026-10-19T17:07:57.031Z","2.0.0":"2026-10-24T14:48:41.775Z"},"bugs":{"url":"https://github.com/teransarathchandra/jira-mcp-server/issues"},"author":{"name":"Teran Sarathchandra"},"license":"MIT","homepage":"https://github.com/teransarathchandra/jira-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-cloud","confluence","atlassian","claude-code","cursor","vscode","github-copilot","codex","agent-skills","ai-agents","developer-tools"],"repository":{"url":"git+https://github.com/teransarathchandra/jira-mcp-server.git","type":"git"},"description":"MCP server and agent skill for Jira Cloud: ready-to-build briefs, branch checks against acceptance criteria, QA handoffs and safe write-back for Claude Code, Cursor, VS Code and any MCP client","maintainers":[{"name":"teransarathchandra","email":"teran8777@gmail.com"}],"readme":"<p align=\"center\">\n  <img src=\"docs/assets/banner.svg\" alt=\"Jira Delivery MCP: from Jira ticket to merged PR without leaving your coding agent\" width=\"100%\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/jira-delivery-mcp\"><img src=\"https://img.shields.io/npm/v/jira-delivery-mcp?logo=npm&label=npm&color=cb3837\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/teransarathchandra/jira-mcp-server/actions/workflows/ci.yml\"><img src=\"https://github.com/teransarathchandra/jira-mcp-server/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n  <a href=\"evals/README.md\"><img src=\"https://img.shields.io/badge/tool--selection%20evals-36%2F36-2ea44f\" alt=\"Tool-selection evals: 36/36\"></a>\n  <img src=\"https://img.shields.io/badge/node-%E2%89%A522-339933?logo=nodedotjs&logoColor=white\" alt=\"Node.js 22 or newer\">\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"MIT license\"></a>\n</p>\n\n<p align=\"center\">\n  An MCP server and agent skill for <b>Jira Cloud</b>. Start a ticket with a ready-to-build brief,<br>\n  check your branch against its acceptance criteria before the PR, and hand off — from your coding agent.\n</p>\n\n<p align=\"center\">\n  <a href=\"#install\"><img src=\"https://img.shields.io/badge/Claude_Code-Install_plugin-D97757?style=for-the-badge&logo=claude&logoColor=white\" alt=\"Install in Claude Code\"></a>\n  <a href=\"https://cursor.com/install-mcp?name=jira-delivery&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImppcmEtZGVsaXZlcnktbWNwIl0sImVudiI6eyJKSVJBX0JBU0VfVVJMIjoiaHR0cHM6Ly95b3VyLWRvbWFpbi5hdGxhc3NpYW4ubmV0IiwiSklSQV9FTUFJTCI6InlvdUBleGFtcGxlLmNvbSIsIkpJUkFfQVBJX1RPS0VOIjoieW91ci1hcGktdG9rZW4ifX0%3D\"><img src=\"https://img.shields.io/badge/Cursor-Add_server-000000?style=for-the-badge&logo=cursor&logoColor=white\" alt=\"Add to Cursor\"></a>\n  <a href=\"https://insiders.vscode.dev/redirect/mcp/install?name=jira-delivery&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_base_url%22%2C%22description%22%3A%22Jira%20site%20URL%2C%20e.g.%20https%3A%2F%2Fyour-domain.atlassian.net%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_email%22%2C%22description%22%3A%22Atlassian%20account%20email%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_api_token%22%2C%22description%22%3A%22Jira%20API%20token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22jira-delivery-mcp%22%5D%2C%22env%22%3A%7B%22JIRA_BASE_URL%22%3A%22%24%7Binput%3Ajira_base_url%7D%22%2C%22JIRA_EMAIL%22%3A%22%24%7Binput%3Ajira_email%7D%22%2C%22JIRA_API_TOKEN%22%3A%22%24%7Binput%3Ajira_api_token%7D%22%7D%7D\"><img src=\"https://img.shields.io/badge/VS_Code-Install_server-0098FF?style=for-the-badge&logo=githubcopilot&logoColor=white\" alt=\"Install in VS Code\"></a>\n</p>\n\n\n## How it works\n\n### 1 · Start a ticket\n\n> *\"I'm starting ABC-1, get me ready.\"*\n\nReadiness, blockers, acceptance criteria, next steps and a branch name — before you write a line.\n\n<img src=\"docs/assets/start.gif\" alt=\"The agent lists open issues, then gets a ready-to-build brief for ABC-1\" width=\"100%\">\n\n### 2 · Verify before the PR\n\n> *\"Check my branch against ABC-1 before I open the PR.\"*\n\nYour local diff against the acceptance criteria and Definition of Done, with one verdict — `ready_for_pr`, `needs_work` or `insufficient_evidence` — and the files behind each criterion.\n\n<img src=\"docs/assets/verify.gif\" alt=\"The branch covers one of two criteria, so the verdict is needs_work\" width=\"100%\">\n\n### 3 · Hand off\n\n> *\"Post the QA handoff to ABC-1.\"*\n\nQA handoffs, release notes, test plans and reviews. With write-back on, the agent shows you a preview and waits for your approval.\n\n<img src=\"docs/assets/handoff.gif\" alt=\"A comment is previewed; nothing changes in Jira until the user approves\" width=\"100%\">\n\n## Install\n\nYou need **Node.js 22+**, your Jira Cloud URL, your Atlassian email and an [API token](https://id.atlassian.com/manage-profile/security/api-tokens).\n\n<details open>\n<summary><img src=\"https://cdn.simpleicons.org/claude\" height=\"16\" alt=\"\"> <b>Claude Code</b> — plugin with the server and the skill</summary>\n\n```\n/plugin marketplace add teransarathchandra/jira-mcp-server\n/plugin install jira-delivery@jira-delivery\n```\n\nIt asks for your site, email and token (the token goes to secure storage). Without the plugin:\n\n```bash\nclaude mcp add jira-delivery \\\n  -e JIRA_BASE_URL=https://your-domain.atlassian.net \\\n  -e JIRA_EMAIL=you@example.com \\\n  -e JIRA_API_TOKEN=your-api-token \\\n  -- npx -y jira-delivery-mcp\n```\n\n</details>\n\n<details>\n<summary><img src=\"https://cdn.simpleicons.org/cursor/000000/ffffff\" height=\"16\" alt=\"\"> <b>Cursor</b></summary>\n\nClick **[Add to Cursor](https://cursor.com/install-mcp?name=jira-delivery&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImppcmEtZGVsaXZlcnktbWNwIl0sImVudiI6eyJKSVJBX0JBU0VfVVJMIjoiaHR0cHM6Ly95b3VyLWRvbWFpbi5hdGxhc3NpYW4ubmV0IiwiSklSQV9FTUFJTCI6InlvdUBleGFtcGxlLmNvbSIsIkpJUkFfQVBJX1RPS0VOIjoieW91ci1hcGktdG9rZW4ifX0%3D)** and replace the three placeholder values, or add the [JSON below](#json-config) to `~/.cursor/mcp.json`.\n\n</details>\n\n<details>\n<summary><img src=\"https://cdn.simpleicons.org/githubcopilot/000000/ffffff\" height=\"16\" alt=\"\"> <b>VS Code</b> (GitHub Copilot agent mode)</summary>\n\nClick **[Install in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=jira-delivery&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_base_url%22%2C%22description%22%3A%22Jira%20site%20URL%2C%20e.g.%20https%3A%2F%2Fyour-domain.atlassian.net%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_email%22%2C%22description%22%3A%22Atlassian%20account%20email%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_api_token%22%2C%22description%22%3A%22Jira%20API%20token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22jira-delivery-mcp%22%5D%2C%22env%22%3A%7B%22JIRA_BASE_URL%22%3A%22%24%7Binput%3Ajira_base_url%7D%22%2C%22JIRA_EMAIL%22%3A%22%24%7Binput%3Ajira_email%7D%22%2C%22JIRA_API_TOKEN%22%3A%22%24%7Binput%3Ajira_api_token%7D%22%7D%7D)** (or [Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=jira-delivery&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_base_url%22%2C%22description%22%3A%22Jira%20site%20URL%2C%20e.g.%20https%3A%2F%2Fyour-domain.atlassian.net%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_email%22%2C%22description%22%3A%22Atlassian%20account%20email%22%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22jira_api_token%22%2C%22description%22%3A%22Jira%20API%20token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22jira-delivery-mcp%22%5D%2C%22env%22%3A%7B%22JIRA_BASE_URL%22%3A%22%24%7Binput%3Ajira_base_url%7D%22%2C%22JIRA_EMAIL%22%3A%22%24%7Binput%3Ajira_email%7D%22%2C%22JIRA_API_TOKEN%22%3A%22%24%7Binput%3Ajira_api_token%7D%22%7D%7D&quality=insiders)). VS Code asks for your site, email and token and stores the token as a secret.\n\nManually: add to `.vscode/mcp.json` — VS Code uses `servers`, not `mcpServers`:\n\n```json\n{\n  \"servers\": {\n    \"jira-delivery\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"jira-delivery-mcp\"],\n      \"env\": { \"JIRA_BASE_URL\": \"https://your-domain.atlassian.net\", \"JIRA_EMAIL\": \"you@example.com\", \"JIRA_API_TOKEN\": \"your-api-token\" }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><img src=\"https://cdn.simpleicons.org/windsurf/000000/ffffff\" height=\"16\" alt=\"\"> <b>Windsurf</b> · <img src=\"https://cdn.simpleicons.org/claude\" height=\"16\" alt=\"\"> <b>Claude Desktop</b> · any MCP client</summary>\n\n<a id=\"json-config\"></a>Add to the client's MCP config — Windsurf: *Settings → MCP Servers*; Claude Desktop: `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-delivery\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"jira-delivery-mcp\"],\n      \"env\": { \"JIRA_BASE_URL\": \"https://your-domain.atlassian.net\", \"JIRA_EMAIL\": \"you@example.com\", \"JIRA_API_TOKEN\": \"your-api-token\" }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>⌨️ <b>Codex CLI</b></summary>\n\nIn `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.jira-delivery]\ncommand = \"npx\"\nargs = [\"-y\", \"jira-delivery-mcp\"]\nenv = { JIRA_BASE_URL = \"https://your-domain.atlassian.net\", JIRA_EMAIL = \"you@example.com\", JIRA_API_TOKEN = \"your-api-token\" }\n```\n\n</details>\n\n**Check your setup:** with the three variables exported, `npx jira-delivery-mcp doctor` verifies the login and prints the custom-field ids your site needs (acceptance criteria, story points, epic). Other agents can add the [`jira-delivery` skill](plugin/skills/jira-delivery/SKILL.md), also attached to each [release](https://github.com/teransarathchandra/jira-mcp-server/releases).\n\n## Tools\n\n| Step | Tools |\n|---|---|\n| Start | `jira_search_issues` · `jira_get_issue` · `jira_prepare_work_brief` |\n| Verify | `delivery_check_changes` · `delivery_traceability_matrix` |\n| Hand off | `delivery_generate` · `jira_add_comment`\\* · `jira_update_issue`\\* |\n| Context | `confluence_search` · `confluence_get_page` · `delivery_project_patterns` · `delivery_generate_agent_pack` |\n\n\\* Opt-in with `JIRA_ENABLE_WRITES=true`. Every tool returns typed `structuredContent`; see the [tool reference](docs/tools.md).\n\n## Safe by default\n\n- 🔒 **Local and private** — runs on your machine over stdio; talks only to your Atlassian site; no telemetry.\n- ✋ **Read-only unless you opt in** — and then every write is previewed, waits for your approval, is sent once and audited.\n- 🧱 **Ticket text is untrusted** — fenced as data, scanned for prompt injection, never turned into instructions.\n- 🗝️ **Credentials stay in your environment** — never logged; redacted from all output.\n\n## Documentation\n\n[Usage](docs/usage.md) · [Tools](docs/tools.md) · [Configuration](docs/configuration.md) · [Security](docs/security.md) · [Troubleshooting](docs/troubleshooting.md) · [Migrating from 1.x](docs/migrating-from-v1.md) · [Changelog](CHANGELOG.md)\n\n## Contributing\n\nIssues and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). Security reports: [SECURITY.md](SECURITY.md).\n\n[MIT](LICENSE) © Teran Sarathchandra\n","readmeFilename":"README.md"}