---
name: tracker/jira-official:issue-search
description: Search JIRA issues with JQL
version: "0.5.0"
---

# Issue Search

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

Queries JIRA issues using a JQL (JIRA Query Language) string and returns matching results.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| jql | string | Yes | JQL query string |
| max_results | number | No | Maximum number of results to return (default: `10`) |

## Implementation

Uses MCP JIRA tool: `mcp__atlassian__searchJiraIssuesUsingJql`

```
mcp__atlassian__searchJiraIssuesUsingJql({
  jql: "<jql>",
  max_results: <max_results>
})
```

Example JQL queries:

```
project = {PROJECT_KEY} AND status = "In Progress"
project = {PROJECT_KEY} AND labels = "BE" ORDER BY created DESC
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| issues | array | List of matching issue objects |
| issues[].key | string | Issue key |
| issues[].summary | string | Issue summary |
| issues[].status | string | Current status name |
| issues[].issue_type | string | Issue type |
| issues[].assignee | object | Assignee account ID and display name |
| total | number | Total number of issues matching the JQL query |
| max_results | number | The effective result limit applied |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 400 | Invalid JQL syntax | Check field names, operators, and quoting in the JQL string |
| 403 | Insufficient permissions to search the project | Confirm the JIRA user has browse permissions on the project |
| 404 | Referenced project key does not exist | Verify the project key in the JQL query |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (finding existing issues before creating duplicates)
- validate-ci (searching for open bugs related to a failing test)
