> ## Documentation Index
> Fetch the complete documentation index at: https://ekso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cycle

> MCP tools for creating and managing cycles (sprints/iterations) within boards.

## create\_cycle

Create a new cycle (sprint/iteration) within a board.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter     | Type     | Required | Description                                                                 |
| ------------- | -------- | -------- | --------------------------------------------------------------------------- |
| `boardId`     | string   | Yes      | Parent board ID. Use [`get_board_cycle`](/mcp-tools/board#get_board_cycle). |
| `name`        | string   | Yes      | Cycle name.                                                                 |
| `description` | string   | Yes      | Cycle description.                                                          |
| `startDate`   | DateTime | No       | Cycle start date.                                                           |
| `finishDate`  | DateTime | No       | Cycle end date.                                                             |
| `budgetHours` | int      | No       | Budget in hours for this cycle.                                             |

### Returns

A `CycleDto` with the created cycle's ID, name, dates, budget, and status.

***

## update\_cycle

Update cycle details or close it. Closing a cycle automatically approves all time entries for items in the cycle.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter     | Type     | Required | Description                                                                   |
| ------------- | -------- | -------- | ----------------------------------------------------------------------------- |
| `boardId`     | string   | Yes      | Parent board ID.                                                              |
| `cycleId`     | string   | Yes      | Cycle ID to update.                                                           |
| `name`        | string   | No       | New cycle name.                                                               |
| `startDate`   | DateTime | No       | New start date.                                                               |
| `finishDate`  | DateTime | No       | New end date.                                                                 |
| `budgetHours` | int      | No       | New budget in hours.                                                          |
| `closed`      | bool     | No       | Set to `true` to close the cycle. **Closing auto-approves all time entries.** |

### Returns

A `CycleDto` with the updated cycle details.

***

## delete\_cycle

Delete a cycle from a board. Requires Manage permission on the board.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter | Type   | Required | Description                                                                 |
| --------- | ------ | -------- | --------------------------------------------------------------------------- |
| `boardId` | string | Yes      | Parent board ID. Use [`get_board_cycle`](/mcp-tools/board#get_board_cycle). |
| `cycleId` | string | Yes      | Cycle ID to delete.                                                         |

### Returns

A confirmation message with the deleted cycle's name.

***

## get\_cycle\_stats

Get item count statistics grouped by cycle.

| Property      |     |
| ------------- | --- |
| **Read-only** | Yes |

### Parameters

None.

### Returns

A list of `GroupByCountRecord` objects, each containing:

| Field     | Description                  |
| --------- | ---------------------------- |
| `content` | Cycle name                   |
| `count`   | Number of items in the cycle |