@mcp-monorepo/jira 1.2.0 → 1.4.0

package/dist/lib/jira.service.js

@@ -1,10 +1,22 @@
-import { getJiraBaseUrl, getJiraToken } 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') {
+        return { Authorization: `Bearer ${auth.value}` };
+    }
+    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(), {
         ...options,
         headers: {
-            Authorization: `Bearer ${getJiraToken()}`,
+            ...buildAuthHeaders(),
             Accept: 'application/json',
             'Content-Type': 'application/json',
             ...options.headers,
@@ -12,9 +24,29 @@ 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);
     }
-    // Handle cases like 204 No Content
     if (response.status === 204) {
         return undefined;
     }
@@ -26,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),
     });
@@ -58,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"}