> For the complete documentation index, see [llms.txt](https://docs.telys.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telys.ai/mcp/tool-list-collections.md).

# telys\_list\_collections

Reference for the telys\_list\_collections MCP tool — list the saved Telys memory collections in the active memory store.

`telys_list_collections` **lists the Telys memory collections** in the active store. It is one of the 19 tools on the Telys MCP server (`telys mcp`), called by name over JSON-RPC 2.0 (protocol version `2025-06-18`) on stdio.

The server scans the store (`$TELYS_MEMORY_PATH`, default `~/.telys/memory`) and returns the names of the collections **saved** to disk. Collections built but never persisted do not appear — over MCP the mutating tools (`telys_add`, `telys_upsert`, `telys_update`, `telys_delete`, `telys_compact`, `telys_build_ivf`, `telys_build_lexical`) are the ones that write to disk. [`telys_create_collection`](https://docs.telys.ai/mcp/tool-create-collection.md) builds a collection but does not persist it, so a new collection is not listed until one of those tools writes to it and saves.

## Input schema

`telys_list_collections` takes **no parameters**.

| Field    | Type | Required | Description                 |
| -------- | ---- | -------- | --------------------------- |
| *(none)* | —    | —        | This tool has no arguments. |

## Output schema

| Field         | Type            | Description                                                                               |
| ------------- | --------------- | ----------------------------------------------------------------------------------------- |
| `collections` | array of string | Sorted names of the saved collections in the active store. Empty when the store has none. |

## Example call

{% code title="request.json" %}

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "telys_list_collections",
    "arguments": {}
  }
}
```

{% endcode %}

The wrapped result:

{% code title="response.json" %}

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"collections\": [\"chat\", \"notes\"]}" }
    ],
    "isError": false
  }
}
```

{% endcode %}

Decoding the `text` field:

{% code title="payload.json" %}

```json
{ "collections": ["chat", "notes"] }
```

{% endcode %}

{% hint style="info" %}
An empty store returns `{ "collections": [] }`, not an error. If you expected collections and see none, confirm the client is pointed at the right store via `TELYS_MEMORY_PATH`. See [MCP configuration & scoping](https://docs.telys.ai/mcp/configuration-and-scoping.md).
{% endhint %}

## In practice

```
List my Telys memory collections.
```

## Errors

Failures return the same envelope with `isError: true` and a single text block of the form `<Type>: <message>`. See [MCP configuration & scoping](https://docs.telys.ai/mcp/configuration-and-scoping.md) and [Exceptions & error codes](https://docs.telys.ai/reference/exceptions-and-errors.md).

## See also

* [Tool: telys\_stats](https://docs.telys.ai/mcp/tool-stats.md) — inspect one collection's row count and index state.
* [Tool: telys\_create\_collection](https://docs.telys.ai/mcp/tool-create-collection.md) — create a collection (persisted once a mutating tool writes to it).
* [List & fetch by ID](https://docs.telys.ai/working-with-data/list-and-fetch-by-id.md) — the SDK's `collections()` and `ids()`.
* [MCP configuration & scoping](https://docs.telys.ai/mcp/configuration-and-scoping.md) — where the store lives and how scope is chosen.
