get_transitions
Retrieve available status transitions for a JIRA issue to understand workflow progression options and plan next steps.
Instructions
Get available status transitions for a JIRA issue
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issueKey | Yes | The key of the issue to get transitions for |
Implementation Reference
- src/index.ts:371-384 (handler)MCP tool handler for get_transitions: validates the issueKey parameter and calls the JiraApiService.getTransitions method, returning the JSON-formatted response.
case "get_transitions": { if (!args.issueKey || typeof args.issueKey !== "string") { throw new McpError( ErrorCode.InvalidParams, "Issue key is required", ); } const response = await this.jiraApi.getTransitions(args.issueKey); return { content: [ { type: "text", text: JSON.stringify(response, null, 2) }, ], }; } - src/index.ts:184-198 (schema)Input schema definition for the get_transitions tool, specifying the required issueKey string parameter.
{ name: "get_transitions", description: "Get available status transitions for a JIRA issue", inputSchema: { type: "object", properties: { issueKey: { type: "string", description: "The key of the issue to get transitions for", }, }, required: ["issueKey"], additionalProperties: false, }, }, - src/index.ts:82-266 (registration)Registers all tools including get_transitions by setting the ListToolsRequestSchema handler to return the tools list.
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ { name: "search_issues", description: "Search JIRA issues using JQL", inputSchema: { type: "object", properties: { searchString: { type: "string", description: "JQL search string", }, }, required: ["searchString"], additionalProperties: false, }, }, { name: "get_epic_children", description: "Get all child issues in an epic including their comments", inputSchema: { type: "object", properties: { epicKey: { type: "string", description: "The key of the epic issue", }, }, required: ["epicKey"], additionalProperties: false, }, }, { name: "get_issue", description: "Get detailed information about a specific JIRA issue including comments", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The ID or key of the JIRA issue", }, }, required: ["issueId"], additionalProperties: false, }, }, { name: "create_issue", description: "Create a new JIRA issue", inputSchema: { type: "object", properties: { projectKey: { type: "string", description: "The project key where the issue will be created", }, issueType: { type: "string", description: 'The type of issue to create (e.g., "Bug", "Story", "Task")', }, summary: { type: "string", description: "The issue summary/title", }, description: { type: "string", description: "The issue description", }, fields: { type: "object", description: "Additional fields to set on the issue", additionalProperties: true, }, }, required: ["projectKey", "issueType", "summary"], additionalProperties: false, }, }, { name: "update_issue", description: "Update an existing JIRA issue", inputSchema: { type: "object", properties: { issueKey: { type: "string", description: "The key of the issue to update", }, fields: { type: "object", description: "Fields to update on the issue", additionalProperties: true, }, }, required: ["issueKey", "fields"], additionalProperties: false, }, }, { name: "get_transitions", description: "Get available status transitions for a JIRA issue", inputSchema: { type: "object", properties: { issueKey: { type: "string", description: "The key of the issue to get transitions for", }, }, required: ["issueKey"], additionalProperties: false, }, }, { name: "transition_issue", description: "Change the status of a JIRA issue by performing a transition", inputSchema: { type: "object", properties: { issueKey: { type: "string", description: "The key of the issue to transition", }, transitionId: { type: "string", description: "The ID of the transition to perform", }, comment: { type: "string", description: "Optional comment to add with the transition", }, }, required: ["issueKey", "transitionId"], additionalProperties: false, }, }, { name: "add_attachment", description: "Add a file attachment to a JIRA issue", inputSchema: { type: "object", properties: { issueKey: { type: "string", description: "The key of the issue to add attachment to", }, fileContent: { type: "string", description: "Base64 encoded content of the file", }, filename: { type: "string", description: "Name of the file to be attached", }, }, required: ["issueKey", "fileContent", "filename"], additionalProperties: false, }, }, { name: "add_comment", description: "Add a comment to a JIRA issue", inputSchema: { type: "object", properties: { issueIdOrKey: { type: "string", description: "The ID or key of the issue to add the comment to", }, body: { type: "string", description: "The content of the comment (plain text)", }, }, required: ["issueIdOrKey", "body"], additionalProperties: false, }, }, ], })); - src/services/jira-api.ts:418-425 (helper)Service method that performs the actual REST API call to retrieve available transitions for the given issueKey.
async getTransitions( issueKey: string ): Promise<Array<{ id: string; name: string; to: { name: string } }>> { const data = await this.fetchJson<any>( `/rest/api/3/issue/${issueKey}/transitions` ); return data.transitions; }