{"_id":"mcp-server-jira-cloud","_rev":"3-fa34cd7fe2763a13f82726ab45122c5c","name":"mcp-server-jira-cloud","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"mcp-server-jira-cloud","version":"1.0.0","keywords":["mcp","jira","jira-cloud","model-context-protocol","issue-tracking","atlassian"],"author":{"name":"Micah Wood"},"license":"MIT","_id":"mcp-server-jira-cloud@1.0.0","maintainers":[{"name":"wpscholar","email":"micah@wpscholar.com"}],"homepage":"https://github.com/wpscholar/mcp-server-jira-cloud#readme","bugs":{"url":"https://github.com/wpscholar/mcp-server-jira-cloud/issues"},"bin":{"mcp-server-jira-cloud":"build/index.js"},"dist":{"shasum":"e9bf27a78a0634a9b081e01ee221fbb7e791c63b","tarball":"https://registry.npmjs.org/mcp-server-jira-cloud/-/mcp-server-jira-cloud-1.0.0.tgz","fileCount":14,"integrity":"sha512-P3Ddu1nE4u+zmSMXOCTLmmhyMKamSS9afVA9TuEDdPdWkjMxszXHWElaDSybI4BaB1QTKKQ8q/ckKZP/ug7aOg==","signatures":[{"sig":"MEQCIB6d4RIqlSlndreYBz0naSJ/I8DaM8803CKScnJGIhovAiASVIS7Q8s1gdVlPf+ywrPXXrmKSXelQTYX6LV6FAPv+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":86291},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7bb2dfc48e71096d99766159b128310bce02dc0f","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod +x build/index.js","start":"node build/index.js","prepare":"npm run build"},"_npmUser":{"name":"wpscholar","email":"micah@wpscholar.com"},"repository":{"url":"git+https://github.com/wpscholar/mcp-server-jira-cloud.git","type":"git"},"_npmVersion":"11.4.1","description":"MCP server for JIRA Cloud integration with comprehensive issue management, status tracking, and analytics","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-jira-cloud_1.0.0_1764449066850_0.7453884996799625","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"mcp-server-jira-cloud","version":"1.1.0","keywords":["mcp","jira","jira-cloud","model-context-protocol","issue-tracking","atlassian"],"author":{"name":"Micah Wood"},"license":"MIT","_id":"mcp-server-jira-cloud@1.1.0","maintainers":[{"name":"wpscholar","email":"micah@wpscholar.com"}],"homepage":"https://github.com/wpscholar/mcp-server-jira-cloud#readme","bugs":{"url":"https://github.com/wpscholar/mcp-server-jira-cloud/issues"},"bin":{"mcp-server-jira-cloud":"build/index.js"},"dist":{"shasum":"a04a2bcf43f612fb79eff721f8ee9d7908b23afa","tarball":"https://registry.npmjs.org/mcp-server-jira-cloud/-/mcp-server-jira-cloud-1.1.0.tgz","fileCount":15,"integrity":"sha512-OQxmcZbfiBTlAjljaCkbx1ptpKCiizpol5HgS1BqFymVDeapSVC/lqR/AEVNLGAJWSsxTXdbRvdauXhuljNpZw==","signatures":[{"sig":"MEQCIFEbbDgLa7nqyidci9242gGhQknlRIoQmToC4wrgyOEuAiBw2+n+DqmfHnfvlWcd1+t/g3X404kqakr9UeojoeSARA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122580},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"bbcfd2d5e87fc3d6a9b1b79ad48f6fafe007cbf4","scripts":{"dev":"tsx src/index.ts","build":"tsc && chmod +x build/index.js","start":"node build/index.js","prepare":"npm run build"},"_npmUser":{"name":"wpscholar","email":"micah@wpscholar.com"},"repository":{"url":"git+https://github.com/wpscholar/mcp-server-jira-cloud.git","type":"git"},"_npmVersion":"11.4.1","description":"MCP server for JIRA Cloud integration with comprehensive issue management, status tracking, and analytics","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-jira-cloud_1.1.0_1764721252085_0.5106935735540148","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"mcp-server-jira-cloud","version":"1.1.1","description":"MCP server for JIRA Cloud integration with comprehensive issue management, status tracking, and analytics","type":"module","main":"build/index.js","bin":{"mcp-server-jira-cloud":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build","start":"node build/index.js","dev":"tsx src/index.ts"},"repository":{"type":"git","url":"git+https://github.com/wpscholar/mcp-server-jira-cloud.git"},"bugs":{"url":"https://github.com/wpscholar/mcp-server-jira-cloud/issues"},"homepage":"https://github.com/wpscholar/mcp-server-jira-cloud#readme","keywords":["mcp","jira","jira-cloud","model-context-protocol","issue-tracking","atlassian"],"author":{"name":"Micah Wood"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","dotenv":"^16.3.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"_id":"mcp-server-jira-cloud@1.1.1","gitHead":"19133039dd446a9ff210441a7bbecefab9014237","types":"./build/index.d.ts","_nodeVersion":"25.1.0","_npmVersion":"11.4.1","dist":{"integrity":"sha512-2jQ5y0RizdVGlrkh2TO9p/Evu5ARfDMhd9+XI9QH03dHjTl4ti6JyeuSgkb4fSDALmiHcJeZ5ln2LUrmaWIRmg==","shasum":"55a42abf43b79efa0c0e5338f20e2201331f94d3","tarball":"https://registry.npmjs.org/mcp-server-jira-cloud/-/mcp-server-jira-cloud-1.1.1.tgz","fileCount":15,"unpackedSize":122601,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBniGpKjBIScjF4rX70BbFYs3QMFZy5daBOPHPj2FijSAiASMl8gXy81KcJc+SWLuXWkbnc08vfxml0A9M7QTtvMaQ=="}]},"_npmUser":{"name":"wpscholar","email":"micah@wpscholar.com"},"directories":{},"maintainers":[{"name":"wpscholar","email":"micah@wpscholar.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-jira-cloud_1.1.1_1767900084556_0.14261478024188712"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-29T20:44:26.848Z","modified":"2026-01-08T19:21:25.229Z","1.0.0":"2025-11-29T20:44:27.115Z","1.1.0":"2025-12-03T00:20:52.281Z","1.1.1":"2026-01-08T19:21:24.704Z"},"bugs":{"url":"https://github.com/wpscholar/mcp-server-jira-cloud/issues"},"author":{"name":"Micah Wood"},"license":"MIT","homepage":"https://github.com/wpscholar/mcp-server-jira-cloud#readme","keywords":["mcp","jira","jira-cloud","model-context-protocol","issue-tracking","atlassian"],"repository":{"type":"git","url":"git+https://github.com/wpscholar/mcp-server-jira-cloud.git"},"description":"MCP server for JIRA Cloud integration with comprehensive issue management, status tracking, and analytics","maintainers":[{"name":"wpscholar","email":"micah@wpscholar.com"}],"readme":"# JIRA Cloud MCP Server\n\nA Model Context Protocol (MCP) server for seamless integration with JIRA Cloud. This server enables AI assistants like Claude to interact with JIRA Cloud, providing comprehensive issue management, status tracking, and analytics capabilities.\n\n## Table of Contents\n\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Configuration](#configuration)\n  - [Getting Your JIRA API Token](#getting-your-jira-api-token)\n- [Usage with Claude Desktop](#usage-with-claude-desktop)\n- [Available Tools](#available-tools)\n  - [jira_search_issues](#1-jira_search_issues)\n  - [jira_get_issue](#2-jira_get_issue)\n  - [jira_create_issue](#3-jira_create_issue)\n  - [jira_update_issue](#4-jira_update_issue)\n  - [jira_get_transitions](#5-jira_get_transitions)\n  - [jira_transition_issue](#6-jira_transition_issue)\n  - [jira_get_changelog](#7-jira_get_changelog)\n  - [jira_list_projects](#8-jira_list_projects)\n  - [jira_get_project](#9-jira_get_project)\n  - [jira_add_comment](#10-jira_add_comment)\n  - [jira_get_comments](#11-jira_get_comments)\n  - [jira_update_comment](#12-jira_update_comment)\n  - [jira_delete_comment](#13-jira_delete_comment)\n  - [jira_get_issue_link_types](#14-jira_get_issue_link_types)\n  - [jira_get_field_options](#15-jira_get_field_options)\n  - [jira_delete_issue](#16-jira_delete_issue)\n  - [jira_search_users](#17-jira_search_users)\n- [JQL Query Examples](#jql-query-examples)\n- [Troubleshooting](#troubleshooting)\n  - [Authentication Failed](#authentication-failed)\n  - [Permission Denied](#permission-denied)\n  - [Rate Limiting](#rate-limiting)\n  - [Issue Not Found](#issue-not-found)\n  - [Invalid JQL](#invalid-jql)\n- [Security Notes](#security-notes)\n- [JIRA Cloud vs JIRA Server/Data Center](#jira-cloud-vs-jira-serverdata-center)\n- [Resources](#resources)\n\n## Features\n\n- **Issue Management**: Search, create, read, and update JIRA issues\n- **Status Management**: View available transitions and update issue status\n- **History Tracking**: Access complete status history with time-in-status analytics\n- **Project Operations**: List projects and get issue types\n- **Comments**: Add and retrieve comments from issues with pagination\n- **Labels**: Apply labels when creating issues\n- **JQL Support**: Full JIRA Query Language support for advanced searching\n- **API Token Authentication**: Secure authentication using JIRA Cloud API tokens\n\n## Prerequisites\n\n- **Node.js 18 or higher** - Required to run the MCP server\n- **JIRA Cloud account** with appropriate permissions\n- **JIRA Cloud API token** (see Configuration section below)\n\n## Configuration\n\n### Getting Your JIRA API Token\n\n1. Log in to your Atlassian account at https://id.atlassian.com\n2. Go to **Security** → **API tokens**\n3. Click **Create API token**\n4. Give it a descriptive name (e.g., \"MCP Server\")\n5. Copy the generated token immediately (you won't be able to see it again)\n\n## Usage with Claude Desktop\n\nEdit your Claude Desktop configuration file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira-cloud\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-server-jira-cloud\"],\n      \"env\": {\n        \"JIRA_BASE_URL\": \"https://yourcompany.atlassian.net\",\n        \"JIRA_EMAIL\": \"your.email@example.com\",\n        \"JIRA_API_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\nReplace the environment variables with your actual JIRA Cloud URL, email, and API token.\n\n### Restart Claude Desktop\n\nAfter saving the configuration, restart Claude Desktop for the changes to take effect.\n\n## Available Tools\n\n### 1. jira_search_issues\n\nSearch for JIRA issues using JQL (JIRA Query Language).\n\n**Parameters:**\n- `jql` (required): JQL query string\n- `maxResults` (optional): Maximum results to return (default: 50, max: 5000, recommended: 50-100)\n- `nextPageToken` (optional): Token for pagination (obtained from previous search response)\n- `fields` (optional): Specific fields to return\n\n**Pagination:**\nThis tool uses JIRA's new token-based pagination. The response includes:\n- `issues`: Array of matching issues\n- `nextPageToken`: Token to fetch the next page (if more results exist)\n- `isLast`: Boolean indicating if this is the last page\n\nTo paginate through results, use the `nextPageToken` from the previous response in your next search request.\n\n**Example queries to ask Claude:**\n- \"Search for all open bugs in project ABC\"\n- \"Find all issues assigned to me that are in progress\"\n- \"Show me high priority tasks created in the last week\"\n- \"Get the next page of results using this token: xyz123\"\n\n### 2. jira_get_issue\n\nGet detailed information about a specific JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key (e.g., PROJ-123)\n- `expand` (optional): Additional data to expand (e.g., changelog, transitions)\n- `fields` (optional): Specific fields to return (reduces response size and context usage)\n\n**Default Behavior (Optimized):**\n\nWhen the `fields` parameter is **omitted**, this tool returns a curated set of commonly needed fields:\n- `summary`\n- `issuetype`\n- `status`\n- `priority`\n- `labels`\n- `description`\n- `assignee`\n- `reporter`\n- `created`\n- `updated`\n- `resolution`\n- `issuelinks`\n- `timeestimate`\n- `timeremaining`\n- `duedate`\n- `components`\n- `fixVersions`\n\nThis default set excludes large fields like comments, attachments, and worklogs to optimize context usage.\n\n**Custom Field Selection:**\n\nUse the `fields` parameter to customize what data is returned:\n\n**Field patterns:**\n- Specific fields: `[\"summary\", \"status\", \"priority\"]`\n- All except comments: `[\"*all\", \"-comment\"]`\n- Navigable fields only: `[\"*navigable\"]`\n- All fields: `[\"*all\"]`\n\n**Example queries:**\n- \"Get details for issue PROJ-123\" (returns optimized default fields)\n- \"Get PROJ-123 with summary, status, and priority fields\" (specify a minimal field list)\n- \"Show me all fields for ABC-456 including comments\" (use `[\"*all\"]`)\n\n### 3. jira_create_issue\n\nCreate a new JIRA issue with labels and custom fields.\n\n**Parameters:**\n- `projectKey` (required): Project key\n- `issueType` (required): Issue type (e.g., Bug, Story, Task)\n- `summary` (required): Issue summary/title\n- `description` (optional): Issue description\n- `labels` (optional): Array of labels\n- `assignee` (optional): Assignee account ID\n- `priority` (optional): Priority name (e.g., High, Medium, Low)\n- `customFields` (optional): Custom fields as key-value pairs\n\n**Example queries:**\n- \"Create a new bug in project ABC with title 'Login page crashes' and label 'frontend'\"\n- \"Create a high priority task in PROJ: 'Update documentation' assigned to John\"\n\n### 4. jira_update_issue\n\nUpdate an existing JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key to update\n- `summary` (optional): New summary\n- `description` (optional): New description\n- `labels` (optional): Labels (replaces existing)\n- `assignee` (optional): Assignee account ID\n- `priority` (optional): Priority name\n- `customFields` (optional): Custom fields to update\n\n**Example queries:**\n- \"Update PROJ-123 to change its priority to High\"\n- \"Add label 'urgent' to issue ABC-456\"\n- \"Assign issue PROJ-123 to user with account ID 5b10a2844c20165700ede21g\"\n- \"Unassign issue ABC-456\"\n\n**Assigning Issues:**\n\nThis tool supports assigning and unassigning issues:\n\n**To assign an issue:**\n- Use the `assignee` parameter with the user's account ID\n- Example: `{ \"issueKey\": \"PROJ-123\", \"assignee\": \"5b10a2844c20165700ede21g\" }`\n\n**To unassign an issue:**\n- Use the `assignee` parameter with `null` or an empty string\n- Example: `{ \"issueKey\": \"PROJ-123\", \"assignee\": null }`\n\n**Note:** You need the user's account ID, not their email or display name. Account IDs can be found using the JIRA web interface or by implementing the `jira_search_users` tool (see future-tools.md).\n\n### 5. jira_get_transitions\n\nGet available status transitions for a JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n\n**Example queries:**\n- \"What status transitions are available for PROJ-123?\"\n- \"Show me the possible next states for issue ABC-456\"\n\n### 6. jira_transition_issue\n\nTransition a JIRA issue to a new status.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `transitionId` (required): Transition ID (get from jira_get_transitions)\n- `comment` (optional): Comment to add with transition\n\n**Example queries:**\n- \"Move PROJ-123 to 'In Progress'\"\n- \"Mark ABC-456 as Done with comment 'Completed and tested'\"\n\n### 7. jira_get_changelog\n\nGet complete changelog for an issue with time-in-status analytics.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `includeTimeInStatus` (optional): Calculate time spent in each status (default: true)\n\n**Example queries:**\n- \"Show me the complete history of PROJ-123\"\n- \"How long has ABC-456 been in each status?\"\n- \"Analyze the time-in-status for issue XYZ-789\"\n\n### 8. jira_list_projects\n\nList all accessible JIRA projects.\n\n**Parameters:**\n- `startAt` (optional): Starting index for pagination (default: 0)\n- `maxResults` (optional): Maximum results (default: 50)\n\n**Example queries:**\n- \"List all JIRA projects\"\n- \"Show me the available projects\"\n\n### 9. jira_get_project\n\nGet detailed information about a specific project including issue types.\n\n**Parameters:**\n- `projectKey` (required): Project key\n\n**Example queries:**\n- \"Get details for project ABC\"\n- \"What issue types are available in project PROJ?\"\n\n### 10. jira_add_comment\n\nAdd a comment to a JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `body` (required): Comment text\n\n**Example queries:**\n- \"Add a comment to PROJ-123: 'This needs review'\"\n- \"Comment on ABC-456 that the fix is ready for testing\"\n\n### 11. jira_get_comments\n\nGet comments from a JIRA issue with pagination.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `startAt` (optional): Starting index for pagination (default: 0)\n- `maxResults` (optional): Maximum comments (default: 50)\n- `orderBy` (optional): Sort order ('created' or '-created')\n\n**Example queries:**\n- \"Show me all comments on PROJ-123\"\n- \"Get the latest comments from issue ABC-456\"\n\n### 12. jira_update_comment\n\nUpdate an existing comment on a JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `commentId` (required): Comment ID to update\n- `body` (required): Updated comment text\n\n**Example queries:**\n- \"Update comment 10000 on issue PROJ-123 with text 'Corrected information'\"\n- \"Edit comment 10001 on ABC-456 to say 'This has been resolved'\"\n\n**Note:** You can get comment IDs from the `jira_get_comments` tool.\n\n### 13. jira_delete_comment\n\nDelete a comment from a JIRA issue.\n\n**Parameters:**\n- `issueKey` (required): Issue key\n- `commentId` (required): Comment ID to delete\n\n**Example queries:**\n- \"Delete comment 10000 from issue PROJ-123\"\n- \"Remove comment 10001 from ABC-456\"\n\n**Note:**\n- Deleted comments cannot be recovered\n- You need either \"Delete all comments\" permission or \"Delete own comments\" permission (if you're the comment author)\n- You can get comment IDs from the `jira_get_comments` tool\n\n### 14. jira_get_issue_link_types\n\nGet all available issue link types in your JIRA instance.\n\n**Parameters:**\n- None\n\n**Returns:**\n- `issueLinkTypes`: Array of link type objects, each containing:\n  - `id`: Unique identifier for the link type\n  - `name`: Display name (e.g., \"Blocks\", \"Clones\", \"Relates\")\n  - `inward`: Description for the inward relationship (e.g., \"is blocked by\")\n  - `outward`: Description for the outward relationship (e.g., \"blocks\")\n  - `self`: API URL for this link type\n\n**Example queries:**\n- \"What issue link types are available?\"\n- \"Show me all relationship types I can use for linking issues\"\n- \"List the available issue link types\"\n\n**Use cases:**\n- Discovering available relationship types before creating issue links\n- Building UI for issue linking features\n- Understanding the link types configured in your JIRA instance\n\n**Common link types:**\n- **Blocks/Blocked by** - Indicates dependency relationships\n- **Clones/Cloned by** - For duplicate or cloned issues\n- **Duplicate/Duplicated by** - For marking duplicate issues\n- **Relates to** - General relationship between issues\n\n**Note:** This endpoint can be accessed anonymously and doesn't require special permissions.\n\n### 15. jira_get_field_options\n\nGet field metadata for creating issues in a specific project and issue type. This returns valid values for all fields including priorities (respecting priority schemes), assignees, components, versions, and other field constraints.\n\n**Parameters:**\n- `projectKey` (required): Project key (e.g., \"PROJ\")\n- `issueTypeId` (required): Issue type ID (get from `jira_get_project`)\n\n**Returns:**\nField metadata object containing:\n- `fields`: Object with metadata for each field\n  - Each field includes:\n    - `required`: Boolean indicating if field is required\n    - `schema`: Field type information\n    - `name`: Display name\n    - `operations`: Allowed operations (e.g., \"set\")\n    - `allowedValues`: Array of valid values (for select fields)\n\n**Priority-Specific Usage:**\nTo get valid priorities for a project/issue type:\n```javascript\n// Extract priorities from response\nconst priorities = response.fields.priority.allowedValues;\n// Returns array of: [{id, name, description, iconUrl, statusColor}, ...]\n```\n\n**Example queries:**\n- \"What priorities are available for creating bugs in project PROJ?\"\n- \"Show me all valid field values for creating a Task in ABC project\"\n- \"What are the required fields for creating a Story in PROJ?\"\n- \"Get the issue type ID from ABC project, then show me create metadata for that type\"\n\n**Use cases:**\n- **Context-aware priority discovery** - Get ONLY priorities valid for specific project/issue type (respects priority schemes)\n- **Form validation** - Validate field values before creating issues\n- **Dynamic UI generation** - Populate dropdowns with correct options\n- **Required field detection** - Identify which fields are mandatory\n- **Custom field discovery** - Find available custom fields and their constraints\n- **Assignee validation** - Get list of users who can be assigned to issues\n\n**Understanding Priority Schemes:**\n\nJIRA Cloud uses **priority schemes** to control which priorities are available in each project:\n- Different projects can have different sets of available priorities\n- This tool returns ONLY priorities valid for the specific project/issue type (respects priority schemes)\n- Always use this tool when you need to discover valid priorities for a project\n\n**Example Response Structure:**\n```json\n{\n  \"fields\": {\n    \"priority\": {\n      \"required\": false,\n      \"schema\": {\n        \"type\": \"priority\",\n        \"system\": \"priority\"\n      },\n      \"name\": \"Priority\",\n      \"operations\": [\"set\"],\n      \"allowedValues\": [\n        {\n          \"id\": \"1\",\n          \"name\": \"Highest\",\n          \"iconUrl\": \"https://...\",\n          \"description\": \"Critical issues...\"\n        },\n        {\n          \"id\": \"3\",\n          \"name\": \"Medium\",\n          \"iconUrl\": \"https://...\"\n        }\n      ]\n    },\n    \"summary\": {\n      \"required\": true,\n      \"schema\": {\n        \"type\": \"string\",\n        \"system\": \"summary\"\n      },\n      \"name\": \"Summary\",\n      \"operations\": [\"set\"]\n    }\n  }\n}\n```\n\n**Permissions Required:**\n- Browse projects project permission\n- Create issues project permission\n\n**Note:**\n- This is the recommended way to discover valid field values before creating issues\n- Respects project-specific priority schemes (only shows priorities available for the context)\n- Returns metadata for ALL fields, not just priorities\n- Use `jira_get_project` to get available issue type IDs for a project\n\n### 16. jira_delete_issue\n\nDelete a JIRA issue permanently.\n\n**Parameters:**\n- `issueKey` (required): Issue key to delete (e.g., \"PROJ-123\")\n- `deleteSubtasks` (optional): Delete all subtasks as well (default: false)\n\n**Example queries:**\n- \"Delete issue PROJ-123\"\n- \"Delete issue ABC-456 and all its subtasks\"\n- \"Remove test issue TEST-999\"\n\n**Use cases:**\n- Removing test issues from a project\n- Cleaning up duplicate issues\n- Deleting issues as part of project cleanup\n- Removing invalid or spam issues\n\n**⚠️ CRITICAL WARNINGS:**\n\n1. **IRREVERSIBLE OPERATION** - Deleted issues **CANNOT be recovered** through the API or JIRA interface\n2. **Subtask handling** - The API will reject deletion if the issue has subtasks unless `deleteSubtasks` is set to true\n3. **Audit trail loss** - Consider transitioning issues to a \"Closed\" or \"Done\" status instead of deleting them to maintain audit trails\n4. **Issue links broken** - All links to/from the deleted issue will be broken\n5. **History lost** - All comments, attachments, and change history will be permanently deleted\n\n**Permissions Required:**\n- Browse projects project permission\n- Delete issues project permission\n- If issue-level security is configured: issue-level security permission to view the issue\n\n**Error Cases:**\n- **400 Bad Request**: Issue has subtasks but `deleteSubtasks` is false\n- **403 Forbidden**: User does not have permission to delete the issue\n- **404 Not Found**: Issue does not exist or user cannot view it\n\n**Best Practice:**\nInstead of deleting issues, consider:\n- Transitioning to a closed status (preserves audit trail)\n- Moving to an archive project (keeps data accessible)\n- Adding labels like \"duplicate\" or \"invalid\" (maintains searchability)\n\n**Note:** This operation can be accessed anonymously if JIRA permissions allow it.\n\n### 17. jira_search_users\n\nSearch for users in JIRA by query string. Returns user details including account IDs needed for assignment and other operations.\n\n**Parameters:**\n- `query` (optional): Search by partial email address, display name, or username\n- `accountId` (optional): Filter by specific account ID\n- `startAt` (optional): Starting index for pagination (default: 0)\n- `maxResults` (optional): Maximum number of results to return (default: 50, max: 1000)\n\n**Example queries:**\n- \"Search for users with email john@example.com\"\n- \"Find user with display name John Doe\"\n- \"Look up user with account ID 5b10a2844c20165700ede21g\"\n- \"Search for users matching 'smith'\"\n\n**Use cases:**\n- Finding account IDs to assign issues to users\n- Looking up users before performing operations\n- User autocomplete functionality\n- Validating user existence before creating assignments\n- Building user selection lists\n\n**Response includes:**\n- `accountId`: User's account ID (needed for assignment)\n- `displayName`: User's full name\n- `emailAddress`: User's email (if permissions allow)\n- `active`: Whether the user account is active\n- `avatarUrls`: URLs to user's avatar images\n- `accountType`: Type of account (e.g., \"atlassian\")\n- `timeZone`: User's configured timezone\n- `locale`: User's locale settings\n\n**Examples:**\n\n```javascript\n// Search by email\n{\n  \"query\": \"john@example.com\"\n}\n\n// Search by display name\n{\n  \"query\": \"John Doe\"\n}\n\n// Get specific user by account ID\n{\n  \"accountId\": \"5b10a2844c20165700ede21g\"\n}\n\n// Paginated search\n{\n  \"query\": \"smith\",\n  \"startAt\": 0,\n  \"maxResults\": 50\n}\n```\n\n**Permissions Required:**\n- Browse users global permission\n- Administer JIRA global permission (to get users for any project)\n- OR Administer Projects project permission (to get users for that specific project)\n\n**Important Notes:**\n- The `username` parameter has been deprecated due to privacy changes; use `query` instead\n- Results are paginated with a maximum of 1000 results per request\n- Email addresses may not be returned if privacy settings restrict access\n- Customer accounts in JSM may have different accountId formats (e.g., `qm:...`)\n- Use the returned `accountId` for assignment operations with `jira_update_issue`\n\n**Common workflow:**\n1. Search for a user: `jira_search_users` with `query` parameter\n2. Get the user's `accountId` from the results\n3. Assign an issue: Use `jira_update_issue` with the `assignee` parameter set to the `accountId`\n\n## JQL Query Examples\n\nJIRA Query Language (JQL) is a powerful way to search for issues. Here are some common examples:\n\n```jql\n# All open issues in a project\nproject = ABC AND status != Done\n\n# Issues assigned to you\nassignee = currentUser()\n\n# High priority bugs\ntype = Bug AND priority = High\n\n# Issues created in the last 7 days\ncreated >= -7d\n\n# Issues updated today\nupdated >= startOfDay()\n\n# Complex query with multiple conditions\nproject = ABC AND status = \"In Progress\" AND assignee = currentUser() AND priority IN (High, Highest)\n\n# Issues with specific labels\nlabels = frontend AND labels = urgent\n\n# Issues without assignee\nassignee is EMPTY\n```\n\n## Troubleshooting\n\n### Authentication Failed\n\n**Error**: \"Authentication failed. Please check your email and API token.\"\n\n**Solution**:\n1. Verify your email address is correct\n2. Generate a new API token from https://id.atlassian.com/manage-profile/security/api-tokens\n3. Make sure you're using the correct JIRA Cloud URL (not Server/Data Center)\n\n### Permission Denied\n\n**Error**: \"Forbidden - You do not have permission to access this resource.\"\n\n**Solution**:\n- Check that your JIRA account has the necessary permissions for the operation\n- Some operations require project admin or JIRA admin permissions\n- Contact your JIRA administrator if you need additional permissions\n\n### Rate Limiting\n\n**Error**: \"Rate limit exceeded. Please try again later.\"\n\n**Solution**:\n- JIRA Cloud has rate limits that vary by plan\n- Wait a few minutes before retrying\n- Consider reducing the frequency of requests\n\n### Issue Not Found\n\n**Error**: \"Not Found - The requested resource does not exist.\"\n\n**Solution**:\n- Verify the issue key is correct (e.g., PROJ-123, not proj-123)\n- Check that you have permission to view the issue\n- Ensure the issue exists in your JIRA instance\n\n### Invalid JQL\n\n**Error**: \"Bad Request - [JQL error message]\"\n\n**Solution**:\n- Review your JQL syntax\n- Use the JIRA web interface to test your query first\n- Refer to the JQL documentation: https://support.atlassian.com/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/\n\n## Security Notes\n\n- API tokens have the same permissions as your user account\n- Rotate API tokens regularly\n- Monitor API token usage in your Atlassian account settings\n\n## JIRA Cloud vs JIRA Server/Data Center\n\nThis server is designed specifically for **JIRA Cloud**. Key differences:\n\n| Feature | JIRA Cloud | JIRA Server/Data Center |\n|---------|------------|-------------------------|\n| Authentication | API Token + Email | Personal Access Token or Username + Password |\n| API Version | REST API v3 | REST API v2 |\n| Base URL | `https://company.atlassian.net` | Self-hosted URL |\n\nIf you're using JIRA Server or Data Center, you'll need a different implementation.\n\n## Resources\n\n- [JIRA Cloud REST API Documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/)\n- [JQL Documentation](https://support.atlassian.com/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/)\n- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)\n- [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n","readmeFilename":"README.md"}