---
name: tracker/jira-official:issue-read
description: Read JIRA issue details
version: "0.5.0"
---

# Issue Read

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

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

Retrieves all fields and metadata for a single JIRA issue by its key.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| issue_key | string | Yes | JIRA issue key (e.g., `<PROJECT_KEY>-123`) |

## Implementation

Uses MCP JIRA tool: `mcp__atlassian__getJiraIssue`

```
mcp__atlassian__getJiraIssue({
  issue_key: "<issue_key>"
})
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| key | string | Issue key |
| summary | string | Issue title |
| description | string | Issue description |
| status | string | Current status name |
| issue_type | string | Issue type (Story, Task, Bug, Epic, etc.) |
| assignee | object | Assignee account ID and display name |
| reporter | object | Reporter account ID and display name |
| labels | array | List of label strings |
| priority | string | Priority name |
| created | string | ISO 8601 creation timestamp |
| updated | string | ISO 8601 last-updated timestamp |
| parent | object | Parent issue key and summary (if applicable) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Issue key not found | Verify the issue key and project key are correct |
| 403 | Insufficient permissions to view the issue | Confirm the JIRA user has browse permissions on the project |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- dev-task (reading issue details before beginning work)
- design-feature (reviewing existing issue state during planning)
- validate-ci (reading issue context when triaging CI failures)
