> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-atlassian.soomiles.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Jira Agile
> 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 theme={null}
{"board_name": "Sprint Board", "project_key": "PROJ", "board_type": "scrum"}
```
Supports fuzzy search by board name. Combine with `project_key` to narrow results.
***
### 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 theme={null}
{"sprint_id": "42", "fields": "summary,status,assignee,story_points"}
```
Get the sprint ID from `jira_get_sprints_from_board` first.
***
### Create Sprint
Create Jira sprint for a board.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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 theme={null}
{"sprint_id": "42", "issue_keys": "PROJ-1,PROJ-2,PROJ-3"}
```
Get sprint IDs from `jira_get_sprints_from_board`. Issue keys are validated server-side — invalid keys will cause an error.
***