{"_id":"@nexus2520/jira-mcp-server","_rev":"11-223a384351931db623f627d6459a5b08","name":"@nexus2520/jira-mcp-server","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@nexus2520/jira-mcp-server","version":"1.0.0","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.0.0","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"25ccff305f1397f9416df40e5a4ac3c04639d361","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.0.0.tgz","fileCount":46,"integrity":"sha512-F94U0i5AF5gX4TpBL1UOGLBAv8PC1A/BMpMaZZJFAmNuv8Sjn4y7X/Scbn6bSERdzpFTObTZuWqon0dE9FYl5A==","signatures":[{"sig":"MEQCIDlmdixnBDcYcucW4L/5VG99D3RFTobgWwPnjKbUesPqAiB1m8qd0UbLruzkikMIZJhTlV4VNjRcdTMaiu/5WsRJNw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":120585},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"74844c92e380e1b6b8701eb40b95535bcd46fb3e","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.0_1761318610853_0.07531250132038858","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@nexus2520/jira-mcp-server","version":"1.0.1","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.0.1","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"84a4b01ec63de61f622db16de55a675ec6a37034","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.0.1.tgz","fileCount":46,"integrity":"sha512-TgC2NXctNKXO8pjwgxFxaHmOQ5pWzQBUolyy/cqXPFdfe5l/MLjHjIyGHxVkZRpYd7OsvPdvKhXCrAwnNQ1GnQ==","signatures":[{"sig":"MEYCIQDjyp3U0SiKFQoD53dOrhqkw1poCm3il9L6/ByVuuOwjAIhANyU2jHZYoKvG8n8An8vedG6REW6jmITxD+EFii9lZ3V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119088},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"c523d77db120f1409111062450221ab49591dbb5","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.1_1761319066191_0.3609674402632874","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@nexus2520/jira-mcp-server","version":"1.0.3","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.0.3","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"c8ac5e8f4cdf89c1d11d1c2194e943ba396d7157","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.0.3.tgz","fileCount":50,"integrity":"sha512-PqeweTgafx3qUzYVG3ZJbGDCL2M/yDUTwZQAi2xa0AsHVh7XMGBcqFzHSroThOmX+xK7FRsw3chPQEM4iNL8JQ==","signatures":[{"sig":"MEQCIDjipjRLpvmiBwxzoAZz1aOciTybd74YFd6YmA5Fq6UJAiBx80FFgqE1k2SaaEfKFrmpjUDhwBQw/ExmxByymOYP6w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148321},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"d0466020bb7a2c56b4e6d580269c472d0f5aa76d","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.3_1772468841392_0.3022443579394847","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@nexus2520/jira-mcp-server","version":"1.1.0","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.1.0","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"d29b1e3e3f42849e35fb2402b534be2ec456d147","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.1.0.tgz","fileCount":50,"integrity":"sha512-EKvwsG/gERschuvmI/j89bcJBwkOJcII2K39z1gzoRoxcprDG5QbLCT6nMZjDBK9UzW1Ubl+rHjdjM8O8Mem2Q==","signatures":[{"sig":"MEQCIAYayjoSgTcDUM/MaesINvFQ+vHsbbl04g5REI2er5EzAiACsH8GuFN1cFjSZ26859855eLIoqukqAZ2ybMyCWo+wQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":134426},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"d0466020bb7a2c56b4e6d580269c472d0f5aa76d","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.1.0_1772872402980_0.47640954520514067","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@nexus2520/jira-mcp-server","version":"1.1.1","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.1.1","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"fdfbd490420f3bd700aced8433913c8000a5f5f2","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.1.1.tgz","fileCount":50,"integrity":"sha512-i/q79iTt9ys2Qb3KMFWEsoFwyDv0/jekm43c4gHXmCm+nrItXIOmpL13zD5QoynbckXm2BbvCZWYGCu7WUxqUA==","signatures":[{"sig":"MEQCICLvfglbhAMoy/Ept3qgv5ta5bVcKj2to0gNE41WGfPOAiAQb90cYjUtH3XWffI9GydAwEdFVUpFqvWA4tTmNeg02w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":134426},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"0383b5a8ec090431091fefb1f227454e7982164e","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.1.1_1772872681321_0.9570983643739024","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@nexus2520/jira-mcp-server","version":"1.1.2","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.1.2","maintainers":[{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"0f36204182db3f6af99a7b091e0a4b8b4b80f495","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.1.2.tgz","fileCount":50,"integrity":"sha512-WIaWVd+fF0v0z4XHu2Z5hRAdSrTx1iCFz+6DL5M4OSJX2k0QmyECQ2+YjXfS0X9RV3x/4V7qD4gzHCRNngo8Gw==","signatures":[{"sig":"MEYCIQCjumgF8D3+e6EgZhjM76VD+tvdV7LRwEFcBznzKSaqZQIhALj+UCbD3ni5me6/rb9JkhHMyW8pgAL6YB84ZX60UsM5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141344},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"3bcb47caa5221009a22f2b6a7dea38ce085f0fdc","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.1.2_1774504527062_0.9954684935766493","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@nexus2520/jira-mcp-server","version":"1.2.0","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"author":{"name":"Parth Dogra"},"license":"MIT","_id":"@nexus2520/jira-mcp-server@1.2.0","maintainers":[{"name":"roshan84ya","email":"roshan84ya@gmail.com"},{"name":"pdogra","email":"parthdogra25@gmail.com"},{"name":"pratiknarola","email":"narolapratik11@gmail.com"}],"homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"build/index.js"},"dist":{"shasum":"5e9b27ceb34cd6f89f750b62329838bd8ddbfcbb","tarball":"https://registry.npmjs.org/@nexus2520/jira-mcp-server/-/jira-mcp-server-1.2.0.tgz","fileCount":54,"integrity":"sha512-Hd9z6cExg7VBPkuHS/uVTUJ3b6hibkCXIV0I0mbJrL4g4gETRDkR3uiAtrloeHtU0D+33Scgy+FiDS2aW+3Zfg==","signatures":[{"sig":"MEQCIC21t2+8l8cwpkPINFyAO9jsQvdtgcMy2i3nVsfDAUtBAiBCt9YKnei9zj7y6Qr2alr50hFyGMsHmogIQbY8xztqFg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":165516},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"5e4dd36604db3ad2435682f66f8576dcb3baed56","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","test:watch":"vitest","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"pdogra","email":"parthdogra25@gmail.com"},"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Jira API integration - supports Jira Cloud","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.10.0","form-data":"^4.0.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.0.0","devDependencies":{"vitest":"^4.1.6","typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.2.0_1779203117085_0.24386387848264635","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-10-24T15:10:10.411Z","modified":"2026-09-26T12:12:08.441Z","1.0.0":"2025-10-24T15:10:11.085Z","1.0.1":"2025-10-24T15:17:46.387Z","1.0.3":"2026-03-02T16:27:21.549Z","1.1.0":"2026-03-07T08:33:23.274Z","1.1.1":"2026-03-07T08:38:01.479Z","1.1.2":"2026-03-26T05:55:27.194Z","1.2.0":"2026-05-19T15:05:17.244Z"},"bugs":{"url":"https://github.com/pdogra1299/jira-mcp-server/issues"},"author":{"name":"Parth Dogra"},"license":"MIT","homepage":"https://github.com/pdogra1299/jira-mcp-server#readme","keywords":["mcp","jira","api","model-context-protocol","jira-cloud","issue-tracking","atlassian"],"repository":{"url":"git+https://github.com/pdogra1299/jira-mcp-server.git","type":"git"},"description":"MCP server for Jira API integration - supports Jira Cloud","maintainers":[{"email":"nandinijairath@gmail.com","name":"nandinijairath"},{"email":"parthdogra25@gmail.com","name":"pdogra"}],"readme":"# Jira MCP Server\n\n[![npm version](https://badge.fury.io/js/@nexus2520%2Fjira-mcp-server.svg)](https://www.npmjs.com/package/@nexus2520/jira-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server for Jira API integration. This server enables AI assistants like Claude to interact with Jira Cloud instances for issue management, search, comments, workflow transitions, and attachment handling.\n\n## Features\n\n- **Issue Management**: Get, create, update, and assign Jira issues with custom field support\n- **JQL Search**: Search issues using Jira Query Language\n- **Comments**: Add and retrieve comments on issues\n- **Workflow**: Get available transitions and change issue status\n- **Metadata Discovery**: Get field requirements and allowed values for projects\n- **User Search**: Find users by email or name for assignments\n- **Projects**: List all accessible projects\n- **Attachments**: List, upload, delete attachments and retrieve their content — text files returned as text, images rendered inline via Claude vision\n- **Issue Links**: Add, remove, and list relationships between issues (relates, blocks, duplicates) without touching the constrained `parent` hierarchy field\n- **Token Efficient**: 6 compound tools instead of 17+ flat tools — ~50% fewer tokens per session\n\n## Installation\n\n### Using npm (Recommended)\n\n```bash\nnpm install -g @nexus2520/jira-mcp-server\n```\n\n### From Source\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/pdogra1299/jira-mcp-server.git\n   cd jira-mcp-server\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   pnpm install\n   ```\n\n3. **Build the project**:\n   ```bash\n   pnpm run build\n   ```\n\n### Prerequisites\n\n- Node.js >= 16.0.0\n- A Jira Cloud account with API access\n- Jira API token (generate from [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens))\n\n## Configuration\n\n### Environment Variables\n\n- `JIRA_EMAIL`: Your Atlassian account email\n- `JIRA_API_TOKEN`: Your Jira API token\n- `JIRA_BASE_URL`: Your Jira instance URL (e.g., `https://yourcompany.atlassian.net`)\n\n### Claude Desktop Configuration\n\nAdd the following to your Claude Desktop MCP settings file:\n\n**Location**:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\n**Configuration (if installed via npm)**:\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@nexus2520/jira-mcp-server\"\n      ],\n      \"env\": {\n        \"JIRA_EMAIL\": \"your-email@company.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token-here\",\n        \"JIRA_BASE_URL\": \"https://yourcompany.atlassian.net\"\n      }\n    }\n  }\n}\n```\n\n**Configuration (if built from source)**:\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/jira-mcp-server/build/index.js\"\n      ],\n      \"env\": {\n        \"JIRA_EMAIL\": \"your-email@company.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token-here\",\n        \"JIRA_BASE_URL\": \"https://yourcompany.atlassian.net\"\n      }\n    }\n  }\n}\n```\n\n### Getting Your Jira API Token\n\n1. Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click \"Create API token\"\n3. Give it a label (e.g., \"Claude MCP\")\n4. Copy the generated token\n5. Use it in your configuration\n\n## Tool Architecture\n\nThis server exposes **6 compound tools** — each with an `action` parameter that selects the operation. This design reduces the token overhead of tool definitions by ~50% compared to 17+ flat tools, leaving more context for actual work.\n\n| Tool | Actions | Description |\n|------|---------|-------------|\n| `jira_issues` | `get` `create` `update` `assign` | Full issue lifecycle management |\n| `jira_search` | `issues` `projects` `users` `create_metadata` | Search and discovery |\n| `jira_comments` | `get` `add` | Read and write comments |\n| `jira_workflow` | `get_transitions` `transition` | Status transitions |\n| `jira_attachments` | `list` `get_content` `upload` `delete` | File attachments |\n| `jira_links` | `list` `add` `remove` `get_link_types` | Issue link relationships |\n\n---\n\n## Available Tools\n\n### `jira_issues`\n\nManage the full lifecycle of Jira issues.\n\n**Required**: `action`\n\n| Action | Description | Required params | Optional params |\n|--------|-------------|-----------------|-----------------|\n| `get` | Fetch full issue details | `issueKey` | — |\n| `create` | Create a new issue | `projectKey`, `summary`, `issueType` | `description`, `priority`, `assignee`, `labels`, `customFields` |\n| `update` | Edit fields on an existing issue | `issueKey` | `summary`, `description`, `priority`, `assignee`, `labels`, `customFields` |\n| `assign` | Set or clear the assignee | `issueKey`, `assignee` | — |\n\n**Tips**:\n- Always call `jira_search` with `action=create_metadata` before creating issues to discover required custom fields and allowed values.\n- Pass `assignee: \"-1\"` to unassign an issue.\n- `description` accepts plain text or an [Atlassian Document Format (ADF)](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/) object.\n- `customFields` is a key-value map: `{\"customfield_10000\": \"value\"}`.\n\n**Examples**:\n```\nGet details for PROJ-123\nCreate a Bug in project PROJ with summary \"Login button broken\"\nUpdate PROJ-123 priority to High\nAssign PROJ-123 to john.doe@company.com\n```\n\n---\n\n### `jira_search`\n\nSearch and discover Jira resources.\n\n**Required**: `action`\n\n| Action | Description | Required params | Optional params |\n|--------|-------------|-----------------|-----------------|\n| `issues` | Search issues via JQL | `jql` | `maxResults`, `fields` |\n| `projects` | List all accessible projects | — | `maxResults` |\n| `users` | Find users by name or email | `query` | `maxResults` |\n| `create_metadata` | Get field requirements for creating issues | `projectKey` | `issueType` |\n\n**Common JQL examples**:\n```\nproject = PROJ AND status = Open\nassignee = currentUser() AND status != Done\npriority = High AND created >= -7d\n```\n\n**Tips**:\n- Use `create_metadata` before `jira_issues` `create` to understand what fields are required for a project/issue type.\n- Use `users` to look up account IDs for assignments — pass the returned account ID or email to `jira_issues` `assign`.\n- `fields` (for `issues`) controls which JIRA fields are fetched per result — e.g. `[\"summary\",\"status\",\"priority\",\"duedate\",\"assignee\"]`. Defaults to `[\"summary\"]`.\n\n**Structured output**: the `issues` action and `jira_issues` `get` return a `structuredContent` JSON payload alongside the markdown, so programmatic consumers can read fields directly without parsing markdown. For `issues` it is `{ jql, count, isLast, nextPageToken, issues: [{ key, id, self, fields }] }`.\n\n---\n\n### `jira_comments`\n\nRead and write comments on a Jira issue.\n\n**Required**: `action`, `issueKey`\n\n| Action | Description | Required params |\n|--------|-------------|-----------------|\n| `get` | Fetch all comments on an issue | — |\n| `add` | Post a new comment | `comment` |\n\n`comment` accepts plain text or an ADF object.\n\n**Examples**:\n```\nGet all comments on PROJ-123\nAdd a comment to PROJ-123: \"Fixed in PR #456\"\n```\n\n---\n\n### `jira_workflow`\n\nManage issue status transitions.\n\n**Required**: `action`, `issueKey`\n\n| Action | Description | Required params | Optional params |\n|--------|-------------|-----------------|-----------------|\n| `get_transitions` | List available status transitions | — | — |\n| `transition` | Move issue to a new status | `transitionId` | `comment` |\n\n**Tip**: Always call `get_transitions` first — transition IDs vary per project and issue type. The `transitionId` from the response is what you pass to `transition`.\n\n**Examples**:\n```\nGet available transitions for PROJ-123\nMove PROJ-123 to \"In Progress\" (use get_transitions first to find the ID)\n```\n\n---\n\n### `jira_attachments`\n\nManage file attachments on Jira issues.\n\n**Required**: `action`\n\n| Action | Description | Required params | Optional params |\n|--------|-------------|-----------------|-----------------|\n| `list` | List all attachments with metadata | `issueKey` | — |\n| `get_content` | Download and return file content | `attachmentId` | `mimeType` |\n| `upload` | Attach a local file to an issue | `issueKey`, `filePath` | `fileName` |\n| `delete` | Remove an attachment by ID | `attachmentId` | — |\n\n**Content types returned by `get_content`**:\n- **Text files** (`text/*`, `application/json`, `application/xml`): returned as readable text\n- **Images** (`image/*`): returned as base64 — Claude will render them inline\n- **Other types** (PDF, zip, etc.): returns file metadata with a descriptive message\n\n**Tips**:\n- Use `list` first to get attachment IDs before calling `get_content` or `delete`.\n- `fileName` in `upload` overrides the filename shown in Jira (defaults to the file's basename).\n\n**Examples**:\n```\nList attachments on PROJ-123\nGet the content of attachment 136904\nUpload /tmp/report.pdf to PROJ-123\nDelete attachment 136904\n```\n\n---\n\n### `jira_links`\n\nManage relationships between issues independently of Jira's project hierarchy config — useful when you need to associate a Bug with a Story but the project doesn't allow Bug → Story as a parent-child relationship.\n\n**Required**: `action`\n\n| Action | Description | Required params | Optional params |\n|--------|-------------|-----------------|-----------------|\n| `get_link_types` | List available link type names for this Jira instance | — | — |\n| `add` | Create a link between two issues | `issueKey`, `linkedIssueKey`, `linkType` | `direction` |\n| `list` | List all links on an issue, with link IDs | `issueKey` | — |\n| `remove` | Delete a link by ID | `linkId` | — |\n\n**Link direction**:\n- Symmetric types (`Relates`, `Duplicate`): `direction` doesn't matter.\n- Directional types (`Blocks`, `Cloners`, `Causes`): `direction: outward` means `issueKey` is the outward side (e.g. `issueKey` *blocks* `linkedIssueKey`); `direction: inward` means `issueKey` is the inward side (e.g. `issueKey` *is blocked by* `linkedIssueKey`). Defaults to `outward`.\n\n**Tips**:\n- Run `get_link_types` first — link type names vary per Jira instance config.\n- Use `list` to find a `linkId` before calling `remove`.\n\n**Examples**:\n```\nList the link types available in Jira\nLink PROJ-1 to PROJ-2 as Relates\nMark PROJ-1 as blocking PROJ-2\nList all links on PROJ-1\nRemove link 10042\n```\n\n---\n\n## API Reference\n\nThis server uses the [Jira REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/).\n\n## Troubleshooting\n\n### \"Error: JIRA_EMAIL and JIRA_API_TOKEN are required\"\n\nMake sure you've set the environment variables in your MCP configuration.\n\n### Authentication errors\n\n- Verify your API token is correct\n- Ensure your email matches your Atlassian account\n- Check that your `JIRA_BASE_URL` doesn't have a trailing slash\n\n### Permission errors\n\nThe API token uses the permissions of the user who created it. Make sure your account has the necessary permissions for the actions you're trying to perform.\n\n## License\n\nMIT\n\n## Author\n\nParth Dogra\n\n## Contributing\n\nFeel free to open issues or submit pull requests for improvements!\n","readmeFilename":"README.md"}