transition_issue

Change Jira issue status by executing workflow transitions with optional comments to track progress updates.

Instructions

Change the status of a Jira issue by transitioning it

Input Schema

TableJSON Schema

Name	Required	Description
`issueKey`	Yes	The issue key to transition (e.g., PROJ-123)
`transitionId`	Yes	The transition ID to execute (get from get_transitions)
`comment`	No	Optional comment to add with the transition

Implementation Reference

src/handlers/transition-handlers.ts:38-86 (handler)

The core handler function that executes the tool logic: destructures arguments, validates inputs, constructs transition payload (with optional comment), calls Jira API to perform the transition, and returns success/error response.

async handleTransitionIssue(args: any) {
  try {
    const { issueKey, transitionId, comment } = args;

    if (!issueKey || !transitionId) {
      throw new Error('issueKey and transitionId are required');
    }

    const transitionData: any = {
      transition: {
        id: transitionId,
      },
    };

    // Add comment if provided
    if (comment) {
      transitionData.update = {
        comment: [
          {
            add: {
              body: comment,
            },
          },
        ],
      };
    }

    await this.apiClient.post(`/issue/${issueKey}/transitions`, transitionData);

    return {
      content: [
        {
          type: 'text',
          text: `✅ Issue ${issueKey} transitioned successfully!`,
        },
      ],
    };
  } catch (error: any) {
    return {
      content: [
        {
          type: 'text',
          text: JiraFormatters.formatError(error),
        },
      ],
      isError: true,
    };
  }
}

src/tools/definitions.ts:237-258 (schema)

Tool definition including name, description, and input schema (JSON Schema) for validating tool arguments.

{
  name: 'transition_issue',
  description: 'Change the status of a Jira issue by transitioning it',
  inputSchema: {
    type: 'object',
    properties: {
      issueKey: {
        type: 'string',
        description: 'The issue key to transition (e.g., PROJ-123)',
      },
      transitionId: {
        type: 'string',
        description: 'The transition ID to execute (get from get_transitions)',
      },
      comment: {
        type: 'string',
        description: 'Optional comment to add with the transition',
      },
    },
    required: ['issueKey', 'transitionId'],
  },
},

src/index.ts:130-131 (registration)
Registers the tool handler in the MCP server's switch statement for routing tool calls to the appropriate handler method.
```
case 'transition_issue':
  return this.transitionHandlers.handleTransitionIssue(request.params.arguments);
```

Jira MCP Server