jira_transition_issue
Change a Jira issue's status to move it through workflow stages like In Progress or Done.
Instructions
Transition a Jira issue to a different status
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_key | Yes | Issue key (e.g., PROJ-123) | |
| status | Yes | Target status (e.g., In Progress, Done) |
Implementation Reference
- src/jira_server.py:345-372 (handler)Executes the tool logic: retrieves available transitions for the issue, finds the matching one for the target status, performs the transition using the Jira client, and returns success or available statuses message.async def _transition_issue(self, arguments: dict) -> List[TextContent]: """Transition an issue to a different status""" issue_key = arguments["issue_key"] target_status = arguments["status"] # Get available transitions transitions = self.jira_client.get_issue_transitions(issue_key) # Find the transition that matches the target status transition_id = None for transition in transitions["transitions"]: if transition["to"]["name"].lower() == target_status.lower(): transition_id = transition["id"] break if not transition_id: available_statuses = [t["to"]["name"] for t in transitions["transitions"]] return [TextContent( type="text", text=f"Cannot transition to '{target_status}'. Available statuses: {', '.join(available_statuses)}" )] self.jira_client.set_issue_status(issue_key, transition_id) return [TextContent( type="text", text=f"Transitioned issue {issue_key} to status: {target_status}" )]
- src/jira_server.py:163-180 (registration)Registers the 'jira_transition_issue' tool with the MCP server, including its description and input schema defining required parameters: issue_key and status.Tool( name="jira_transition_issue", description="Transition a Jira issue to a different status", inputSchema={ "type": "object", "properties": { "issue_key": { "type": "string", "description": "Issue key (e.g., PROJ-123)" }, "status": { "type": "string", "description": "Target status (e.g., In Progress, Done)" } }, "required": ["issue_key", "status"] } ),
- src/jira_server.py:207-208 (handler)Dispatch logic in the call_tool handler that routes calls to 'jira_transition_issue' to the _transition_issue method.elif name == "jira_transition_issue": return await self._transition_issue(arguments)