Jira
Connects to the Jira Cloud REST API for working with issues across projects. An agent can list, search, create, and transition issues.
Add to an agent node's tools array with _node_type: "tool-jira". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
base_url | Yes | Jira site base URL (e.g. https://myorg.atlassian.net). Trailing slash is stripped. |
email | Yes | Atlassian account email, used for HTTP Basic auth. |
api_token | Yes | Atlassian API token, used for HTTP Basic auth. |
{
"name": "jira",
"_node_type": "tool-jira",
"base_url": "https://myorg.atlassian.net",
"email": "{{ secret.JIRA_EMAIL }}",
"api_token": "{{ secret.JIRA_API_TOKEN }}"
}
Tools
jira_list_issues
List issues in a Jira project.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_key | string | Yes | Jira project key (e.g. ENG) |
status | string | No | Filter by status (e.g. In Progress, To Do) |
max_results | number | No | Max number of issues (default 20) |
Returns: A newline-separated list of - [<key>] <summary> (<status>) lines, ordered by most recently updated, or "No issues found.".
jira_get_issue
Get details of a Jira issue.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key (e.g. ENG-123) |
Returns: A multi-line summary with the issue key, summary, status, assignee, and description text.
jira_create_issue
Create a new Jira issue.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_key | string | Yes | Jira project key |
summary | string | Yes | Issue title/summary |
description | string | No | Issue description |
issue_type | string | No | Issue type: Bug, Task, Story (default: Task) |
Returns: A confirmation message with the new issue's key and summary.
jira_update_status
Move a Jira issue to a different status via transition. Looks up the issue's available transitions and either uses transition_id directly or matches status by name; if neither resolves to a valid transition, returns an error listing the available transitions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key (e.g. ENG-123) |
transition_id | string | No | Transition ID (use jira_search to find available transitions) |
status | string | No | Target status name (e.g. Done, In Progress, To Do) |
Returns: A confirmation message that the issue moved to the resolved transition, or an error listing available transitions if none matched.
jira_search
Search Jira issues using JQL (Jira Query Language).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
jql | string | Yes | JQL query string (e.g. project=ENG AND assignee=currentUser()) |
max_results | number | No | Max results (default 20) |
Returns: A newline-separated list of - [<key>] <summary> (<status>) lines, or "No issues found.".