---
name: tracker/jira-official:epic-read
description: Read epic and its child issues
version: "0.5.0"
---

# Epic Read

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

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

Retrieves epic details and all child issues parented under the specified epic.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| epic_key | string | Yes | JIRA epic key (e.g., `<PROJECT_KEY>-10`) |

## Implementation

Uses MCP JIRA tools:

1. `mcp__atlassian__getJiraIssue` to read epic details
2. `mcp__atlassian__searchJiraIssuesUsingJql` with JQL filter `parent = <epic_key>`

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

mcp__atlassian__searchJiraIssuesUsingJql({
  jql: "parent = <epic_key>",
  max_results: 50
})
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| epic.key | string | Epic issue key |
| epic.summary | string | Epic title |
| epic.status | string | Current status of the epic |
| epic.description | string | Epic description |
| children | array | List of child issue objects |
| children[].key | string | Child issue key |
| children[].summary | string | Child issue summary |
| children[].status | string | Child issue status |
| children[].issue_type | string | Child issue type (Story, Task, Bug, etc.) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Epic key not found | Verify the epic key and that the issue type is Epic |
| 403 | Insufficient permissions to view the epic | Confirm the JIRA user has browse permissions on the project |
| 400 | Key does not reference an Epic issue type | Use `jira-official:issue-read` for non-epic issue types |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (reviewing epic scope and child issue status during planning)
