[Jira Delivery MCP: from Jira ticket to merged PR without leaving your coding agent]
[npm version]
[CI]
[Tool-selection evals: 36/36]
[Node.js 22 or newer]
[MIT license]
An MCP server and agent skill for Jira Cloud. Start a ticket with a ready-to-build brief,
check your branch against its acceptance criteria before the PR, and hand off — from your coding agent.
[Install in Claude Code]
[Add to Cursor]
[Install in VS Code]
How it works
1 · Start a ticket
"I'm starting ABC-1, get me ready."
Readiness, blockers, acceptance criteria, next steps and a branch name — before you write a line.
[The agent lists open issues, then gets a ready-to-build brief for ABC-1]
2 · Verify before the PR
"Check my branch against ABC-1 before I open the PR."
Your 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.
[The branch covers one of two criteria, so the verdict is needs_work]
3 · Hand off
"Post the QA handoff to ABC-1."
QA handoffs, release notes, test plans and reviews. With write-back on, the agent shows you a preview and waits for your approval.
[A comment is previewed; nothing changes in Jira until the user approves]
Install
You need Node.js 22+, your Jira Cloud URL, your Atlassian email and an API token.
[圖片] Claude Code — plugin with the server and the skill
It asks for your site, email and token (the token goes to secure storage). Without the plugin:
[圖片] Cursor
Click Add to Cursor and replace the three placeholder values, or add the JSON below to ~/.cursor/mcp.json.
[圖片] VS Code (GitHub Copilot agent mode)
Click Install in VS Code (or Insiders). VS Code asks for your site, email and token and stores the token as a secret.
Manually: add to .vscode/mcp.json — VS Code uses servers, not mcpServers:
[圖片] Windsurf · [圖片] Claude Desktop · any MCP client
Add to the client's MCP config — Windsurf: Settings → MCP Servers; Claude Desktop: claude_desktop_config.json:
⌨️ Codex CLI
In ~/.codex/config.toml:
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, also attached to each release.
Tools
* Opt-in with JIRA_ENABLE_WRITES=true. Every tool returns typed structuredContent; see the tool reference.
Safe by default
- 🔒 Local and private — runs on your machine over stdio; talks only to your Atlassian site; no telemetry.
- ✋ Read-only unless you opt in — and then every write is previewed, waits for your approval, is sent once and audited.
- 🧱 Ticket text is untrusted — fenced as data, scanned for prompt injection, never turned into instructions.
- 🗝️ Credentials stay in your environment — never logged; redacted from all output.
Documentation
Usage · Tools · Configuration · Security · Troubleshooting · Migrating from 1.x · Changelog
Contributing
Issues and pull requests are welcome — see CONTRIBUTING.md. Security reports: SECURITY.md.
MIT © Teran Sarathchandra