@mcp-monorepo/jira 1.3.0 → 1.4.0

package/README.md

@@ -1,12 +1,12 @@
 <!--
   DO NOT EDIT THIS FILE DIRECTLY.
   IT IS AUTOMATICALLY GENERATED.
-  Last generated: 2026-02-18T09:43:33.221Z
+  Last generated: 2026-02-18T12:57:56.494Z
 -->
 
 # @mcp-monorepo/jira
 
-![version](https://img.shields.io/badge/version-1.2.0-blue) ![repo](https://img.shields.io/badge/monorepo-source-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FCaesar2011%2Fmcp-monorepo%2Ftree%2Fmain%2Fpackages%2Fjira)
+![version](https://img.shields.io/badge/version-1.3.0-blue) ![repo](https://img.shields.io/badge/monorepo-source-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FCaesar2011%2Fmcp-monorepo%2Ftree%2Fmain%2Fpackages%2Fjira)
 
 MCP server for Jira tools (JQL, issue management, etc.).
 
@@ -50,6 +50,7 @@ To integrate this server with a compatible AI model (like Claude), provide the f
         "JIRA_BASE_URL": "<Your JIRA_BASE_URL Here>",
         "JIRA_TOKEN": "<Your JIRA_TOKEN Here>",
         "JIRA_COOKIE": "<Your JIRA_COOKIE Here>",
+        "JIRA_API_VERSION": "2",
         "JIRA_INSECURE_SKIP_VERIFY": "false"
       }
     }
@@ -64,6 +65,7 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | `JIRA_BASE_URL` | The base URL for your Jira instance (e.g., https://your-company.atlassian.net). | `<required>` |
 | `JIRA_TOKEN` | A Jira Personal Access Token (PAT) with appropriate permissions to read and modify issues. Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set. | `<optional>` |
 | `JIRA_COOKIE` | A Jira session cookie value (e.g., the full Cookie header string). Useful for environments where a PAT is not available. Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set. | `<optional>` |
+| `JIRA_API_VERSION` | The Jira REST API version to use: '2' (default) or '3'. API v3 includes: (1) Issue descriptions in Atlassian Document Format (ADF) which are automatically converted to Markdown, (2) User emailAddress may be null due to GDPR privacy settings, (3) Enhanced JQL search endpoint with nextPageToken-based pagination for better performance with large result sets. Use v3 to access newer features and ADF support for rich text formatting in issue descriptions. | `2` |
 | `JIRA_INSECURE_SKIP_VERIFY` | Set to 'true' to disable TLS certificate validation. Use with caution, as this is a security risk. Recommended only for self-hosted Jira instances with self-signed certificates. | `false` |
 
 ## Tools
@@ -81,7 +83,7 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 
 ### `execute-jql`
 
-**Execute Jira JQL** - Execute a Jira Query Language (JQL) search and return issues.
+**Execute Jira JQL** - Execute a Jira Query Language (JQL) search and return issues. In API v3, uses enhanced search with nextPageToken pagination. In API v2, uses legacy search with startAt pagination.
 
 **Input Schema**
 
@@ -89,7 +91,8 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | :--- | :--- | :--- |
 | `jql` | `string` | JQL query string |
 | `maxResults` | `integer` | Maximum number of results to return (default: 50) |
-| `startAt` | `integer` | Index of first result for pagination (default: 0) |
+| `startAt` | `integer` | Index of first result for pagination (v2 only, default: 0) |
+| `nextPageToken` | `string` | Token for next page of results (v3 only) |
 | `fields` | `array of string` | Fields to include in results (default: [summary, status, assignee]) |
 
 
@@ -150,6 +153,75 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | `issueIdOrKey` | `string` | Jira issue key or numeric ID |
 
 
+---
+
+### `get-create-metadata`
+
+**Get Jira Create Issue Metadata** - Get metadata about fields required to create issues in a project. Returns issue types, priorities, and field requirements. Use this to find valid issueTypeId and priorityId values for creating issues.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `projectKey` | `string` | Filter by project key (e.g., "PROJ") |
+| `issueTypeId` | `string` | Filter by specific issue type ID |
+
+
+---
+
+### `create-issue`
+
+**Create Jira Issue** - Create a new Jira issue. Use get-create-metadata to find valid issueTypeId and priorityId values for your project.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `projectKey` | `string` | Project key (e.g., "PROJ") |
+| `issueTypeId` | `string` | Issue type ID (use get-create-metadata to find valid IDs) |
+| `summary` | `string` | Issue title/summary |
+| `description` | `string` | Issue description (supports Markdown formatting in API v3, plain text in v2) |
+| `assigneeId` | `string` | Assignee account ID (leave empty for unassigned) |
+| `priorityId` | `string` | Priority ID (use get-create-metadata to find valid IDs) |
+| `labels` | `array of string` | Labels for the issue |
+| `parentKey` | `string` | Parent issue key (required for creating subtasks) |
+
+
+---
+
+### `update-issue`
+
+**Update Jira Issue** - Update fields of an existing Jira issue. Only provided fields will be updated, others remain unchanged.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `issueIdOrKey` | `string` | Issue key or ID (e.g., "PROJ-123") |
+| `summary` | `string` | New issue title/summary |
+| `description` | `string` | New description (supports Markdown formatting in API v3, plain text in v2) |
+| `assigneeId` | `any` | Assignee account ID (null to unassign, undefined to leave unchanged) |
+| `priorityId` | `string` | New priority ID |
+| `labels` | `array of string` | New labels (replaces existing labels) |
+
+
+---
+
+### `add-comment`
+
+**Add Comment to Jira Issue** - Add a comment to an existing Jira issue.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `issueIdOrKey` | `string` | Issue key or ID (e.g., "PROJ-123") |
+| `comment` | `string` | Comment text (supports Markdown formatting in API v3, plain text in v2) |
+| `visibility` | `object` | Restrict comment visibility to a specific role or group (optional) |
+| `visibility.type` | `string` | Visibility type: role or group |
+| `visibility.value` | `string` | Role name or group name |
+
+
 ## Other MCP Servers
 
 This monorepo contains several other MCP server packages available on npm. Each provides a distinct set of tools for use with the Model Context Protocol.
@@ -167,6 +239,10 @@ This monorepo contains several other MCP server packages available on npm. Each
 
 ## Recent Changes
 
+### Version 1.3.0
+
+- 397cff4: add cookie-based authentication and require exactly one of JIRA_TOKEN or JIRA_COOKIE
+
 ### Version 1.2.0
 
 - 7f6ee0a: generate READMEs for packages via MCP introspection, add docgen and scripts, bump zod to v4 with schema fixes, improve syslog/logger graceful shutdown
@@ -175,10 +251,6 @@ This monorepo contains several other MCP server packages available on npm. Each
 
 - fd22b00: Fixed yarn versioning during publish
 
-### Version 1.1.2
-
-- Updated dependencies [7929a55]
-
 ---
 ## Authors
 

package/dist/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
 import { createMcpServer, logger } from '@mcp-monorepo/shared';
-import { getJiraAuthMode, getJiraBaseUrl } from './lib/jira-env.js';
+import { getJiraApiVersion, getJiraAuthMode, getJiraBaseUrl } from './lib/jira-env.js';
 import { getCurrentProfile } from './lib/jira.service.js';
+import { registerAddCommentTool } from './tools/add-comment.js';
+import { registerCreateIssueTool } from './tools/create-issue.js';
 import { registerExecuteJqlTool } from './tools/execute-jql.js';
+import { registerGetCreateMetadataTool } from './tools/get-create-metadata.js';
 import { registerGetCurrentProfileTool } from './tools/get-current-profile.js';
 import { registerGetIssueTool } from './tools/get-issue.js';
 import { registerGetLatestProjectsTool } from './tools/get-latest-projects.js';
 import { registerGetTicketTransitionsTool } from './tools/get-ticket-transitions.js';
 import { registerSetIssueStatusTool } from './tools/set-issue-status.js';
+import { registerUpdateIssueTool } from './tools/update-issue.js';
 createMcpServer({
     name: 'jira',
     importMetaPath: import.meta.filename,
@@ -19,6 +23,10 @@ createMcpServer({
         registerGetIssueTool,
         registerSetIssueStatusTool,
         registerGetTicketTransitionsTool,
+        registerGetCreateMetadataTool,
+        registerCreateIssueTool,
+        registerUpdateIssueTool,
+        registerAddCommentTool,
     ],
     async onReady() {
         if (process.env.JIRA_INSECURE_SKIP_VERIFY === 'true') {
@@ -28,12 +36,20 @@ createMcpServer({
         // Eagerly validate environment variables to fail fast on startup.
         getJiraBaseUrl();
         const auth = getJiraAuthMode();
+        const apiVersion = getJiraApiVersion();
+        logger.info(`Using Jira REST API version ${apiVersion}`);
         logger.info(`Using Jira authentication mode: ${auth.type}`);
+        if (apiVersion === '3') {
+            logger.info('API v3 features: Issue descriptions are converted from Atlassian Document Format (ADF) to Markdown. ' +
+                'User emailAddress may be null due to GDPR privacy settings. ' +
+                'JQL search uses enhanced endpoint with nextPageToken pagination.');
+        }
         // Perform a test API call to ensure credentials are valid and the service is reachable.
         try {
             logger.info('Verifying Jira connection and credentials...');
             const profile = await getCurrentProfile();
-            logger.info(`Successfully connected to Jira as "${profile.displayName}" (${profile.emailAddress}).`);
+            const emailDisplay = profile.emailAddress || '<email hidden>';
+            logger.info(`Successfully connected to Jira as "${profile.displayName}" (${emailDisplay}).`);
         }
         catch (error) {
             logger.error('Failed to connect to Jira. Please check JIRA_BASE_URL, JIRA_TOKEN/JIRA_COOKIE, and TLS settings.', error);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAExE,eAAe,CAAC;IACd,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE;QACL,6BAA6B;QAC7B,sBAAsB;QACtB,6BAA6B;QAC7B,oBAAoB;QACpB,0BAA0B;QAC1B,gCAAgC;KACjC;IACD,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAA;YAC9C,MAAM,CAAC,IAAI,CACT,mLAAmL,CACpL,CAAA;QACH,CAAC;QAED,kEAAkE;QAClE,cAAc,EAAE,CAAA;QAChB,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAC9B,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAE3D,wFAAwF;QACxF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;YACzC,MAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,YAAY,IAAI,CAAC,CAAA;QACtG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,kGAAkG,EAClG,KAAK,CACN,CAAA;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;CACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,eAAe,CAAC;IACd,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE;QACL,6BAA6B;QAC7B,sBAAsB;QACtB,6BAA6B;QAC7B,oBAAoB;QACpB,0BAA0B;QAC1B,gCAAgC;QAChC,6BAA6B;QAC7B,uBAAuB;QACvB,uBAAuB;QACvB,sBAAsB;KACvB;IACD,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAA;YAC9C,MAAM,CAAC,IAAI,CACT,mLAAmL,CACpL,CAAA;QACH,CAAC;QAED,kEAAkE;QAClE,cAAc,EAAE,CAAA;QAChB,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAC9B,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAA;QAEtC,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAE3D,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,sGAAsG;gBACpG,8DAA8D;gBAC9D,kEAAkE,CACrE,CAAA;QACH,CAAC;QAED,wFAAwF;QACxF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;YACzC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAA;YAC7D,MAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,WAAW,MAAM,YAAY,IAAI,CAAC,CAAA;QAC9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,kGAAkG,EAClG,KAAK,CACN,CAAA;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;CACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,CAAA"}

package/dist/lib/adf-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Utility functions for converting between Atlassian Document Format (ADF) and Markdown
+ */
+import { type ADFDocument } from 'extended-markdown-adf-parser';
+/**
+ * Convert ADF to Markdown string
+ * Returns undefined if input is undefined, empty string if conversion fails
+ */
+export declare function adfToMd(adf: ADFDocument | string | undefined): string | undefined;
+/**
+ * Convert Markdown string to ADF
+ * Returns undefined if input is undefined
+ */
+export declare function mdToAdf(markdown: string | undefined): ADFDocument | undefined;
+/**
+ * Check if a value is an ADF object
+ */
+export declare function isAdf(value: unknown): value is ADFDocument;
+//# sourceMappingURL=adf-utils.d.ts.map

package/dist/lib/adf-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-utils.d.ts","sourceRoot":"","sources":["../../src/lib/adf-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,WAAW,EAA4C,MAAM,8BAA8B,CAAA;AAKzG;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUjF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAS7E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAU1D"}

package/dist/lib/adf-utils.js

@@ -0,0 +1,52 @@
+/**
+ * Utility functions for converting between Atlassian Document Format (ADF) and Markdown
+ */
+import { logger } from '@mcp-monorepo/shared';
+import { AdfToMarkdownEngine, MarkdownToAdfEngine } from 'extended-markdown-adf-parser';
+const adfToMarkdownEngine = new AdfToMarkdownEngine();
+const markdownToAdfEngine = new MarkdownToAdfEngine();
+/**
+ * Convert ADF to Markdown string
+ * Returns undefined if input is undefined, empty string if conversion fails
+ */
+export function adfToMd(adf) {
+    if (!adf)
+        return undefined;
+    if (typeof adf === 'string')
+        return adf; // Already a string (v2 format)
+    try {
+        return adfToMarkdownEngine.convert(adf);
+    }
+    catch (error) {
+        logger.error('Failed to convert ADF to Markdown:', error);
+        return ''; // Return empty string on error
+    }
+}
+/**
+ * Convert Markdown string to ADF
+ * Returns undefined if input is undefined
+ */
+export function mdToAdf(markdown) {
+    if (!markdown)
+        return undefined;
+    try {
+        return markdownToAdfEngine.convert(markdown);
+    }
+    catch (error) {
+        logger.error('Failed to convert Markdown to ADF:', error);
+        return undefined;
+    }
+}
+/**
+ * Check if a value is an ADF object
+ */
+export function isAdf(value) {
+    return (typeof value === 'object' &&
+        // eslint-disable-next-line no-restricted-syntax
+        value != null &&
+        'type' in value &&
+        value.type === 'doc' &&
+        'version' in value &&
+        'content' in value);
+}
+//# sourceMappingURL=adf-utils.js.map

package/dist/lib/adf-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-utils.js","sourceRoot":"","sources":["../../src/lib/adf-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAoB,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAEzG,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA;AACrD,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAqC;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA,CAAC,+BAA+B;IAEvE,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,EAAE,CAAA,CAAC,+BAA+B;IAC3C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,QAA4B;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAA;IAE/B,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAgB,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,gDAAgD;QAChD,KAAK,IAAI,IAAI;QACb,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,KAAK;QACpB,SAAS,IAAI,KAAK;QAClB,SAAS,IAAI,KAAK,CACnB,CAAA;AACH,CAAC"}

package/dist/lib/jira-env.d.ts

@@ -9,6 +9,8 @@ export type JiraAuthMode = {
     type: 'cookie';
     value: string;
 };
+export type JiraApiVersion = '2' | '3';
 export declare function getJiraBaseUrl(): string;
 export declare function getJiraAuthMode(): JiraAuthMode;
+export declare function getJiraApiVersion(): JiraApiVersion;
 //# sourceMappingURL=jira-env.d.ts.map

package/dist/lib/jira-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jira-env.d.ts","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAY9C"}
+{"version":3,"file":"jira-env.d.ts","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/F,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,CAAA;AAEtC,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAY9C;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD"}

package/dist/lib/jira-env.js

@@ -19,4 +19,11 @@ export function getJiraAuthMode() {
     }
     return token ? { type: 'token', value: token } : { type: 'cookie', value: cookie };
 }
+export function getJiraApiVersion() {
+    const version = process.env.JIRA_API_VERSION;
+    if (version && version !== '2' && version !== '3') {
+        throw new Error('JIRA_API_VERSION must be either "2" or "3"');
+    }
+    return (version || '2'); // Default: v2
+}
 //# sourceMappingURL=jira-env.js.map

package/dist/lib/jira-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"jira-env.js","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAEtC,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;IAChG,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAgB,EAAE,CAAA;AAC9F,CAAC"}
+{"version":3,"file":"jira-env.js","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAEtC,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;IAChG,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAgB,EAAE,CAAA;AAC9F,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;IAC5C,IAAI,OAAO,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,CAAC,OAAO,IAAI,GAAG,CAAmB,CAAA,CAAC,cAAc;AAC1D,CAAC"}

package/dist/lib/jira.service.d.ts

@@ -1,9 +1,36 @@
-import type { JiraIssue, JiraJqlResponse, JiraProfileResponse, JiraProjectsListResponse, JiraTransitionsResponse } from './types.js';
+import type { JiraComment, JiraCreateIssueResponse, JiraCreateMetadata, JiraEnhancedJqlResponse, JiraIssue, JiraJqlResponse, JiraProfileResponse, JiraProjectsListResponse, JiraTransitionsResponse } from './types.js';
 export declare const getIssue: (issueIdOrKey: string, fields?: string[], expand?: string[]) => Promise<JiraIssue>;
-export declare const executeJql: (jql: string, maxResults?: number, startAt?: number, fields?: string[]) => Promise<JiraJqlResponse>;
+/**
+ * Execute JQL search using enhanced search endpoint (v3) or legacy search (v2)
+ * In v3, uses /rest/api/3/search/jql with nextPageToken pagination
+ * In v2, uses /rest/api/2/search with startAt pagination
+ */
+export declare const executeJql: (jql: string, maxResults?: number, startAt?: number, fields?: string[], nextPageToken?: string) => Promise<JiraEnhancedJqlResponse> | Promise<JiraJqlResponse>;
 export declare const getLatestProjects: (maxResults?: number) => Promise<JiraProjectsListResponse>;
 export declare const getCurrentProfile: () => Promise<JiraProfileResponse>;
 export declare const getTicketTransitions: (issueIdOrKey: string) => Promise<JiraTransitionsResponse>;
 export declare const setIssueStatus: (issueIdOrKey: string, transitionId: string, comment?: string) => Promise<void>;
 export declare const findTransitionIdByName: (issueIdOrKey: string, statusName: string) => Promise<string | undefined>;
+export declare const getCreateMetadata: (projectKey?: string, issueTypeId?: string) => Promise<JiraCreateMetadata>;
+export declare const createIssue: (params: {
+    projectKey: string;
+    issueTypeId: string;
+    summary: string;
+    description?: string;
+    assigneeId?: string;
+    priorityId?: string;
+    labels?: string[];
+    parentKey?: string;
+}) => Promise<JiraCreateIssueResponse>;
+export declare const updateIssue: (issueIdOrKey: string, updates: {
+    summary?: string;
+    description?: string;
+    assigneeId?: string | null;
+    priorityId?: string;
+    labels?: string[];
+}) => Promise<void>;
+export declare const addComment: (issueIdOrKey: string, commentText: string, visibility?: {
+    type: "role" | "group";
+    value: string;
+}) => Promise<JiraComment>;
 //# sourceMappingURL=jira.service.d.ts.map

package/dist/lib/jira.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jira.service.d.ts","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAkCnB,eAAO,MAAM,QAAQ,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,uBAKlF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,mBAAe,EAAE,gBAAW,EAAE,SAAS,MAAM,EAAE,6BAKtF,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,mBAAe,sCAEhD,CAAA;AAED,eAAO,MAAM,iBAAiB,oCAE7B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,qCAExD,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,UAAU,MAAM,kBAShG,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,cAAc,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAIjH,CAAA"}
+{"version":3,"file":"jira.service.d.ts","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAkEnB,eAAO,MAAM,QAAQ,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,uBAKlF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,mBAAe,EAAE,gBAAW,EAAE,SAAS,MAAM,EAAE,EAAE,gBAAgB,MAAM,gEAqB9G,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,mBAAe,sCAIhD,CAAA;AAED,eAAO,MAAM,iBAAiB,oCAE7B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,qCAExD,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,UAAU,MAAM,kBAShG,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,cAAc,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAIjH,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,EAAE,cAAc,MAAM,gCAOhF,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,QAAQ;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,uBAAuB,CA6ClC,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,cAAc,MAAM,EACpB,SAAS;IACP,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,KACA,OAAO,CAAC,IAAI,CAqCd,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,aAAa,MAAM,EACnB,aAAa;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KACrD,OAAO,CAAC,WAAW,CAerB,CAAA"}

package/dist/lib/jira.service.js

@@ -1,4 +1,5 @@
-import { getJiraAuthMode, getJiraBaseUrl } from './jira-env.js';
+import { mdToAdf } from './adf-utils.js';
+import { getJiraApiVersion, getJiraAuthMode, getJiraBaseUrl } from './jira-env.js';
 function buildAuthHeaders() {
     const auth = getJiraAuthMode();
     if (auth.type === 'token') {
@@ -6,6 +7,10 @@ function buildAuthHeaders() {
     }
     return { Cookie: auth.value };
 }
+function buildApiPath(endpoint) {
+    const version = getJiraApiVersion();
+    return `/rest/api/${version}${endpoint}`;
+}
 async function jiraRequest(endpoint, options = {}) {
     const url = new URL(endpoint, getJiraBaseUrl());
     const response = await fetch(url.toString(), {
@@ -19,7 +24,28 @@ async function jiraRequest(endpoint, options = {}) {
     });
     if (!response.ok) {
         const errorText = await response.text();
-        throw new Error(`Jira API request failed with status ${response.status}: ${errorText}`);
+        let enhancedError = `Jira API request failed with status ${response.status}: ${errorText}`;
+        // Parse error and add helpful context
+        try {
+            const errorJson = JSON.parse(errorText);
+            if (errorJson.errors && Object.keys(errorJson.errors).length > 0) {
+                enhancedError += '\n\nMissing or invalid fields:';
+                Object.entries(errorJson.errors).forEach(([field, message]) => {
+                    enhancedError += `\n  - ${field}: ${message}`;
+                });
+                enhancedError += '\n\nTip: Use "get-create-metadata" tool to see available fields and requirements.';
+            }
+            if (errorJson.errorMessages && errorJson.errorMessages.length > 0) {
+                enhancedError += '\n\nError messages:';
+                errorJson.errorMessages.forEach((msg) => {
+                    enhancedError += `\n  - ${msg}`;
+                });
+            }
+        }
+        catch {
+            // If JSON parsing fails, use original error text
+        }
+        throw new Error(enhancedError);
     }
     if (response.status === 204) {
         return undefined;
@@ -32,29 +58,50 @@ export const getIssue = (issueIdOrKey, fields, expand) => {
         params.set('fields', fields.join(','));
     if (expand)
         params.set('expand', expand.join(','));
-    return jiraRequest(`/rest/api/2/issue/${issueIdOrKey}?${params.toString()}`);
+    return jiraRequest(`${buildApiPath(`/issue/${issueIdOrKey}`)}?${params.toString()}`);
 };
-export const executeJql = (jql, maxResults = 50, startAt = 0, fields) => {
-    return jiraRequest('/rest/api/2/search', {
-        method: 'POST',
-        body: JSON.stringify({ jql, maxResults, startAt, fields: fields ?? ['summary', 'status', 'assignee'] }),
-    });
+/**
+ * Execute JQL search using enhanced search endpoint (v3) or legacy search (v2)
+ * In v3, uses /rest/api/3/search/jql with nextPageToken pagination
+ * In v2, uses /rest/api/2/search with startAt pagination
+ */
+export const executeJql = (jql, maxResults = 50, startAt = 0, fields, nextPageToken) => {
+    const apiVersion = getJiraApiVersion();
+    if (apiVersion === '3') {
+        // Use enhanced search endpoint in v3
+        return jiraRequest(buildApiPath('/search/jql'), {
+            method: 'POST',
+            body: JSON.stringify({
+                jql,
+                maxResults,
+                fields: fields ?? ['summary', 'status', 'assignee'],
+                ...(nextPageToken && { nextPageToken }),
+            }),
+        });
+    }
+    else {
+        // Use legacy search endpoint in v2
+        return jiraRequest(buildApiPath('/search'), {
+            method: 'POST',
+            body: JSON.stringify({ jql, maxResults, startAt, fields: fields ?? ['summary', 'status', 'assignee'] }),
+        });
+    }
 };
 export const getLatestProjects = (maxResults = 10) => {
-    return jiraRequest(`/rest/api/2/project/search?orderBy=created&maxResults=${maxResults}`);
+    return jiraRequest(`${buildApiPath('/project/search')}?orderBy=created&maxResults=${maxResults}`);
 };
 export const getCurrentProfile = () => {
-    return jiraRequest('/rest/api/2/myself');
+    return jiraRequest(buildApiPath('/myself'));
 };
 export const getTicketTransitions = (issueIdOrKey) => {
-    return jiraRequest(`/rest/api/2/issue/${issueIdOrKey}/transitions`);
+    return jiraRequest(buildApiPath(`/issue/${issueIdOrKey}/transitions`));
 };
 export const setIssueStatus = async (issueIdOrKey, transitionId, comment) => {
     const body = { transition: { id: transitionId } };
     if (comment) {
         body.update = { comment: [{ add: { body: comment } }] };
     }
-    await jiraRequest(`/rest/api/2/issue/${issueIdOrKey}/transitions`, {
+    await jiraRequest(buildApiPath(`/issue/${issueIdOrKey}/transitions`), {
         method: 'POST',
         body: JSON.stringify(body),
     });
@@ -64,4 +111,105 @@ export const findTransitionIdByName = async (issueIdOrKey, statusName) => {
     const transition = response.transitions.find((t) => t.to.name.toLowerCase() === statusName.toLowerCase());
     return transition?.id;
 };
+export const getCreateMetadata = async (projectKey, issueTypeId) => {
+    const params = new URLSearchParams();
+    if (projectKey)
+        params.set('projectKeys', projectKey);
+    if (issueTypeId)
+        params.set('issuetypeIds', issueTypeId);
+    params.set('expand', 'projects.issuetypes.fields');
+    return jiraRequest(`${buildApiPath('/issue/createmeta')}?${params.toString()}`);
+};
+export const createIssue = async (params) => {
+    const apiVersion = getJiraApiVersion();
+    const body = {
+        fields: {
+            project: { key: params.projectKey },
+            issuetype: { id: params.issueTypeId },
+            summary: params.summary,
+        },
+    };
+    // Description: Markdown → ADF if v3, String if v2
+    if (params.description) {
+        if (apiVersion === '3') {
+            const adf = mdToAdf(params.description);
+            if (adf) {
+                ;
+                body.fields.description = adf;
+            }
+        }
+        else {
+            ;
+            body.fields.description = params.description;
+        }
+    }
+    // Assignee: accountId works in both v2 and v3
+    if (params.assigneeId) {
+        ;
+        body.fields.assignee = { id: params.assigneeId };
+    }
+    if (params.priorityId) {
+        ;
+        body.fields.priority = { id: params.priorityId };
+    }
+    if (params.labels && params.labels.length > 0) {
+        ;
+        body.fields.labels = params.labels;
+    }
+    // Parent for subtasks
+    if (params.parentKey) {
+        ;
+        body.fields.parent = { key: params.parentKey };
+    }
+    return jiraRequest(buildApiPath('/issue'), {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+};
+export const updateIssue = async (issueIdOrKey, updates) => {
+    const apiVersion = getJiraApiVersion();
+    const fields = {};
+    if (updates.summary !== undefined) {
+        fields.summary = updates.summary;
+    }
+    if (updates.description !== undefined) {
+        if (apiVersion === '3') {
+            const adf = mdToAdf(updates.description);
+            if (adf) {
+                fields.description = adf;
+            }
+        }
+        else {
+            fields.description = updates.description;
+        }
+    }
+    // Assignee: null means unassign, accountId works in both v2 and v3
+    if (updates.assigneeId !== undefined) {
+        // eslint-disable-next-line no-restricted-syntax
+        fields.assignee = updates.assigneeId ? { id: updates.assigneeId } : null;
+    }
+    if (updates.priorityId !== undefined) {
+        fields.priority = { id: updates.priorityId };
+    }
+    if (updates.labels !== undefined) {
+        fields.labels = updates.labels;
+    }
+    await jiraRequest(buildApiPath(`/issue/${issueIdOrKey}`), {
+        method: 'PUT',
+        body: JSON.stringify({ fields }),
+    });
+};
+export const addComment = async (issueIdOrKey, commentText, visibility) => {
+    const apiVersion = getJiraApiVersion();
+    const body = {
+        body: apiVersion === '3' ? mdToAdf(commentText) : commentText,
+    };
+    if (visibility) {
+        body.visibility = visibility;
+    }
+    return jiraRequest(buildApiPath(`/issue/${issueIdOrKey}/comment`), {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+};
 //# sourceMappingURL=jira.service.js.map

package/dist/lib/jira.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"jira.service.js","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jira.service.js","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -1,3 +1,4 @@
+import { type ADFDocument } from 'extended-markdown-adf-parser';
 export interface JiraIssue {
     id: string;
     key: string;
@@ -8,8 +9,9 @@ export interface JiraIssue {
         };
         assignee?: {
             displayName?: string;
-        };
-        description?: string;
+            accountId?: string;
+        } | null;
+        description?: string | ADFDocument;
     };
     expand?: string;
 }
@@ -20,6 +22,18 @@ export interface JiraJqlResponse {
     total: number;
     issues: JiraIssue[];
 }
+/**
+ * Enhanced JQL search response (v3 /search/jql endpoint)
+ * Uses nextPageToken instead of startAt for pagination
+ */
+export interface JiraEnhancedJqlResponse {
+    expand?: string;
+    maxResults: number;
+    isLast: boolean;
+    nextPageToken?: string;
+    issues: JiraIssue[];
+    total?: number;
+}
 export interface JiraProject {
     id: string;
     key: string;
@@ -38,8 +52,10 @@ export interface JiraProfileResponse {
     key: string;
     accountId: string;
     name: string;
-    emailAddress: string;
+    emailAddress: string | null;
     displayName: string;
+    timeZone?: string | null;
+    locale?: string | null;
 }
 export interface JiraTransition {
     id: string;
@@ -53,4 +69,76 @@ export interface JiraTransitionsResponse {
     expand?: string;
     transitions: JiraTransition[];
 }
+export interface JiraCreateIssueResponse {
+    id: string;
+    key: string;
+    self: string;
+    transition?: {
+        status: number;
+        errorCollection: {
+            errorMessages: string[];
+            errors: Record<string, string>;
+        };
+    };
+}
+export interface JiraComment {
+    id: string;
+    self: string;
+    author: {
+        accountId: string;
+        displayName: string;
+        emailAddress?: string | null;
+    };
+    body: string | ADFDocument;
+    created: string;
+    updated: string;
+    updateAuthor: {
+        accountId: string;
+        displayName: string;
+    };
+    visibility?: {
+        type: string;
+        value: string;
+        identifier: string;
+    };
+}
+export interface JiraIssueType {
+    id: string;
+    name: string;
+    description?: string;
+    subtask: boolean;
+}
+export interface JiraFieldSchema {
+    type: string;
+    system?: string;
+    items?: string;
+    custom?: string;
+}
+export interface JiraFieldMetadata {
+    required: boolean;
+    name: string;
+    schema: JiraFieldSchema;
+    key?: string;
+    hasDefaultValue?: boolean;
+    operations?: string[];
+    allowedValues?: Array<{
+        id?: string;
+        name?: string;
+        value?: string;
+    }>;
+}
+export interface JiraCreateMetadata {
+    projects: Array<{
+        id: string;
+        key: string;
+        name: string;
+        issuetypes: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            subtask: boolean;
+            fields: Record<string, JiraFieldMetadata>;
+        }>;
+    }>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAChC,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC1B,QAAQ,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACnC,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE;QACF,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,cAAc,EAAE,CAAA;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/add-comment.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerAddCommentTool: (server: McpServer) => void;
+//# sourceMappingURL=add-comment.d.ts.map

package/dist/tools/add-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-comment.d.ts","sourceRoot":"","sources":["../../src/tools/add-comment.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,SAiCpD,CAAA"}

package/dist/tools/add-comment.js

@@ -0,0 +1,38 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getJiraBaseUrl } from '../lib/jira-env.js';
+import { addComment } from '../lib/jira.service.js';
+export const registerAddCommentTool = (server) => registerTool(server, {
+    name: 'add-comment',
+    title: 'Add Comment to Jira Issue',
+    description: 'Add a comment to an existing Jira issue.',
+    inputSchema: {
+        issueIdOrKey: z.string().describe('Issue key or ID (e.g., "PROJ-123")'),
+        comment: z.string().describe('Comment text (supports Markdown formatting in API v3, plain text in v2)'),
+        visibility: z
+            .object({
+            type: z.enum(['role', 'group']).describe('Visibility type: role or group'),
+            value: z.string().describe('Role name or group name'),
+        })
+            .optional()
+            .describe('Restrict comment visibility to a specific role or group (optional)'),
+    },
+    outputSchema: {
+        commentId: z.string(),
+        created: z.string(),
+        url: z.string(),
+    },
+    isReadOnly: false,
+    async fetcher(params) {
+        const comment = await addComment(params.issueIdOrKey, params.comment, params.visibility);
+        return { comment, issueIdOrKey: params.issueIdOrKey };
+    },
+    formatter(data) {
+        return {
+            commentId: data.comment.id,
+            created: data.comment.created,
+            url: `${getJiraBaseUrl()}/browse/${data.issueIdOrKey}?focusedCommentId=${data.comment.id}`,
+        };
+    },
+});
+//# sourceMappingURL=add-comment.js.map

package/dist/tools/add-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-comment.js","sourceRoot":"","sources":["../../src/tools/add-comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAInD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC1D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,2BAA2B;IAClC,WAAW,EAAE,0CAA0C;IACvD,WAAW,EAAE;QACX,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;QACvG,UAAU,EAAE,CAAC;aACV,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACtD,CAAC;aACD,QAAQ,EAAE;aACV,QAAQ,CAAC,oEAAoE,CAAC;KAClF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,UAAU,EAAE,KAAK;IACjB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QACxF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAA;IACvD,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,GAAG,EAAE,GAAG,cAAc,EAAE,WAAW,IAAI,CAAC,YAAY,qBAAqB,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE;SAC3F,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/create-issue.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerCreateIssueTool: (server: McpServer) => void;
+//# sourceMappingURL=create-issue.d.ts.map

package/dist/tools/create-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-issue.d.ts","sourceRoot":"","sources":["../../src/tools/create-issue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,SA4CrD,CAAA"}

package/dist/tools/create-issue.js

@@ -0,0 +1,48 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getJiraBaseUrl } from '../lib/jira-env.js';
+import { createIssue } from '../lib/jira.service.js';
+export const registerCreateIssueTool = (server) => registerTool(server, {
+    name: 'create-issue',
+    title: 'Create Jira Issue',
+    description: 'Create a new Jira issue. Use get-create-metadata to find valid issueTypeId and priorityId values for your project.',
+    inputSchema: {
+        projectKey: z.string().describe('Project key (e.g., "PROJ")'),
+        issueTypeId: z.string().describe('Issue type ID (use get-create-metadata to find valid IDs)'),
+        summary: z.string().describe('Issue title/summary'),
+        description: z
+            .string()
+            .optional()
+            .describe('Issue description (supports Markdown formatting in API v3, plain text in v2)'),
+        assigneeId: z.string().optional().describe('Assignee account ID (leave empty for unassigned)'),
+        priorityId: z.string().optional().describe('Priority ID (use get-create-metadata to find valid IDs)'),
+        labels: z.array(z.string()).optional().describe('Labels for the issue'),
+        parentKey: z.string().optional().describe('Parent issue key (required for creating subtasks)'),
+    },
+    outputSchema: {
+        id: z.string(),
+        key: z.string(),
+        url: z.string(),
+    },
+    isReadOnly: false,
+    async fetcher(params) {
+        return createIssue({
+            projectKey: params.projectKey,
+            issueTypeId: params.issueTypeId,
+            summary: params.summary,
+            description: params.description,
+            assigneeId: params.assigneeId,
+            priorityId: params.priorityId,
+            labels: params.labels,
+            parentKey: params.parentKey,
+        });
+    },
+    formatter(data) {
+        return {
+            id: data.id,
+            key: data.key,
+            url: `${getJiraBaseUrl()}/browse/${data.key}`,
+        };
+    },
+});
+//# sourceMappingURL=create-issue.js.map

package/dist/tools/create-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-issue.js","sourceRoot":"","sources":["../../src/tools/create-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAIpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC3D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,oHAAoH;IACtH,WAAW,EAAE;QACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QAC7F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACnD,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8EAA8E,CAAC;QAC3F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC9F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACrG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KAC/F;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,UAAU,EAAE,KAAK;IACjB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,OAAO,WAAW,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAA;IACJ,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,GAAG,cAAc,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE;SAC9C,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/execute-jql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-jql.d.ts","sourceRoot":"","sources":["../../src/tools/execute-jql.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,SA4CpD,CAAA"}
+{"version":3,"file":"execute-jql.d.ts","sourceRoot":"","sources":["../../src/tools/execute-jql.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,SAuEpD,CAAA"}

package/dist/tools/execute-jql.js

@@ -1,10 +1,11 @@
 import { registerTool } from '@mcp-monorepo/shared';
 import { z } from 'zod';
+import { getJiraApiVersion } from '../lib/jira-env.js';
 import { executeJql } from '../lib/jira.service.js';
 export const registerExecuteJqlTool = (server) => registerTool(server, {
     name: 'execute-jql',
     title: 'Execute Jira JQL',
-    description: 'Execute a Jira Query Language (JQL) search and return issues.',
+    description: 'Execute a Jira Query Language (JQL) search and return issues. In API v3, uses enhanced search with nextPageToken pagination. In API v2, uses legacy search with startAt pagination.',
     inputSchema: {
         jql: z.string().describe('JQL query string'),
         maxResults: z
@@ -14,14 +15,22 @@ export const registerExecuteJqlTool = (server) => registerTool(server, {
             .max(100)
             .optional()
             .describe('Maximum number of results to return (default: 50)'),
-        startAt: z.number().int().min(0).optional().describe('Index of first result for pagination (default: 0)'),
+        startAt: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Index of first result for pagination (v2 only, default: 0)'),
+        nextPageToken: z.string().optional().describe('Token for next page of results (v3 only)'),
         fields: z
             .array(z.string())
             .optional()
             .describe('Fields to include in results (default: [summary, status, assignee])'),
     },
     outputSchema: {
-        total: z.number(),
+        total: z.number().optional(), // Not always present in v3
+        isLast: z.boolean().optional(), // Only in v3
+        nextPageToken: z.string().optional(), // Only in v3
         issues: z.array(z.object({
             key: z.string(),
             summary: z.string().optional(),
@@ -30,17 +39,35 @@ export const registerExecuteJqlTool = (server) => registerTool(server, {
     },
     isReadOnly: true,
     async fetcher(params) {
-        return executeJql(params.jql, params.maxResults, params.startAt, params.fields);
+        return executeJql(params.jql, params.maxResults, params.startAt, params.fields, params.nextPageToken);
     },
     formatter(data) {
-        return {
-            total: data.total,
-            issues: data.issues.map((issue) => ({
-                key: issue.key,
-                summary: issue.fields.summary,
-                status: issue.fields.status?.name,
-            })),
-        };
+        const apiVersion = getJiraApiVersion();
+        // Handle both v2 and v3 responses
+        if (apiVersion === '3' && 'isLast' in data) {
+            // v3 enhanced search response
+            return {
+                isLast: data.isLast,
+                nextPageToken: data.nextPageToken,
+                total: data.total,
+                issues: data.issues.map((issue) => ({
+                    key: issue.key,
+                    summary: issue.fields.summary,
+                    status: issue.fields.status?.name,
+                })),
+            };
+        }
+        else {
+            // v2 legacy search response
+            return {
+                total: data.total,
+                issues: data.issues.map((issue) => ({
+                    key: issue.key,
+                    summary: issue.fields.summary,
+                    status: issue.fields.status?.name,
+                })),
+            };
+        }
     },
 });
 //# sourceMappingURL=execute-jql.js.map

package/dist/tools/execute-jql.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute-jql.js","sourceRoot":"","sources":["../../src/tools/execute-jql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAInD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC1D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,+DAA+D;IAC5E,WAAW,EAAE;QACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC5C,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mDAAmD,CAAC;QAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;QACzG,MAAM,EAAE,CAAC;aACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;KACnF;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC,CACH;KACF;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACjF,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;gBAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI;aAClC,CAAC,CAAC;SACJ,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"execute-jql.js","sourceRoot":"","sources":["../../src/tools/execute-jql.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-create-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerGetCreateMetadataTool: (server: McpServer) => void;
+//# sourceMappingURL=get-create-metadata.d.ts.map

package/dist/tools/get-create-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-create-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/get-create-metadata.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,6BAA6B,GAAI,QAAQ,SAAS,SA+D3D,CAAA"}

package/dist/tools/get-create-metadata.js

@@ -0,0 +1,59 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getCreateMetadata } from '../lib/jira.service.js';
+export const registerGetCreateMetadataTool = (server) => registerTool(server, {
+    name: 'get-create-metadata',
+    title: 'Get Jira Create Issue Metadata',
+    description: 'Get metadata about fields required to create issues in a project. Returns issue types, priorities, and field requirements. Use this to find valid issueTypeId and priorityId values for creating issues.',
+    inputSchema: {
+        projectKey: z.string().optional().describe('Filter by project key (e.g., "PROJ")'),
+        issueTypeId: z.string().optional().describe('Filter by specific issue type ID'),
+    },
+    outputSchema: {
+        projects: z.array(z.object({
+            key: z.string(),
+            name: z.string(),
+            issueTypes: z.array(z.object({
+                id: z.string(),
+                name: z.string(),
+                subtask: z.boolean(),
+                requiredFields: z.array(z.string()),
+                availablePriorities: z.array(z.object({ id: z.string(), name: z.string() })).optional(),
+            })),
+        })),
+    },
+    isReadOnly: true,
+    async fetcher(params) {
+        return getCreateMetadata(params.projectKey, params.issueTypeId);
+    },
+    formatter(data) {
+        // Filter response to only show essential information
+        return {
+            projects: data.projects.map((project) => ({
+                key: project.key,
+                name: project.name,
+                issueTypes: project.issuetypes.map((issueType) => {
+                    const fields = issueType.fields;
+                    // Extract required fields
+                    const requiredFields = Object.entries(fields)
+                        .filter(([, meta]) => meta.required)
+                        .map(([key]) => key);
+                    // Extract priorities if available
+                    const priorityField = fields.priority;
+                    const availablePriorities = priorityField?.allowedValues?.map((p) => ({
+                        id: p.id ?? '',
+                        name: p.name ?? '',
+                    }));
+                    return {
+                        id: issueType.id,
+                        name: issueType.name,
+                        subtask: issueType.subtask,
+                        requiredFields,
+                        ...(availablePriorities && availablePriorities.length > 0 && { availablePriorities }),
+                    };
+                }),
+            })),
+        };
+    },
+});
+//# sourceMappingURL=get-create-metadata.js.map

package/dist/tools/get-create-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-create-metadata.js","sourceRoot":"","sources":["../../src/tools/get-create-metadata.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-current-profile.js

@@ -8,7 +8,7 @@ export const registerGetCurrentProfileTool = (server) => registerTool(server, {
     inputSchema: {},
     outputSchema: {
         displayName: z.string(),
-        emailAddress: z.string(),
+        emailAddress: z.string().nullable(),
         accountId: z.string(),
     },
     isReadOnly: true,

package/dist/tools/get-current-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-current-profile.js","sourceRoot":"","sources":["../../src/tools/get-current-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAI1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAiB,EAAE,EAAE,CACjE,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,4DAA4D;IACzE,WAAW,EAAE,EAAE;IACf,YAAY,EAAE;QACZ,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,iBAAiB,EAAE,CAAA;IAC5B,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"get-current-profile.js","sourceRoot":"","sources":["../../src/tools/get-current-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAI1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAiB,EAAE,EAAE,CACjE,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,4DAA4D;IACzE,WAAW,EAAE,EAAE;IACf,YAAY,EAAE;QACZ,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,iBAAiB,EAAE,CAAA;IAC5B,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/get-issue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-issue.d.ts","sourceRoot":"","sources":["../../src/tools/get-issue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SA8BlD,CAAA"}
+{"version":3,"file":"get-issue.d.ts","sourceRoot":"","sources":["../../src/tools/get-issue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SA8BlD,CAAA"}

package/dist/tools/get-issue.js

@@ -1,5 +1,6 @@
 import { registerTool } from '@mcp-monorepo/shared';
 import { z } from 'zod';
+import { adfToMd } from '../lib/adf-utils.js';
 import { getIssue } from '../lib/jira.service.js';
 export const registerGetIssueTool = (server) => registerTool(server, {
     name: 'get-issue',
@@ -15,7 +16,7 @@ export const registerGetIssueTool = (server) => registerTool(server, {
         summary: z.string().optional(),
         status: z.string().optional(),
         assignee: z.string().optional(),
-        description: z.string().optional(),
+        description: z.string().optional(), // Always markdown (converted from ADF in v3)
     },
     isReadOnly: true,
     async fetcher({ issueIdOrKey, fields, expand }) {
@@ -27,7 +28,7 @@ export const registerGetIssueTool = (server) => registerTool(server, {
             summary: data.fields.summary,
             status: data.fields.status?.name,
             assignee: data.fields.assignee?.displayName,
-            description: data.fields.description,
+            description: adfToMd(data.fields.description), // Convert ADF to Markdown
         };
     },
 });

package/dist/tools/get-issue.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-issue.js","sourceRoot":"","sources":["../../src/tools/get-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAIjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACxD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kDAAkD;IAC/D,WAAW,EAAE;QACX,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACjE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACzG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAChG;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;QAC5C,OAAO,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI;YAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW;YAC3C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACrC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"get-issue.js","sourceRoot":"","sources":["../../src/tools/get-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAIjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACxD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,kDAAkD;IAC/D,WAAW,EAAE;QACX,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACjE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACzG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAChG;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,6CAA6C;KAClF;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;QAC5C,OAAO,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI;YAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW;YAC3C,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,0BAA0B;SAC1E,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/update-issue.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerUpdateIssueTool: (server: McpServer) => void;
+//# sourceMappingURL=update-issue.d.ts.map

package/dist/tools/update-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-issue.d.ts","sourceRoot":"","sources":["../../src/tools/update-issue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,SAuCrD,CAAA"}

package/dist/tools/update-issue.js

@@ -0,0 +1,43 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getJiraBaseUrl } from '../lib/jira-env.js';
+import { updateIssue } from '../lib/jira.service.js';
+export const registerUpdateIssueTool = (server) => registerTool(server, {
+    name: 'update-issue',
+    title: 'Update Jira Issue',
+    description: 'Update fields of an existing Jira issue. Only provided fields will be updated, others remain unchanged.',
+    inputSchema: {
+        issueIdOrKey: z.string().describe('Issue key or ID (e.g., "PROJ-123")'),
+        summary: z.string().optional().describe('New issue title/summary'),
+        description: z
+            .string()
+            .optional()
+            .describe('New description (supports Markdown formatting in API v3, plain text in v2)'),
+        assigneeId: z
+            .string()
+            .optional()
+            .nullable()
+            .describe('Assignee account ID (null to unassign, undefined to leave unchanged)'),
+        priorityId: z.string().optional().describe('New priority ID'),
+        labels: z.array(z.string()).optional().describe('New labels (replaces existing labels)'),
+    },
+    outputSchema: {
+        success: z.boolean(),
+        issueKey: z.string(),
+        url: z.string(),
+    },
+    isReadOnly: false,
+    async fetcher(params) {
+        const { issueIdOrKey, ...updates } = params;
+        await updateIssue(issueIdOrKey, updates);
+        return { issueIdOrKey };
+    },
+    formatter(data) {
+        return {
+            success: true,
+            issueKey: data.issueIdOrKey,
+            url: `${getJiraBaseUrl()}/browse/${data.issueIdOrKey}`,
+        };
+    },
+});
+//# sourceMappingURL=update-issue.js.map

package/dist/tools/update-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-issue.js","sourceRoot":"","sources":["../../src/tools/update-issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAIpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC3D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,yGAAyG;IAC3G,WAAW,EAAE;QACX,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAClE,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4EAA4E,CAAC;QACzF,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,sEAAsE,CAAC;QACnF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC7D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACzF;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,UAAU,EAAE,KAAK;IACjB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAA;QAC3C,MAAM,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,YAAY,EAAE,CAAA;IACzB,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,CAAC,YAAY;YAC3B,GAAG,EAAE,GAAG,cAAc,EAAE,WAAW,IAAI,CAAC,YAAY,EAAE;SACvD,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-monorepo/jira",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "description": "MCP server for Jira tools (JQL, issue management, etc.).",
   "main": "dist/index.js",
@@ -26,6 +26,7 @@
   "dependencies": {
     "@mcp-monorepo/shared": "1.2.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
+    "extended-markdown-adf-parser": "^2.4.0",
     "zod": "^4.2.1"
   },
   "devDependencies": {