---
name: tracker/jira-official:sprint-read
description: Read sprint details and issues
version: "0.5.0"
---

# Sprint Read

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

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

> **Plugin Support:** This operation may not be supported by the official Atlassian plugin. If unavailable, use the Atlassian REST API directly or switch to a custom backend with `TRACKER_BACKEND_OVERRIDE: jira-custom`.

Retrieves sprints for a board, optionally filtered by state.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| board_id | number | Yes | JIRA board ID |
| sprint_state | string | No | Filter by sprint state: `active`, `future`, or `closed` |

## Implementation

Sprint listing is not exposed as a direct tool in the official Atlassian plugin. Use the JIRA REST API directly as a fallback:

```
# List sprints for a board — JIRA REST API fallback
GET /rest/agile/1.0/board/<board_id>/sprint?state=<sprint_state>
```

Alternatively, search for sprint issues using `mcp__atlassian__searchJiraIssuesUsingJql` with sprint JQL:

```
mcp__atlassian__searchJiraIssuesUsingJql({
  jql: "project = {PROJECT_KEY} AND sprint in openSprints()",
  max_results: 50
})
```

If the plugin gains native sprint read tools, the expected tool name would follow the pattern `mcp__atlassian__getJiraSprints`.

## Output

| Field | Type | Description |
|-------|------|-------------|
| sprints | array | List of sprint objects matching the filter |
| sprints[].id | number | Sprint ID |
| sprints[].name | string | Sprint name |
| sprints[].state | string | Sprint state: `active`, `future`, or `closed` |
| sprints[].startDate | string | ISO 8601 sprint start date |
| sprints[].endDate | string | ISO 8601 sprint end date |
| sprints[].goal | string | Sprint goal text |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Board ID not found | Verify the board ID in JIRA project settings |
| 403 | Insufficient permissions to view sprints | Confirm the JIRA user has browse permissions on the project |
| 400 | Invalid `sprint_state` value | Use one of: `active`, `future`, `closed` (or omit for all states) |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (reading active or upcoming sprints before assigning issues)
