Jira

Issue tracking and project management via Atlassian Cloud

OAuth9 toolshttps://api.atlassian.com/ex/jira/{cloudId}/rest/api/3

POST

jira_search_issues

Search for issues using JQL (Jira Query Language)

/search/jql

4 parameters

Param	Type	Required	Description
jql	string	required	JQL query, e.g. 'project = ENG AND status = "In Progress"'
maxResults	integer	optional	Max issues to return (default 50, max 100)
fields	array	optional	Issue fields to include, e.g. ['summary','status','assignee']
nextPageToken	string	optional	Pagination token from a previous response

GET

jira_get_issue

Get a single issue by ID or key (e.g. 'ENG-123')

/issue/{issue_id_or_key}

2 parameters

Param	Type	Required	Description
issue_id_or_key	string	required	Issue ID or key, e.g. 'ENG-123'
fields	string	optional	Comma-separated field names to include, e.g. 'summary,status,assignee'

POST

jira_create_issue

Create a new issue in a project

/issue

1 parameter

Param	Type	Required	Description
fields	object	required	Jira issue fields object, e.g. { project: { key: 'ENG' }, issuetype: { name: 'Task' }, summary: 'Fix the bug', description: <ADF doc>, assignee: { accountId: '...' }, priority: { name: 'High' }, labels: ['backend'] }. project/issuetype/summary are required by Jira. Atlassian Document Format (ADF) object, e.g. { type: "doc", version: 1, content: [{ type: "paragraph", content: [{ type: "text", text: "..." }] }] }

PUT

jira_update_issue

Update fields on an existing issue (does not change status — use transition_issue)

/issue/{issue_id_or_key}

2 parameters

Param	Type	Required	Description
issue_id_or_key	string	required	Issue ID or key to update
fields	object	required	Jira issue fields to update, e.g. { summary: 'New title', assignee: { accountId: '...' }, priority: { name: 'Low' }, labels: ['backend'] }. Atlassian Document Format (ADF) object, e.g. { type: "doc", version: 1, content: [{ type: "paragraph", content: [{ type: "text", text: "..." }] }] }

POST

jira_add_comment

Add a comment to an issue

/issue/{issue_id_or_key}/comment

2 parameters

Param	Type	Required	Description
issue_id_or_key	string	required	Issue ID or key to comment on
body	object	required	Atlassian Document Format (ADF) object, e.g. { type: "doc", version: 1, content: [{ type: "paragraph", content: [{ type: "text", text: "..." }] }] }

GET

jira_list_projects

List Jira projects visible to the connected account

/project/search

3 parameters

Param	Type	Required	Description
query	string	optional	Filter projects by name or key substring
maxResults	integer	optional	Max projects to return (default 50, max 100)
startAt	integer	optional	Zero-based pagination offset

GET

jira_get_project

Get a single project by ID or key

/project/{project_id_or_key}

1 parameter

Param	Type	Required	Description
project_id_or_key	string	required	Project ID or key, e.g. 'ENG'

GET

jira_list_transitions

List the workflow status transitions currently available for an issue

/issue/{issue_id_or_key}/transitions

1 parameter

Param	Type	Required	Description
issue_id_or_key	string	required	Issue ID or key

POST

jira_transition_issue

Move an issue to a new status via a workflow transition ID (get valid IDs from list_transitions)

/issue/{issue_id_or_key}/transitions

2 parameters

Param	Type	Required	Description
issue_id_or_key	string	required	Issue ID or key
transition	object	required	Transition object, e.g. { id: '31' } — ID from list_transitions