---
title: "Jira MCP"
description: "Reference for the Tracecat Jira MCP integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## Add comment to issue

Action ID: `tools.jira.add_issue_comment`

Add a comment to an issue in Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-post](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-post)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="comment" type="string" required>

Comment to add to the issue.

</ParamField>

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to add a comment to.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

## Assign issue

Action ID: `tools.jira.assign_issue`

Assign an issue to a user.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-assignee-put](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-assignee-put)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="issue_key" type="string" required>

Jira issue key (e.g. TC-123)

</ParamField>

<ParamField path="user_id" type="string" required>

Jira user ID (e.g. 1234567890)

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

## Create issue

Action ID: `tools.jira.create_issue`

Create a new issue in Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="description" type="string" required>

Detailed description of the incident.

</ParamField>

<ParamField path="issue_type_id" type="string" required>

Jira issue type ID.

</ParamField>

<ParamField path="priority_id" type="string" required>

Priority ID. Must be one of the priorities in the priority scheme.

</ParamField>

<ParamField path="project_id" type="string" required>

Jira project ID.

</ParamField>

<ParamField path="summary" type="string" required>

Brief one-line summary of the incident.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

<ParamField path="fields" type="array[object]">

List of fields to add to the issue. Each field is an object with the following keys: - `key`: The Jira custom field ID. - `value`: The field value.
For example: ``` [
  &#123;"key": "customfield_10000", "value": "New value"&#125;,
  &#123;"key": "customfield_10001", "value": "Another value"&#125;
] ```

Default: `[]`.

</ParamField>

<ParamField path="tags" type="array[string]">

Tags to categorize the incident. Added as Jira labels.

Default: `[]`.

</ParamField>

## Get fields

Action ID: `tools.jira.get_fields`

Get a list of fields from Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-group-issue-fields](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-group-issue-fields)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

## Get issue

Action ID: `tools.jira.get_issue`

Get an issue from Jira by ID or key.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to get.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

<ParamField path="fields" type="string">

A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list of strings. Expand options include: *all, *navigable, summary, comment,-description, -comment (defaults to *all).

Default: `"*all"`.

</ParamField>

## Get priorities by scheme

Action ID: `tools.jira.get_priorities`

Get a list of priorities from Jira for a given priority scheme.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-schemeid-priorities-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-schemeid-priorities-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="priority_scheme_id" type="string" required>

Jira priority scheme ID.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

<ParamField path="limit" type="integer">

Maximum number of priorities to return.

Default: `50`.

</ParamField>

## Get priority schemes

Action ID: `tools.jira.get_priority_schemes`

Get a list of priority schemes from Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

<ParamField path="limit" type="integer">

Maximum number of priority schemes to return.

Default: `50`.

</ParamField>

## Get projects

Action ID: `tools.jira.get_projects`

Get a list of projects from Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

<ParamField path="limit" type="integer">

Maximum number of projects to return.

Default: `50`.

</ParamField>

## Get transitions

Action ID: `tools.jira.get_transitions`

Get a list of available transitions for an issue.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to get transitions for.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

## Get user ID

Action ID: `tools.jira.get_user_id`

Get a user ID from Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search/#api-rest-api-3-user-search-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search/#api-rest-api-3-user-search-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="username" type="string" required>

Jira username (e.g. john.doe@example.com)

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

## Jira MCP

Action ID: `tools.jira.mcp`

Use AI to interact with Jira through Atlassian's remote MCP server.

Reference: [https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/](https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/)

### Secrets

Required secrets:

- `jira_mcp_oauth`: OAuth token `JIRA_MCP_USER_TOKEN`.

Optional secrets:

- `anthropic`: optional values `ANTHROPIC_API_KEY`.
- `openai`: optional values `OPENAI_API_KEY`.
- `gemini`: optional values `GEMINI_API_KEY`.
- `amazon_bedrock`: optional values `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`, `AWS_ROLE_ARN`, `AWS_ROLE_SESSION_NAME`, `AWS_SESSION_TOKEN`, `AWS_BEARER_TOKEN_BEDROCK`, `AWS_MODEL_ID`, `AWS_INFERENCE_PROFILE_ID`.
- `custom-model-provider`: optional values `CUSTOM_MODEL_PROVIDER_API_KEY`, `CUSTOM_MODEL_PROVIDER_MODEL_NAME`, `CUSTOM_MODEL_PROVIDER_BASE_URL`.
- `azure_openai`: optional values `AZURE_API_BASE`, `AZURE_API_VERSION`, `AZURE_DEPLOYMENT_NAME`, `AZURE_API_KEY`, `AZURE_AD_TOKEN`, `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`.
- `azure_ai`: optional values `AZURE_API_BASE`, `AZURE_API_KEY`, `AZURE_AD_TOKEN`, `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_API_VERSION`, `AZURE_AI_MODEL_NAME`.
- `litellm`: required values `LITELLM_BASE_URL`.

### Input fields

<ParamField path="instructions" type="string" required>

Instructions for the agent.

</ParamField>

<ParamField path="model" type="ModelSelection" required>

Model to use. Pick from the list of models enabled for this workspace.

</ParamField>

<ParamField path="user_prompt" type="string" required>

User prompt to the agent.

</ParamField>

## Search issues

Action ID: `tools.jira.search_issues`

Search for issues in Jira using JQL.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-get)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="jql" type="string" required>

JQL query to search for issues.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net)

Default: `null`.

</ParamField>

<ParamField path="fields" type="string">

A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list. Expand options include: *all, *navigable, summary, comment, -description, -comment (defaults to id).

Default: `"id"`.

</ParamField>

<ParamField path="max_results" type="integer">

Maximum number of results to return.

Default: `100`.

</ParamField>

<ParamField path="next_page" type="string">

Next page token to get the next page of results. If not provided, the first page of results will be returned.

Default: `null`.

</ParamField>

## Update issue description

Action ID: `tools.jira.update_issue_description`

Update the description of an existing issue in Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="description" type="string" required>

Updated description of the incident.

</ParamField>

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to update.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

## Update issue fields

Action ID: `tools.jira.update_issue_fields`

Update the fields of an existing issue in Jira.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="fields" type="array[object]" required>

List of fields to update in the issue.
For example usage: ``` [
  &#123;"customfield_10000": "New value"&#125;,
  &#123;"customfield_10001": ["Another value"]&#125;
] ```

</ParamField>

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to update.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

## Update issue status

Action ID: `tools.jira.update_issue_status`

Update the status of an issue.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-post](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-post)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="issue_id_or_key" type="string" required>

ID or key of the issue to update.

</ParamField>

<ParamField path="transition_id" type="string" required>

ID of the transition to perform.

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>

## Upload attachment

Action ID: `tools.jira.upload_attachment`

Upload an attachment to a Jira issue.

Reference: [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/#api-rest-api-3-issue-issueidorkey-attachments-post](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/#api-rest-api-3-issue-issueidorkey-attachments-post)

### Secrets

Required secrets:

- `jira`: required values `JIRA_USEREMAIL`, `JIRA_API_TOKEN`.

### Input fields

<ParamField path="base64_content" type="string" required>

Base64 encoded content of the file to upload.

</ParamField>

<ParamField path="content_type" type="string" required>

MIME type of the file (e.g., "application/pdf", "image/png", "text/plain").

</ParamField>

<ParamField path="filename" type="string" required>

Name of the file to upload.

</ParamField>

<ParamField path="ticket" type="string" required>

Jira issue key or ID to upload the attachment to (e.g., "PROJ-123").

</ParamField>

<ParamField path="base_url" type="string | null">

Jira tenant URL (e.g. https://your-domain.atlassian.net).

Default: `null`.

</ParamField>
