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

# Container

> MCP tools for querying containers, their processes, and filtering items by conditions.

## get\_containers

Get all containers (projects/services) with their areas. This is typically the first tool to call — container IDs are required by most other tools including [`filter_items`](#filter_items), [`get_container_process_list`](#get_container_process_list), and [`create_item`](/mcp-tools/item#create_item).

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

### Parameters

None.

### Returns

A list of `ContainerDto` objects, each containing:

* `containerId`, `containerCode`, `containerName`, `containerDesc` — container identity
* `url` — direct link to the container in the Ekso web app
* `areas` — list of areas with ID, name, and description

***

## get\_container\_process\_list

Get the processes configured for a specific container, along with their fields.

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

### Parameters

| Parameter     | Type   | Required | Description   |
| ------------- | ------ | -------- | ------------- |
| `containerId` | string | Yes      | Container ID. |

### Returns

A list of `ContainerProcessDto` objects with process ID, name, and field names. Use the returned `processId` when calling [`create_item`](/mcp-tools/item#create_item).

***

## filter\_items

Filter and page through work items using condition groups. Each group contains AND conditions; groups are OR-ed together. If no conditions are provided, returns all open items in the specified containers.

Results are paginated at 200 items per page, sorted by last changed date (most recent first).

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

### Parameters

| Parameter        | Type      | Required | Default | Description                                                              |
| ---------------- | --------- | -------- | ------- | ------------------------------------------------------------------------ |
| `containerIds`   | string\[] | Yes      | —       | Container IDs to search within. Use [`get_containers`](#get_containers). |
| `conditionsJson` | string    | No       | `null`  | Filter conditions as JSON (see format below). Omit for all items.        |
| `includeClosed`  | bool      | No       | `false` | Include closed items.                                                    |
| `page`           | int       | No       | `1`     | Page number (200 items per page).                                        |

### Condition format

```json theme={null}
[
  {
    "condition": [
      {
        "leftSide": "<fieldId>",
        "operator": "Equal",
        "rightSide": "<value>"
      }
    ]
  }
]
```

* **Within a group**: conditions are combined with **AND** (all must match)
* **Between groups**: groups are combined with **OR** (any group can match)

**Operators:**

| Name                 | Numeric | Description              | Applicable types                      |
| -------------------- | ------- | ------------------------ | ------------------------------------- |
| `Equal`              | `10`    | Exact match              | All types                             |
| `NotEqual`           | `11`    | Does not match           | All types                             |
| `LessThanOrEqual`    | `20`    | Less than or equal to    | Integer, Decimal, Percent, Date, Time |
| `LessThan`           | `21`    | Strictly less than       | Integer, Decimal, Percent, Date, Time |
| `GreaterThanOrEqual` | `30`    | Greater than or equal to | Integer, Decimal, Percent, Date, Time |
| `GreaterThan`        | `31`    | Strictly greater than    | Integer, Decimal, Percent, Date, Time |
| `Contains`           | `40`    | Substring match          | Text                                  |
| `StartsWith`         | `41`    | Prefix match             | Text                                  |
| `EndsWith`           | `42`    | Suffix match             | Text                                  |

Operator values are case-insensitive — `"Equal"`, `"equal"`, and `10` all work.

Use [`get_filter_fields`](/mcp-tools/field#get_filter_fields) to discover filterable fields, valid operators, and value format guidance. Use [`get_field_list_data`](/mcp-tools/field#get_field_list_data) to get valid IDs for list-type fields (Status, Priority, Severity, etc.).

### Returns

An `ItemFilterResultDto` containing:

| Property   | Description                                         |
| ---------- | --------------------------------------------------- |
| `items`    | List of `CycleItemDto` objects for the current page |
| `total`    | Total number of matching items across all pages     |
| `page`     | Current page number                                 |
| `pages`    | Total number of pages                               |
| `pageSize` | Items per page (200)                                |