---
name: tracker/jira-official:sprint-manage
description: Create, start, or complete sprints
version: "0.5.0"
---

# Sprint Manage

> **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`.

Creates, starts, or completes a sprint on a JIRA board.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| action | string | Yes | Action to perform: `create`, `start`, or `complete` |
| board_id | number | Yes | JIRA board ID |
| sprint_name | string | Conditional | Sprint name — required when `action` is `create` |

## Implementation

Sprint management is not exposed as a direct tool in the official Atlassian plugin. Use the Atlassian REST API via the plugin's generic request capability if available, or fall back to the JIRA REST API directly:

```
# Create sprint — JIRA REST API fallback
POST /rest/agile/1.0/sprint
{ "originBoardId": <board_id>, "name": "<sprint_name>" }

# Start sprint
POST /rest/agile/1.0/sprint/<sprint_id>
{ "state": "active" }

# Complete sprint
POST /rest/agile/1.0/sprint/<sprint_id>
{ "state": "closed" }
```

If the plugin gains native sprint management tools, the expected tool names would follow the pattern:

| Action | Expected Tool |
|--------|---------------|
| `create` | `mcp__atlassian__createJiraSprint` |
| `start` | `mcp__atlassian__startJiraSprint` |
| `complete` | `mcp__atlassian__completeJiraSprint` |

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | number | Sprint ID |
| name | string | Sprint name |
| state | string | Sprint state after action: `future`, `active`, or `closed` |
| startDate | string | ISO 8601 sprint start date (populated after `start`) |
| endDate | string | ISO 8601 sprint end date (populated after `start`) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Board ID not found | Verify the board ID in JIRA project settings |
| 403 | Insufficient permissions to manage sprints | Confirm the JIRA user has manage sprint permissions |
| 400 | Invalid `action` value | Use one of: `create`, `start`, `complete` |
| 400 | `sprint_name` missing when `action` is `create` | Provide a non-empty sprint name |
| 400 | Cannot start a sprint that is not in `future` state | Check current sprint state with `jira-official:sprint-read` |
| 400 | Cannot complete a sprint that is not `active` | Check current sprint state with `jira-official:sprint-read` |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (creating and starting sprints during sprint planning)
