Jira

Jira MCP Server for Cloudflare Workers

Available Tools

79 tools available in the Jira MCP server. Each tool can be called by AI assistants to perform specific actions.

jira_get_filter

Get details for a specific filter.

Args:

filterId: Filter ID

Returns: Filter details including JQL, owner, and permissions.

{
  "type": "object",
  "required": [
    "filterId"
  ],
  "properties": {
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    }
  }
}

jira_delete_attachment

Delete an attachment.

Args:

attachmentId: Attachment ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "attachmentId"
  ],
  "properties": {
    "attachmentId": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

jira_list_boards

List Jira boards (Scrum, Kanban, Simple).

Args:

startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
type: Board type filter ('scrum', 'kanban', 'simple')
name: Filter by board name (contains)
projectKeyOrId: Filter by project
format: Response format ('json' or 'markdown')

Returns: List of boards with ID, name, type, and project.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Filter by name"
    },
    "type": {
      "enum": [
        "scrum",
        "kanban",
        "simple"
      ],
      "type": "string",
      "description": "Board type"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "projectKeyOrId": {
      "type": "string",
      "description": "Filter by project"
    }
  }
}

jira_get_board

Get details for a specific board.

Args:

boardId: Board ID

Returns: Board details including ID, name, type, and project.

{
  "type": "object",
  "required": [
    "boardId"
  ],
  "properties": {
    "boardId": {
      "type": "integer",
      "description": "Board ID"
    }
  }
}

jira_get_board_issues

Get all issues on a board.

Args:

boardId: Board ID
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
jql: Additional JQL filter (optional)
format: Response format ('json' or 'markdown')

Returns: List of issues on the board.

{
  "type": "object",
  "required": [
    "boardId"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "Additional JQL filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "boardId": {
      "type": "integer",
      "description": "Board ID"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_backlog_issues

Get issues in the backlog (not in any sprint).

Args:

boardId: Board ID
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
jql: Additional JQL filter (optional)
format: Response format ('json' or 'markdown')

Returns: List of backlog issues.

{
  "type": "object",
  "required": [
    "boardId"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "Additional JQL filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "boardId": {
      "type": "integer",
      "description": "Board ID"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_list_sprints

List sprints for a board.

Args:

boardId: Board ID
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
state: Filter by state ('active', 'future', 'closed')
format: Response format ('json' or 'markdown')

Returns: List of sprints with ID, name, state, and dates.

{
  "type": "object",
  "required": [
    "boardId"
  ],
  "properties": {
    "state": {
      "enum": [
        "active",
        "future",
        "closed"
      ],
      "type": "string",
      "description": "Sprint state"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "boardId": {
      "type": "integer",
      "description": "Board ID"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_sprint

Get details for a specific sprint.

Args:

sprintId: Sprint ID

Returns: Sprint details including ID, name, state, goal, and dates.

{
  "type": "object",
  "required": [
    "sprintId"
  ],
  "properties": {
    "sprintId": {
      "type": "integer",
      "description": "Sprint ID"
    }
  }
}

jira_get_sprint_issues

Get issues in a sprint.

Args:

sprintId: Sprint ID
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
jql: Additional JQL filter (optional)
format: Response format ('json' or 'markdown')

Returns: List of issues in the sprint.

{
  "type": "object",
  "required": [
    "sprintId"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "Additional JQL filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "sprintId": {
      "type": "integer",
      "description": "Sprint ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_create_sprint

Create a new sprint.

Args:

name: Sprint name
originBoardId: Board ID for the sprint
startDate: Start date (ISO format, optional)
endDate: End date (ISO format, optional)
goal: Sprint goal (optional)

Returns: The created sprint.

{
  "type": "object",
  "required": [
    "name",
    "originBoardId"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "description": "Sprint goal"
    },
    "name": {
      "type": "string",
      "description": "Sprint name"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date"
    },
    "originBoardId": {
      "type": "integer",
      "description": "Board ID"
    }
  }
}

jira_update_sprint

Update a sprint.

Args:

sprintId: Sprint ID
name: New name (optional)
state: New state ('future', 'active', 'closed') (optional)
startDate: New start date (optional)
endDate: New end date (optional)
goal: New goal (optional)

Returns: The updated sprint.

{
  "type": "object",
  "required": [
    "sprintId"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "description": "New goal"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "state": {
      "enum": [
        "future",
        "active",
        "closed"
      ],
      "type": "string",
      "description": "New state"
    },
    "endDate": {
      "type": "string",
      "description": "New end date"
    },
    "sprintId": {
      "type": "integer",
      "description": "Sprint ID"
    },
    "startDate": {
      "type": "string",
      "description": "New start date"
    }
  }
}

jira_delete_sprint

Delete a sprint.

Args:

sprintId: Sprint ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "sprintId"
  ],
  "properties": {
    "sprintId": {
      "type": "integer",
      "description": "Sprint ID"
    }
  }
}

jira_move_issues_to_sprint

Move issues to a sprint.

Args:

sprintId: Target sprint ID
issueKeys: Comma-separated issue keys (e.g., "PROJ-1,PROJ-2")

Returns: Confirmation of move.

{
  "type": "object",
  "required": [
    "sprintId",
    "issueKeys"
  ],
  "properties": {
    "sprintId": {
      "type": "integer",
      "description": "Sprint ID"
    },
    "issueKeys": {
      "type": "string",
      "description": "Comma-separated issue keys"
    }
  }
}

jira_move_issues_to_backlog

Move issues to the backlog (remove from sprint).

Args:

issueKeys: Comma-separated issue keys

Returns: Confirmation of move.

{
  "type": "object",
  "required": [
    "issueKeys"
  ],
  "properties": {
    "issueKeys": {
      "type": "string",
      "description": "Comma-separated issue keys"
    }
  }
}

jira_list_epics

List epics for a board.

Args:

boardId: Board ID
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of epics with ID, key, name, and status.

{
  "type": "object",
  "required": [
    "boardId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "boardId": {
      "type": "integer",
      "description": "Board ID"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_epic

Get details for a specific epic.

Args:

epicIdOrKey: Epic ID or key

Returns: Epic details including ID, key, name, summary, and status.

{
  "type": "object",
  "required": [
    "epicIdOrKey"
  ],
  "properties": {
    "epicIdOrKey": {
      "type": "string",
      "description": "Epic ID or key"
    }
  }
}

jira_get_epic_issues

Get issues belonging to an epic.

Args:

epicIdOrKey: Epic ID or key
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
jql: Additional JQL filter (optional)
format: Response format ('json' or 'markdown')

Returns: List of issues in the epic.

{
  "type": "object",
  "required": [
    "epicIdOrKey"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "Additional JQL filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "epicIdOrKey": {
      "type": "string",
      "description": "Epic ID or key"
    }
  }
}

jira_move_issues_to_epic

Move issues to an epic.

Args:

epicIdOrKey: Target epic ID or key
issueKeys: Comma-separated issue keys

Returns: Confirmation of move.

{
  "type": "object",
  "required": [
    "epicIdOrKey",
    "issueKeys"
  ],
  "properties": {
    "issueKeys": {
      "type": "string",
      "description": "Comma-separated issue keys"
    },
    "epicIdOrKey": {
      "type": "string",
      "description": "Epic ID or key"
    }
  }
}

jira_remove_issues_from_epic

Remove issues from their epic.

Args:

issueKeys: Comma-separated issue keys

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "issueKeys"
  ],
  "properties": {
    "issueKeys": {
      "type": "string",
      "description": "Comma-separated issue keys"
    }
  }
}

jira_get_comments

Get comments on an issue.

Args:

issueIdOrKey: Issue ID or key
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of comments with author, body, and timestamps.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_add_comment

Add a comment to an issue.

Args:

issueIdOrKey: Issue ID or key
body: Comment body text

Returns: The created comment.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Comment body"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_update_comment

Update an existing comment.

Args:

issueIdOrKey: Issue ID or key
commentId: Comment ID to update
body: New comment body

Returns: The updated comment.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "commentId",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "New comment body"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_delete_comment

Delete a comment from an issue.

Args:

issueIdOrKey: Issue ID or key
commentId: Comment ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "commentId"
  ],
  "properties": {
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_get_worklogs

Get work logs for an issue.

Args:

issueIdOrKey: Issue ID or key
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of worklogs with author, time spent, and comments.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_add_worklog

Add a work log entry to an issue.

Args:

issueIdOrKey: Issue ID or key
timeSpent: Time spent (e.g., "2h 30m", "1d")
started: Start time in ISO format (optional, defaults to now)
comment: Work log comment (optional)

Returns: The created worklog.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "timeSpent"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "description": "Worklog comment"
    },
    "started": {
      "type": "string",
      "description": "Start time (ISO format)"
    },
    "timeSpent": {
      "type": "string",
      "description": "Time spent (e.g., \"2h 30m"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_update_worklog

Update an existing work log entry.

Args:

issueIdOrKey: Issue ID or key
worklogId: Worklog ID to update
timeSpent: New time spent (optional)
started: New start time (optional)
comment: New comment (optional)

Returns: The updated worklog.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "worklogId"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "description": "New comment"
    },
    "started": {
      "type": "string",
      "description": "New start time"
    },
    "timeSpent": {
      "type": "string",
      "description": "New time spent"
    },
    "worklogId": {
      "type": "string",
      "description": "Worklog ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_delete_worklog

Delete a work log entry.

Args:

issueIdOrKey: Issue ID or key
worklogId: Worklog ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "worklogId"
  ],
  "properties": {
    "worklogId": {
      "type": "string",
      "description": "Worklog ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_get_my_filters

Get filters owned by the current user.

Args:

expand: Comma-separated fields to expand (e.g., "description,jql")

Returns: List of filters with ID, name, JQL, and owner.

{
  "type": "object",
  "properties": {
    "expand": {
      "type": "string",
      "description": "Fields to expand"
    }
  }
}

jira_get_favourite_filters

Get filters marked as favourite.

Returns: List of favourite filters.

{
  "type": "object",
  "properties": {}
}

jira_create_filter

Create a new filter (saved search).

Args:

name: Filter name
jql: JQL query string
description: Filter description (optional)
favourite: Mark as favourite (optional)

Returns: The created filter.

{
  "type": "object",
  "required": [
    "name",
    "jql"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "JQL query"
    },
    "name": {
      "type": "string",
      "description": "Filter name"
    },
    "favourite": {
      "type": "boolean",
      "description": "Mark as favourite"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

jira_update_filter

Update an existing filter.

Args:

filterId: Filter ID
name: New name (optional)
jql: New JQL query (optional)
description: New description (optional)
favourite: Mark as favourite (optional)

Returns: The updated filter.

{
  "type": "object",
  "required": [
    "filterId"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "New JQL"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    },
    "favourite": {
      "type": "boolean",
      "description": "Mark as favourite"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

jira_delete_filter

Delete a filter.

Args:

filterId: Filter ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "filterId"
  ],
  "properties": {
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    }
  }
}

jira_list_dashboards

List Jira dashboards.

Args:

startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
filter: Filter type ('favourite', 'my')
format: Response format ('json' or 'markdown')

Returns: List of dashboards with ID, name, and owner.

{
  "type": "object",
  "properties": {
    "filter": {
      "enum": [
        "favourite",
        "my"
      ],
      "type": "string",
      "description": "Filter type"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_dashboard

Get details for a specific dashboard.

Args:

dashboardId: Dashboard ID

Returns: Dashboard details including name, owner, and permissions.

{
  "type": "object",
  "required": [
    "dashboardId"
  ],
  "properties": {
    "dashboardId": {
      "type": "string",
      "description": "Dashboard ID"
    }
  }
}

jira_search_issues

Search for Jira issues using JQL (Jira Query Language).

Args:

jql: JQL query string (e.g., "project = PROJ AND status = Open")
startAt: Starting index for pagination (default: 0)
maxResults: Maximum results to return (default: 50, max: 100)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of matching issues with their details.

{
  "type": "object",
  "required": [
    "jql"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "JQL query string"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated fields to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Starting index"
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Max results"
    }
  }
}

jira_get_issue

Get detailed information about a specific Jira issue.

Args:

issueIdOrKey: Issue ID or key (e.g., "PROJ-123")
fields: Comma-separated list of fields to return
expand: Comma-separated list of fields to expand (e.g., "changelog,comments")
format: Response format ('json' or 'markdown')

Returns: Complete issue details including summary, description, status, assignee, etc.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "expand": {
      "type": "string",
      "description": "Fields to expand"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_create_issue

Create a new Jira issue.

Args:

projectKey: Project key (e.g., "PROJ")
issueType: Issue type name (e.g., "Bug", "Story", "Task")
summary: Issue summary/title
description: Issue description (optional)
priority: Priority name (e.g., "High", "Medium", "Low") (optional)
assigneeId: Account ID of assignee (optional)
labels: Comma-separated labels (optional)
components: Comma-separated component names (optional)
fixVersions: Comma-separated version names (optional)
dueDate: Due date in YYYY-MM-DD format (optional)
parentKey: Parent issue key for subtasks (optional)

Returns: Created issue with ID, key, and self URL.

{
  "type": "object",
  "required": [
    "projectKey",
    "issueType",
    "summary"
  ],
  "properties": {
    "labels": {
      "type": "string",
      "description": "Comma-separated labels"
    },
    "dueDate": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "summary": {
      "type": "string",
      "description": "Issue summary"
    },
    "priority": {
      "type": "string",
      "description": "Priority name"
    },
    "issueType": {
      "type": "string",
      "description": "Issue type name"
    },
    "parentKey": {
      "type": "string",
      "description": "Parent issue key"
    },
    "assigneeId": {
      "type": "string",
      "description": "Assignee account ID"
    },
    "components": {
      "type": "string",
      "description": "Comma-separated components"
    },
    "projectKey": {
      "type": "string",
      "description": "Project key"
    },
    "description": {
      "type": "string",
      "description": "Issue description"
    },
    "fixVersions": {
      "type": "string",
      "description": "Comma-separated versions"
    }
  }
}

jira_update_issue

Update an existing Jira issue.

Args:

issueIdOrKey: Issue ID or key to update
summary: New summary (optional)
description: New description (optional)
priority: New priority name (optional)
assigneeId: New assignee account ID (optional, use empty string to unassign)
labels: New labels (comma-separated, replaces existing) (optional)
components: New components (comma-separated, replaces existing) (optional)
fixVersions: New fix versions (comma-separated, replaces existing) (optional)
dueDate: New due date (YYYY-MM-DD) (optional)

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "labels": {
      "type": "string",
      "description": "New labels (comma-separated)"
    },
    "dueDate": {
      "type": "string",
      "description": "New due date"
    },
    "summary": {
      "type": "string",
      "description": "New summary"
    },
    "priority": {
      "type": "string",
      "description": "New priority"
    },
    "assigneeId": {
      "type": "string",
      "description": "New assignee ID"
    },
    "components": {
      "type": "string",
      "description": "New components"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "fixVersions": {
      "type": "string",
      "description": "New fix versions"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_delete_issue

Delete a Jira issue.

Args:

issueIdOrKey: Issue ID or key to delete
deleteSubtasks: Whether to delete subtasks (default: false)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    },
    "deleteSubtasks": {
      "type": "boolean",
      "default": false,
      "description": "Delete subtasks"
    }
  }
}

jira_assign_issue

Assign or unassign a Jira issue.

Args:

issueIdOrKey: Issue ID or key
accountId: Account ID of assignee (use empty string to unassign)

Returns: Confirmation of assignment.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "Assignee account ID (empty to unassign)"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_get_transitions

Get available transitions for an issue.

Args:

issueIdOrKey: Issue ID or key

Returns: List of available transitions with IDs and target statuses.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_transition_issue

Transition an issue to a new status.

Args:

issueIdOrKey: Issue ID or key
transitionId: Transition ID (get from jira_get_transitions)
comment: Optional comment to add with transition
resolution: Optional resolution name (e.g., "Done", "Fixed")

Returns: Confirmation of transition.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "transitionId"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "description": "Comment to add"
    },
    "resolution": {
      "type": "string",
      "description": "Resolution name"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    },
    "transitionId": {
      "type": "string",
      "description": "Transition ID"
    }
  }
}

jira_get_changelog

Get the changelog (history) for an issue.

Args:

issueIdOrKey: Issue ID or key
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of changes with author, date, and field changes.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_get_issue_types

Get all issue types available in the Jira instance.

Returns: List of issue types with ID, name, description, and subtask flag.

{
  "type": "object",
  "properties": {}
}

jira_get_project_issue_types

Get issue types available for a specific project.

Args:

projectIdOrKey: Project ID or key

Returns: List of issue types available in the project.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_get_priorities

Get all issue priorities.

Returns: List of priorities with ID, name, and description.

{
  "type": "object",
  "properties": {}
}

jira_get_statuses

Get all issue statuses.

Returns: List of statuses with ID, name, and category.

{
  "type": "object",
  "properties": {}
}

jira_get_project_statuses

Get statuses available for a specific project.

Args:

projectIdOrKey: Project ID or key

Returns: List of statuses available in the project.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_get_resolutions

Get all issue resolutions.

Returns: List of resolutions with ID, name, and description.

{
  "type": "object",
  "properties": {}
}

jira_get_fields

Get all fields (system and custom) available in Jira.

Returns: List of fields with ID, name, type, and whether custom.

{
  "type": "object",
  "properties": {}
}

jira_get_issue_link_types

Get all issue link types.

Returns: List of link types with ID, name, and inward/outward descriptions.

{
  "type": "object",
  "properties": {}
}

jira_create_issue_link

Create a link between two issues.

Args:

type: Link type name (e.g., "Blocks", "Relates to")
inwardIssueKey: Inward issue key
outwardIssueKey: Outward issue key
comment: Comment to add with the link (optional)

Returns: Confirmation of link creation.

{
  "type": "object",
  "required": [
    "type",
    "inwardIssueKey",
    "outwardIssueKey"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Link type name"
    },
    "comment": {
      "type": "string",
      "description": "Comment"
    },
    "inwardIssueKey": {
      "type": "string",
      "description": "Inward issue key"
    },
    "outwardIssueKey": {
      "type": "string",
      "description": "Outward issue key"
    }
  }
}

jira_delete_issue_link

Delete an issue link.

Args:

linkId: Link ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "linkId"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "description": "Link ID"
    }
  }
}

jira_get_labels

Get all labels used in Jira.

Args:

startAt: Starting index (default: 0)
maxResults: Maximum results (default: 100)

Returns: List of label strings.

{
  "type": "object",
  "properties": {
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1
    }
  }
}

jira_get_server_info

Get Jira server information.

Returns: Server info including base URL, version, and title.

{
  "type": "object",
  "properties": {}
}

jira_get_project_roles

Get roles available in a project.

Args:

projectIdOrKey: Project ID or key

Returns: Map of role names to their URLs.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_get_user

Get details for a specific user.

Args:

accountId: User account ID

Returns: User details including display name, email, and status.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "User account ID"
    }
  }
}

jira_list_projects

List Jira projects.

Args:

startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
searchQuery: Search query to filter projects
typeKey: Filter by project type (e.g., "software", "business")
orderBy: Order by field (e.g., "name", "-key" for descending)
format: Response format ('json' or 'markdown')

Returns: List of projects with key, name, type, and lead.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderBy": {
      "type": "string",
      "description": "Order by field"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "typeKey": {
      "type": "string",
      "description": "Project type"
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "searchQuery": {
      "type": "string",
      "description": "Search query"
    }
  }
}

jira_get_project

Get details for a specific project.

Args:

projectIdOrKey: Project ID or key
expand: Comma-separated fields to expand (e.g., "lead,description")
format: Response format ('json' or 'markdown')

Returns: Project details including key, name, description, lead, etc.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "expand": {
      "type": "string",
      "description": "Fields to expand"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_create_project

Create a new Jira project.

Args:

key: Project key (e.g., "PROJ")
name: Project name
projectTypeKey: Project type (e.g., "software", "business")
description: Project description (optional)
leadAccountId: Lead user account ID (optional)
assigneeType: Default assignee type ("PROJECT_LEAD" or "UNASSIGNED")

Returns: The created project.

{
  "type": "object",
  "required": [
    "key",
    "name",
    "projectTypeKey"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Project key"
    },
    "name": {
      "type": "string",
      "description": "Project name"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "assigneeType": {
      "enum": [
        "PROJECT_LEAD",
        "UNASSIGNED"
      ],
      "type": "string"
    },
    "leadAccountId": {
      "type": "string",
      "description": "Lead account ID"
    },
    "projectTypeKey": {
      "type": "string",
      "description": "Project type"
    }
  }
}

jira_update_project

Update an existing project.

Args:

projectIdOrKey: Project ID or key
key: New project key (optional)
name: New project name (optional)
description: New description (optional)
leadAccountId: New lead account ID (optional)
assigneeType: New default assignee type (optional)

Returns: The updated project.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "New key"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "assigneeType": {
      "enum": [
        "PROJECT_LEAD",
        "UNASSIGNED"
      ],
      "type": "string"
    },
    "leadAccountId": {
      "type": "string",
      "description": "New lead"
    },
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_delete_project

Delete a project.

Args:

projectIdOrKey: Project ID or key

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_get_project_components

Get components for a project.

Args:

projectIdOrKey: Project ID or key

Returns: List of components with name, description, and lead.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_create_component

Create a component in a project.

Args:

project: Project key
name: Component name
description: Component description (optional)
leadAccountId: Lead account ID (optional)

Returns: The created component.

{
  "type": "object",
  "required": [
    "project",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Component name"
    },
    "project": {
      "type": "string",
      "description": "Project key"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "leadAccountId": {
      "type": "string",
      "description": "Lead account ID"
    }
  }
}

jira_delete_component

Delete a component.

Args:

componentId: Component ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "componentId"
  ],
  "properties": {
    "componentId": {
      "type": "string",
      "description": "Component ID"
    }
  }
}

jira_get_project_versions

Get versions (releases) for a project.

Args:

projectIdOrKey: Project ID or key
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of versions with name, release date, and status.

{
  "type": "object",
  "required": [
    "projectIdOrKey"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "projectIdOrKey": {
      "type": "string",
      "description": "Project ID or key"
    }
  }
}

jira_create_version

Create a version (release) in a project.

Args:

projectId: Project numeric ID
name: Version name
description: Version description (optional)
startDate: Start date (YYYY-MM-DD) (optional)
releaseDate: Release date (YYYY-MM-DD) (optional)
released: Whether already released (optional)
archived: Whether archived (optional)

Returns: The created version.

{
  "type": "object",
  "required": [
    "projectId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Version name"
    },
    "archived": {
      "type": "boolean",
      "description": "Archived"
    },
    "released": {
      "type": "boolean",
      "description": "Already released"
    },
    "projectId": {
      "type": "integer",
      "description": "Project ID"
    },
    "startDate": {
      "type": "string",
      "description": "Start date"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "releaseDate": {
      "type": "string",
      "description": "Release date"
    }
  }
}

jira_release_version

Release a version (mark as released).

Args:

versionId: Version ID

Returns: Confirmation of release.

{
  "type": "object",
  "required": [
    "versionId"
  ],
  "properties": {
    "versionId": {
      "type": "string",
      "description": "Version ID"
    }
  }
}

jira_delete_version

Delete a version.

Args:

versionId: Version ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "versionId"
  ],
  "properties": {
    "versionId": {
      "type": "string",
      "description": "Version ID"
    }
  }
}

jira_search_users

Search for users.

Args:

query: Search query (name or email)
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of matching users.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_find_assignable_users

Find users who can be assigned to issues.

Args:

projectKey: Project key (optional, provide this or issueKey)
issueKey: Issue key (optional, provide this or projectKey)
query: Search query to filter users (optional)
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of assignable users.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "issueKey": {
      "type": "string",
      "description": "Issue key"
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "projectKey": {
      "type": "string",
      "description": "Project key"
    }
  }
}

jira_list_groups

List Jira groups.

Args:

query: Filter by group name (optional)
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of groups.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Filter by name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_group_members

Get members of a group.

Args:

groupName: Group name
startAt: Starting index (default: 0)
maxResults: Maximum results (default: 50)
format: Response format ('json' or 'markdown')

Returns: List of users in the group.

{
  "type": "object",
  "required": [
    "groupName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "startAt": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "groupName": {
      "type": "string",
      "description": "Group name"
    },
    "maxResults": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    }
  }
}

jira_get_watchers

Get watchers of an issue.

Args:

issueIdOrKey: Issue ID or key

Returns: Watch count and list of watchers.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_add_watcher

Add a watcher to an issue.

Args:

issueIdOrKey: Issue ID or key
accountId: User account ID to add as watcher

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "User account ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_remove_watcher

Remove a watcher from an issue.

Args:

issueIdOrKey: Issue ID or key
accountId: User account ID to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "issueIdOrKey",
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "User account ID"
    },
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_get_votes

Get votes on an issue.

Args:

issueIdOrKey: Issue ID or key

Returns: Vote count and list of voters.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_add_vote

Vote for an issue.

Args:

issueIdOrKey: Issue ID or key

Returns: Confirmation of vote.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}

jira_remove_vote

Remove vote from an issue.

Args:

issueIdOrKey: Issue ID or key

Returns: Confirmation of vote removal.

{
  "type": "object",
  "required": [
    "issueIdOrKey"
  ],
  "properties": {
    "issueIdOrKey": {
      "type": "string",
      "description": "Issue ID or key"
    }
  }
}