{"_id":"mcp-jira-dc","_rev":"6-0444a13fc0b90a5a9963fe43d16500fa","name":"mcp-jira-dc","dist-tags":{"latest":"0.47.1"},"versions":{"0.0.0-stage":{"name":"mcp-jira-dc","version":"0.0.0-stage","_id":"mcp-jira-dc@0.0.0-stage","stub":true,"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"dist":{"shasum":"640ba82bea119a0852ded1155352360aea0b141b","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-6270P5aGypvstb8WBN6KBa0ZVhoYM7AvrTwUoBmoCLk/aSk9EdfhF0/qlIBSYlo31asOcjOlBZ1MIUAgWog4hg==","signatures":[{"sig":"MEUCIGNnxIDAAvr57enP39GpzR9TixW1FOohczKWpM7fYlalAiEA1VcUFiXJbQ/RWFRE9JyFUBaRe0lxhtZmnnmTEDifVFw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":333},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.44.0":{"name":"mcp-jira-dc","version":"0.44.0","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-jira-dc@0.44.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-jira-dc":"bin/run.js"},"dist":{"shasum":"4a16fd4aeb67e6f15928dbe7054b31f6806df1ea","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.44.0.tgz","fileCount":7,"integrity":"sha512-7ICp9cCqAuVm5v0IEqUyIxFOQAHG6tOEfx+bI/6dca+DhcmtfFst6xSVsYzU0nDhUP0BISytI5HVjfhOK12glw==","signatures":[{"sig":"MEQCIBX+fFxdZyD6Xi1+USffTEOaKJCPTH5FfpqJbtXkO0B3AiB0QcYXOHtIFwzTT6cTNEZEJ0U5zWlyt/mc92QZWg7Gog==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHxuSHniB7v+AO786Ls5K9LiepZxjQO9jI8TKdWEA5aWAiBMTK+iHCcpBhhXQ5y52DBuQLaLWWRQyVWSN25KxU504Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":439623},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"6b2f539fbe7baf70216d8ed6fe5eb5724bf16b14","mcpName":"io.github.tekthar/mcp-jira-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/jira"},"_npmVersion":"10.9.7","description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2","@modelcontextprotocol/core":"2.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-jira-dc_0.44.0_1793950816835_0.16976777827198464","host":"s3://npm-registry-packages-npm-production"}},"0.44.1":{"name":"mcp-jira-dc","version":"0.44.1","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-jira-dc@0.44.1","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-jira-dc":"bin/run.js"},"dist":{"shasum":"7b81f9bfea4d1e0613756c85cde94ac4ef2c64b8","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.44.1.tgz","fileCount":7,"integrity":"sha512-MjhZKGT+bHmPBuYAneS2rSTc8d1j4Fc+WFOW/m0dxQ0/ZsBTsjhTBr0A8LRYFHqWbuBb0m87V1rNoRIdCr3Fog==","signatures":[{"sig":"MEYCIQD63I5Nv5oGqARiZYWeMNrMN4MK8Sj0t6p+0+WpID65iAIhAKoZsc1y06ttSd8j7QgoS75AYr8F8C1mManxU9o0a8wk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDhTBIxPxOEnBz0HN2ynqkrGGXg8Lu8Npa8ZEc50FzI3gIhAOt1iQEOL+xKzXaotMCbKP4vBNIzfXmPmDLU9nSbMtbn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":439623},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"64f8abb6dd69704417d425f0e4dbe5a725a813d7","mcpName":"io.github.tekthar/mcp-jira-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"005bf383-13c3-4a9e-b844-d0a7d3b5a68e"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/jira"},"_npmVersion":"11.21.1","description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2","@modelcontextprotocol/core":"2.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-jira-dc_0.44.1_1793953087203_0.3464110899624764","host":"s3://npm-registry-packages-npm-production"}},"0.45.0":{"name":"mcp-jira-dc","version":"0.45.0","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-jira-dc@0.45.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-jira-dc":"bin/run.js"},"dist":{"shasum":"49f0f6c9429ee8c74ce818d18fe652922d4cbac9","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.45.0.tgz","fileCount":7,"integrity":"sha512-GWfAwEgQJN/a9y3z4bohL6dQLo3BzXUw4wnnSsowFAUmcbadrGcgizjBOR+/fhXA4d8AJ48ZIKCzn6TC/qTZoA==","signatures":[{"sig":"MEUCIGTJLhSbsm5l6FxOLJen/GZJRCjD+5FVZgX+lz1WQ7NXAiEAxIcn8JGOZ8fdx0NkjN7sAV7iG4vUYCl8RcCRYXm3ock=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCb1EGzbIPUYtryJVE4D0nXLadDAbxDZo/VHfCxCF2S8gIgX26uDYI0C/xNYkdjrZeFmA2gXJGNQXw1GT5TGA+fNfE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":462848},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"aff0e2d3e575bbfd12da2aec96381ce9c6133fa3","mcpName":"io.github.tekthar/mcp-jira-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"005bf383-13c3-4a9e-b844-d0a7d3b5a68e"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/jira"},"_npmVersion":"11.21.1","description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2","@modelcontextprotocol/core":"2.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-jira-dc_0.45.0_1793969641307_0.19242660629083985","host":"s3://npm-registry-packages-npm-production"}},"0.47.0":{"name":"mcp-jira-dc","version":"0.47.0","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-jira-dc@0.47.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"bin":{"mcp-jira-dc":"bin/run.js"},"dist":{"shasum":"e050d807de888f757cbfb3e3cf3e89e14af81a66","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.47.0.tgz","fileCount":11,"integrity":"sha512-V4W7KcoMZ95msTqUoMWGrydirzJI2ml6qbkhQa/P3aBfY7UKCO3IVYWH9fIiGS4KO2OoyJwIcBBpZRf79EwsAA==","signatures":[{"sig":"MEUCIQD/l9admUtI2yEL3lXA48QpZNw6RYRu8iMMNhSPC8WSSQIgOZD044uA46nB1oG+80n9rJZih6RIpuKR+Gd+zOJoBZ0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEX7jTqt5ISnhEO1yb7S8Y2zDoSmxP/0RnvIPW/6GSSWAiBP4dpYCRmUoLFoR2+p7Ah91sQ6o5YLH9xvUobL+fyMqQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-jira-dc@0.47.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":512575},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"e6d9d1145fd74c0fd3cf8026246cb965fd50ff9e","mcpName":"io.github.tekthar/mcp-jira-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"c608f6ac-b1cb-445b-8704-ad143dc8ae13"}},"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/jira"},"_npmVersion":"11.21.1","description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2","@modelcontextprotocol/core":"2.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-jira-dc_0.47.0_1794002655493_0.11462606507634376","host":"s3://npm-registry-packages-npm-production"}},"0.47.1":{"_id":"mcp-jira-dc@0.47.1","bin":{"mcp-jira-dc":"bin/run.js"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"dist":{"shasum":"60f4b97b627c91eb4abef5a38703f6e2a1f8caa8","tarball":"https://registry.npmjs.org/mcp-jira-dc/-/mcp-jira-dc-0.47.1.tgz","fileCount":11,"integrity":"sha512-W8d9Am88cZ96vd4HywXZEE5Ksk9FIa8iGnQGwzAu1mnP+vDOPW62evVKFlbwDnCRylL7fcez8Y7Rw0g+9Kj+lQ==","signatures":[{"sig":"MEUCIQC08WpFNbTSXNvk9BKA88nHhHfKJIu3ZZ9IfoN57/RyOgIgXTHXSnCkUFs35exRr1gxUGlPLaMik2lOce5J6yeTXN4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD/7PngaFQVZ4jnKTT8IcGZuGKqrXMesfU/hVkll7v2IAIgIU2h+daQphyhvmjCTfjkby4FYP8T+lWPRRDR/BxdZ48="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-jira-dc@0.47.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":513353},"main":"dist/index.js","name":"mcp-jira-dc","type":"module","engines":{"node":">=22.22.2"},"gitHead":"027433c1b737a9e56733e29303e5bf7f4bbe2d03","license":"MIT","mcpName":"io.github.tekthar/mcp-jira-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"version":"0.47.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"c608f6ac-b1cb-445b-8704-ad143dc8ae13"}},"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/jira"},"_npmVersion":"11.21.1","description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","directories":{},"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2","@modelcontextprotocol/core":"2.4.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-jira-dc_0.47.1_1794004773290_0.11982427864665668"}}},"time":{"created":"2026-11-06T07:39:01.290Z","modified":"2026-11-06T22:39:33.751Z","0.0.0-stage":"2026-11-06T07:39:01.290Z","0.44.0":"2026-11-06T07:40:16.934Z","0.44.1":"2026-11-06T08:18:07.312Z","0.45.0":"2026-11-06T12:54:01.441Z","0.47.0":"2026-11-06T22:04:15.851Z","0.47.1":"2026-11-06T22:39:33.405Z"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"license":"MIT","homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","jira","jira-data-center","jira-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/jira"},"description":"MCP server for Jira Data Center and Jira Server: search, create, update and transition issues, with comments, links, versions, agile boards and sprints, worklogs and service desk. Not affiliated with Atlassian.","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"readme":"# mcp-jira-dc\n\n**Connect Claude, Cursor and any other MCP client to Jira Data Center and Jira Server, signed in as you.**\n\nThe server runs on your machine. Your MCP client starts it and talks to it over stdio; it calls Jira's REST API with\nyour personal access token, lists the everyday issue tools, and keeps 43 more one search away, plus the tools of\nsupported Jira apps such as Xray when they're installed. Jira's own permissions\ndecide what you can do: the server can hide tools, never unlock them.\n\n```bash\nnpx -y mcp-jira-dc setup                    # saves your Jira address and token\nclaude mcp add jira -- npx -y mcp-jira-dc   # connects Claude Code\n```\n\n> Not affiliated with or endorsed by Atlassian. Jira is a trademark of Atlassian.\n\n## Why run it on your machine?\n\n| | A hosted MCP connector | **mcp-jira-dc** |\n|---|---|---|\n| Works with Jira Data Center and Server | depends on the service | **yes** |\n| Reaches a Jira behind your firewall or VPN | only if Jira is exposed to the service | **yes**: wherever your machine can reach |\n| Where your token lives | with the service | **on your machine**: your OS keychain, or a file only your user can read |\n| Hides tools your account can't use | depends on the service | **yes**: reads your Jira permissions at startup |\n| Who decides which tools the agent sees | the service | **you**, with a few settings |\n| Something to host, approve or pay for | the service | **nothing**: `npx` runs it |\n\n[Atlassian's official MCP server](https://github.com/atlassian/atlassian-mcp-server) is a hosted server for Atlassian\nCloud.\n\n## Install\n\nYou need Node.js 22.22.2 or later, Jira Data Center or Jira Server, and a personal access token. To create one, open\nyour profile picture in Jira, then **Personal Access Tokens** > **Create token**.\n\n**1. Save your address and token.** `setup` asks for them, checks them with one request to Jira, and saves them:\n\n```bash\nnpx -y mcp-jira-dc setup\n```\n\nThe token goes to your OS keychain: the macOS Keychain, Windows Credential Manager, or on Linux the desktop\nkeyring (GNOME Keyring or KWallet). Everything else goes to `~/.atlassian-dc-mcp/jira.env`\n(`%USERPROFILE%\\.atlassian-dc-mcp\\jira.env` on Windows), which only your user can read. Without a keychain, such as\non a Linux server, the token goes in that file too.\n\n**2. Connect your client.** `install` registers the server with Claude Code or Claude Desktop for you:\n\n```bash\nnpx -y mcp-jira-dc install --claude-code      # runs claude mcp add\nnpx -y mcp-jira-dc install --claude-desktop   # edits Claude Desktop's config, after backing it up\n```\n\nCursor, VS Code and other clients with an `mcpServers` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": { \"command\": \"npx\", \"args\": [\"-y\", \"mcp-jira-dc\"] }\n  }\n}\n```\n\nTo skip `setup`, put the settings in that entry instead:\n`\"env\": { \"JIRA_HOST\": \"jira.example.com\", \"JIRA_API_TOKEN\": \"<personal access token>\" }`.\n\n## Commands\n\n| Command | Does |\n|---|---|\n| `npx -y mcp-jira-dc` | Serves Jira over stdio. This is what your MCP client runs. |\n| `npx -y mcp-jira-dc setup` | Asks for your address and token, checks them against Jira, and saves them. |\n| `setup --non-interactive --host <host> --token <token>` | The same from flags, for scripts and CI. Exits non-zero if the token doesn't work. Values you leave out come from your existing settings. |\n| `setup --help` | Lists every option. |\n| `npx -y mcp-jira-dc install --claude-code [--scope user\\|project\\|local]` | Registers the server with Claude Code by running `claude mcp add`. |\n| `npx -y mcp-jira-dc install --claude-desktop` | Adds the server to Claude Desktop's configuration, after backing it up. |\n| `npx -y mcp-jira-dc doctor` | Checks Node.js, where each setting comes from, the keychain, signing in, and the tools your client will see, and says how to fix what's wrong. The token is masked. |\n\n## What the agent sees\n\nThe tool list holds the everyday tools for issues, comments, transitions and attachments, plus four more:\n\n| Tool | What it's for |\n|---|---|\n| `jira_searchTools` | Finds any other tool by keyword, such as \"sprint issues\", and returns its description and input schema. Its own description names every toolset it can reach. |\n| `jira_runReadTool` | Runs a found tool that only reads Jira. |\n| `jira_runWriteTool` | Runs a found tool that changes Jira. Your client can ask you first, as for any write. |\n| `jira_runCode` | Runs a short JavaScript snippet that combines several read calls and returns only the answer. |\n\nFor a question that takes many calls, `jira_runCode` keeps the intermediate results out of the context:\n\n```js\nconst { issues } = await tools.jira_getSprintIssues({ sprintId: 42 });\nconst blocked = issues.filter((issue) => issue.status === 'Blocked');\nreturn blocked.map((issue) => `${issue.key} ${issue.summary}`);\n```\n\nThe snippet runs in QuickJS, a JavaScript engine compiled to WebAssembly, in its own worker thread. It sees only\n`tools`, `callTool` and `console`: no network, files, processes or timers. It can call read tools only, and stops after\n30 seconds or 50 tool calls (4 at a time), at 64 MB of memory, or with a result over 100,000 characters. If it crashes\nthe engine, only that run fails.\n\n## Toolsets\n\n**On** toolsets are listed directly. **Gateway** toolsets are reached through `jira_searchTools`. **Off** toolsets need\n`TOOLSETS`.\n\n| Toolset | Default | Tools |\n|---|---|---|\n| `jira_issues`: search, read, create and update issues | on | `jira_searchIssues`, `jira_getIssue`, `jira_createIssue`, `jira_updateIssue` |\n| `jira_comments`: read, add and edit issue comments | on | `jira_getIssueComments`, `jira_postIssueComment`, `jira_updateIssueComment` |\n| `jira_transitions`: list and run workflow transitions | on | `jira_getTransitions`, `jira_transitionIssue` |\n| `jira_attachments`: download and upload issue attachments | on | `jira_downloadAttachment`, `jira_uploadAttachment` (opt-in) |\n| `jira_links`: issue link types, link and unlink issues | gateway | `jira_getIssueLinkTypes`, `jira_linkIssues`, `jira_unlinkIssues` (destructive) |\n| `jira_watchers`: watch and unwatch issues as yourself | gateway | `jira_watchIssue`, `jira_unwatchIssue` |\n| `jira_versions`: project versions (releases) | gateway | `jira_getProjectVersions`, `jira_getVersion`, `jira_createVersion`, `jira_updateVersion`, `jira_deleteVersion` (destructive, opt-in) |\n| `jira_development`: branches, commits and pull requests linked to issues | gateway | `jira_getIssueDevelopmentInfo` |\n| `jira_issue_management`: list a project's issues, bulk-create, assign and delete issues | gateway | `jira_getProjectIssues`, `jira_batchCreateIssues`, `jira_assignIssue`, `jira_deleteIssue` (destructive) |\n| `jira_watcher_management`: list an issue's watchers and add or remove other users | gateway | `jira_getIssueWatchers`, `jira_addWatcher`, `jira_removeWatcher` |\n| `jira_users`: look up user profiles and assignable users | gateway | `jira_getUserProfile`, `jira_searchAssignableUsers` |\n| `jira_fields`: find fields, issue-type create schemas and allowed values | gateway | `jira_searchFields`, `jira_getFieldOptions`, `jira_getCreateFields`, `jira_getProjectIssueTypes`, `jira_getProjectFields` |\n| `jira_projects`: list and search projects, list components, create versions in bulk | gateway | `jira_getAllProjects`, `jira_searchProjects`, `jira_getProjectComponents`, `jira_batchCreateVersions` |\n| `jira_agile`: boards and sprints, their issues, sprint planning | gateway | `jira_getAgileBoards`, `jira_getBoardIssues`, `jira_getSprintsFromBoard`, `jira_getSprintIssues`, `jira_createSprint`, `jira_updateSprint`, `jira_addIssuesToSprint`, `jira_moveIssuesToBacklog` |\n| `jira_worklog`: read and log work time | gateway | `jira_getWorklog`, `jira_addWorklog` |\n| `jira_remote_links`: add web links to issues and move issues into epics | gateway | `jira_createRemoteIssueLink`, `jira_linkToEpic` |\n| `jira_analytics`: issue timelines, SLAs, epic hierarchy, cross-project links, development info in bulk | gateway | `jira_getIssueDates`, `jira_getIssueSla`, `jira_getProjectEpicHierarchy`, `jira_getCrossProjectDependencies`, `jira_getIssuesDevelopmentInfo` |\n| `jira_service_desk`: Jira Service Management desks, queues, request types and requests | off | `jira_getServiceDeskForProject`, `jira_getServiceDeskQueues`, `jira_getQueueIssues`, `jira_getRequestTypes`, `jira_getRequestTypeFields`, `jira_createCustomerRequest` |\n\nThe tool search never offers a destructive tool. To use one, turn on its toolset with `TOOLSETS`.\n\n## Jira apps\n\nThe server also works with Jira apps from the Atlassian Marketplace. Xray's tools are offered only when Xray is\ninstalled: at startup the server makes one request to check, and leaves Xray out if it isn't there. Its toolsets are\noff by default, so its tools are reached through `jira_searchTools` and cost nothing until used. Jira Service\nManagement's tools are the `jira_service_desk` toolset in [Toolsets](#toolsets), which you turn on with `TOOLSETS`.\n\n| App | Versions | Status |\n|---|---|---|\n| Xray, test management | 8 | Beta |\n| Jira Service Management | not recorded | Beta |\n\nBeta means built and checked, but not yet run against a live instance of the app. [Supported apps](https://github.com/tekthar/atlassian-data-center-mcp/blob/main/docs/supported-apps.md) lists the\nexact versions each app's tools were built from and how they were checked.\n\n**Xray** tools:\n\n| Toolset | Tools |\n|---|---|\n| `xray_tests`: tests, their steps and relations, test statuses | `xray_getTests`, `xray_getTestSteps`, `xray_getTestRelations`, `xray_getTestStatuses` |\n| `xray_test_executions`: a test execution's tests and runs | `xray_getTestExecutionTests`, `xray_addTestsToTestExecution` |\n| `xray_test_plans`: a test plan's tests and executions | `xray_getTestPlanTests`, `xray_getTestPlanExecutions`, `xray_addTestsToTestPlan`, `xray_addTestExecutionsToTestPlan` |\n| `xray_test_sets`: a test set's tests | `xray_getTestSetTests`, `xray_addTestsToTestSet` |\n| `xray_test_runs`: test results | `xray_getTestRun`, `xray_searchTestRuns`, `xray_updateTestRun` |\n\nWith `jira_runCode`, one question like *\"which tests failed in QA-20, and what defects did they raise?\"* becomes one\nscript: list the execution's tests, then read the failed runs. Adding tests needs Edit Issues on the execution, plan or\nset. Xray's own settings decide who may record test results. Removing tests isn't offered yet, because removing a test\nfrom an execution deletes its results.\n\n## Settings\n\nEvery setting is an environment variable. Each comes from the first of these that has it: the environment, the dotenv\nfile named by `ATLASSIAN_DC_MCP_CONFIG_FILE`, the file `setup` writes, then the OS\nkeychain.\n\n**Connecting**\n\n| Variable | Use |\n|---|---|\n| `JIRA_HOST` | Host name and optional port, without `https://`, e.g. `jira.example.com`. |\n| `JIRA_API_BASE_PATH` | Full REST base URL, used instead of `JIRA_HOST`, e.g. `https://example.com/jira/rest`. |\n| `JIRA_API_TOKEN` | Personal access token. |\n| `JIRA_DEFAULT_PAGE_SIZE` | Page size for list tools. Default 25. |\n| `ATLASSIAN_DC_MCP_CONFIG_FILE` | Absolute path to a dotenv file with any of these settings, e.g. one file shared by several servers. |\n| `ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS` | How long a request to Jira may take. Default 30000. |\n| `ATLASSIAN_DC_MCP_KEYCHAIN` | `off` keeps the token out of the OS keychain: `setup` saves it in the file instead, and the server doesn't look in the keychain. |\n\n**Choosing tools**\n\n| Variable | Use |\n|---|---|\n| `TOOLSETS` | Toolsets to list directly: names, `default`, or `all`, e.g. `default,jira_agile`. |\n| `READ_ONLY_MODE` | `true` offers only tools that never change Jira. |\n| `ENABLED_TOOLS` | An exact list of tool names. Replaces `TOOLSETS`, and turns the tool search and `jira_runCode` off. |\n| `TOOL_GATEWAY` | `off` turns the tool search off: tools outside the selected toolsets are left out. |\n| `CODE_EXECUTION` | `off` removes `jira_runCode`. |\n| `PERMISSION_FILTER` | `off` lists tools without asking Jira for your permissions first. |\n| `JIRA_PERMISSION_PROJECTS` | Project keys, e.g. `ACS,BPO`. Without it, a permission you hold in any project counts; with it, only these projects count. |\n| `JIRA_APPS` | Which [Jira apps](#jira-apps) to offer. Unset or `auto` checks which are installed; a list such as `xray` offers those without checking; `off` offers none. |\n\n**Turning on risky tools**\n\n| Variable | Use |\n|---|---|\n| `JIRA_VERSION_DELETE_ENABLED` | `true` lists `jira_deleteVersion`. |\n| `JIRA_ATTACHMENTS_UPLOAD_ENABLED`, `JIRA_ATTACHMENTS_DOWNLOAD_ENABLED` | `true` lets attachments be uploaded from, or saved to, your disk. Default off: downloads come back inline and never touch the disk. |\n| `JIRA_ATTACHMENTS_UPLOAD_ROOTS`, `JIRA_ATTACHMENTS_DOWNLOAD_ROOTS` | Folders allowed for each direction, separated like your OS `PATH`. |\n| `JIRA_ATTACHMENTS_DIR` | One folder used for both directions. |\n| `JIRA_ATTACHMENTS_MAX_UPLOAD_BYTES`, `JIRA_ATTACHMENTS_MAX_DOWNLOAD_BYTES` | Size limits. Default 25 MiB. |\n\n**Audit log**\n\n| Variable | Use |\n|---|---|\n| `ATLASSIAN_DC_MCP_AUDIT` | `1` writes one JSON line per tool call: the time, server, tool, outcome and duration, never the arguments or results. A tool run through the tool search or from `jira_runCode` is recorded too, with `\"via\"`. |\n| `ATLASSIAN_DC_MCP_AUDIT_FILE` | Where to write it. Default `~/.atlassian-dc-mcp/audit/mcp-jira-dc.jsonl` (mode 0600 on macOS and Linux). It rotates at 5 MB, keeping three old files. |\n\n## What it guarantees\n\n- **It never widens access.** Every request carries your token, so Jira decides what you can do. Hiding a tool trims\n  what the agent sees; it never unlocks anything.\n- **Writes stay visible.** Every tool tells your client whether it reads, changes or deletes, so the client can ask you\n  first. `jira_runCode` can only call read tools.\n- **Deleting is always your decision.** Delete tools appear only in toolsets you turn on, never through the tool search\n  or `jira_runCode`, and `jira_deleteVersion` also needs its own setting.\n- **It never retries a call on its own.** If a request fails, the agent sees Jira's error and decides what to do.\n- **It stays out of your files.** Attachments are read from and saved to only the folders you name, and a saved file\n  never overwrites an existing one.\n\nIssue text, comments and attachments are written by other people, so treat them as data, not instructions.\n`jira_downloadAttachment` shows an image to the model only when asked to, with `returnContent: 'image'`.\n\n## Related projects\n\n- [mcp-confluence-dc](https://www.npmjs.com/package/mcp-confluence-dc) and\n  [mcp-bitbucket-dc](https://www.npmjs.com/package/mcp-bitbucket-dc): the same approach for Confluence and Bitbucket\n  Data Center.\n- [sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian): a Python server for Jira and Confluence, Cloud\n  and Data Center.\n- [jira-dc-mcp](https://www.npmjs.com/package/jira-dc-mcp): another Jira Data Center server, with semantic search.\n\n## Acknowledgments\n\nmcp-jira-dc builds on two MIT-licensed projects: [b1ff/atlassian-dc-mcp](https://github.com/b1ff/atlassian-dc-mcp), and\n[sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian), whose Data Center tools were adapted for this\nserver. Their copyright notices are in [LICENSE](LICENSE).\n\n## License\n\nMIT. Part of [Atlassian Data Center MCP](https://github.com/tekthar/atlassian-data-center-mcp), with\n[mcp-confluence-dc](https://www.npmjs.com/package/mcp-confluence-dc) and\n[mcp-bitbucket-dc](https://www.npmjs.com/package/mcp-bitbucket-dc).\n","readmeFilename":"README.md"}