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: | | | |
{"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: | | | |
{"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.
| Parameter | Type | Required | Description |
|---|
board_id | string | Yes | The id of board (e.g., ‘1000’) |
sprint_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.
| Parameter | Type | Required | Description |
|---|
sprint_id | string | Yes | The id of sprint (e.g., ‘10001’) |
sprint_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 |