---
title: "Jira Agile"
description: "Boards, sprints, and agile project management"
---

### Get Agile Boards

Get jira agile boards by name, project key, or type.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board_name` | `string` | No | (Optional) The name of board, support fuzzy search |
| `project_key` | `string` | No | (Optional) Jira project key (e.g., 'PROJ', 'ACV2') |
| `board_type` | `string` | No | (Optional) The type of jira board (e.g., 'scrum', 'kanban') |
| `start_at` | `integer` | No | Starting index for pagination (0-based) |
| `limit` | `integer` | No | Maximum number of results (1-50) |
**Example:**

```json
{"board_name": "Sprint Board", "project_key": "PROJ", "board_type": "scrum"}
```

<Tip>
Supports fuzzy search by board name. Combine with `project_key` to narrow results.
</Tip>


---

### Get Board Issues

Get all issues linked to a specific board filtered by JQL.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board_id` | `string` | Yes | The id of the board (e.g., '1001') |
| `jql` | `string` | Yes | JQL query string (Jira Query Language). Examples: - Find Epics: "issuetype = Epic AND project = PROJ" - Find issues in Epic: "parent = PROJ-123" - Find by status: "status = 'In Progress' AND project = PROJ" - Find by assignee: "assignee = currentUser()" - Find recently updated: "updated >= -7d AND project = PROJ" - Find by label: "labels = frontend AND project = PROJ" - Find by priority: "priority = High AND project = PROJ" |
| `fields` | `string` | No | Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority' |
| `start_at` | `integer` | No | Starting index for pagination (0-based) |
| `limit` | `integer` | No | Maximum number of results (1-50) |
| `expand` | `string` | No | Optional fields to expand in the response (e.g., 'changelog'). |

---

### Get Sprints from Board

Get jira sprints from board by state.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board_id` | `string` | Yes | The id of board (e.g., '1000') |
| `state` | `string` | No | Sprint state (e.g., 'active', 'future', 'closed') |
| `start_at` | `integer` | No | Starting index for pagination (0-based) |
| `limit` | `integer` | No | Maximum number of results (1-50) |

---

### Get Sprint Issues

Get jira issues from sprint.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sprint_id` | `string` | Yes | The id of sprint (e.g., '10001') |
| `fields` | `string` | No | Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority' |
| `start_at` | `integer` | No | Starting index for pagination (0-based) |
| `limit` | `integer` | No | Maximum number of results (1-50) |
**Example:**

```json
{"sprint_id": "42", "fields": "summary,status,assignee,story_points"}
```

<Tip>
Get the sprint ID from `jira_get_sprints_from_board` first.
</Tip>


---

### Create Sprint

Create Jira sprint for a board.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board_id` | `string` | Yes | The id of board (e.g., '1000') |
| `name` | `string` | Yes | Name of the sprint (e.g., 'Sprint 1') |
| `start_date` | `string` | Yes | Start time for sprint (ISO 8601 format) |
| `end_date` | `string` | Yes | End time for sprint (ISO 8601 format) |
| `goal` | `string` | No | (Optional) Goal of the sprint |

---

### Update Sprint

Update jira sprint.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sprint_id` | `string` | Yes | The id of sprint (e.g., '10001') |
| `name` | `string` | No | (Optional) New name for the sprint |
| `state` | `string` | No | (Optional) New state for the sprint (future\|active\|closed) |
| `start_date` | `string` | No | (Optional) New start date for the sprint |
| `end_date` | `string` | No | (Optional) New end date for the sprint |
| `goal` | `string` | No | (Optional) New goal for the sprint |

---

### Add Issues to Sprint

Add issues to a Jira sprint.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sprint_id` | `string` | Yes | Sprint ID to add issues to |
| `issue_keys` | `string` | Yes | Comma-separated issue keys (e.g., 'PROJ-1,PROJ-2') |

**Example:**

```json
{"sprint_id": "42", "issue_keys": "PROJ-1,PROJ-2,PROJ-3"}
```

<Tip>
Get sprint IDs from `jira_get_sprints_from_board`. Issue keys are validated server-side — invalid keys will cause an error.
</Tip>


---
