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

# Label

> MCP tools for querying, creating, updating, and deleting labels.

## get\_label\_list

Get the list of labels available for tagging items.

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

### Parameters

None.

### Returns

A list of `LabelDto` objects, each containing:

| Field     | Description            |
| --------- | ---------------------- |
| `labelId` | Label ID               |
| `name`    | Label display name     |
| `bgColor` | Background color (hex) |

***

## create\_label

Create a label with a name and background color. Requires super admin.

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

### Parameters

| Parameter | Type   | Required | Description                             |
| --------- | ------ | -------- | --------------------------------------- |
| `name`    | string | Yes      | Label display name.                     |
| `bgColor` | string | Yes      | Background color (hex, e.g. `#ff0000`). |

### Returns

A `LabelDto` with the created label's details.

***

## update\_label

Update a label's name and/or background color. Only provided fields are updated. Requires super admin.

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

### Parameters

| Parameter | Type   | Required | Description                                        |
| --------- | ------ | -------- | -------------------------------------------------- |
| `labelId` | string | Yes      | Label ID. Use [`get_label_list`](#get_label_list). |
| `name`    | string | No       | New label name.                                    |
| `bgColor` | string | No       | New background color (hex).                        |

### Returns

A `LabelDto` with the updated label details.

***

## delete\_label

Delete a label. Requires super admin.

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

### Parameters

| Parameter | Type   | Required | Description                                        |
| --------- | ------ | -------- | -------------------------------------------------- |
| `labelId` | string | Yes      | Label ID. Use [`get_label_list`](#get_label_list). |

### Returns

A confirmation message with the deleted label's name.