Jira transition issue

jira__transition_issue

Access

Requires a project integration connection for jira.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
cloudIdstringYesAtlassian cloud ID from OAuth accessible resources
issueIdOrKeystringYesJira issue ID or key
transitionobjectYesTransition object with id field, e.g. {"id": "21"}
fieldsobjectNoOptional field updates to apply during the transition
commentstring or objectNoOptional transition comment. Pass plain text or a Jira transition comment object; the API sends it as update.comment[].add.
updateobjectNoJira issue update operations. Plain text transition comments are converted to update.comment[].add.body.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jira__transition_issue",
    "arguments": {
      "cloudId": "example",
      "issueIdOrKey": "example",
      "transition": {}
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the jira integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "cloudId": {
      "type": "string",
      "description": "Atlassian cloud ID from OAuth accessible resources"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Jira issue ID or key"
    },
    "transition": {
      "type": "object",
      "description": "Transition object with id field, e.g. {\"id\": \"21\"}"
    },
    "fields": {
      "type": "object",
      "description": "Optional field updates to apply during the transition"
    },
    "comment": {
      "anyOf": [
        {
          "type": "string",
          "description": "Plain text comment to convert to update.comment[].add.body in Atlassian Document Format."
        },
        {
          "type": "object",
          "description": "Transition comment object. If it has a body field, the body may be plain text or an ADF document."
        }
      ],
      "description": "Optional transition comment. Pass plain text or a Jira transition comment object; the API sends it as update.comment[].add."
    },
    "update": {
      "type": "object",
      "description": "Jira issue update operations. Plain text transition comments are converted to update.comment[].add.body."
    }
  },
  "required": [
    "cloudId",
    "issueIdOrKey",
    "transition"
  ],
  "description": "Arguments for the jira__transition_issue tool."
}