Tools

list_collections

List every collection the agent can see.

Last updated

list_collections

List all collections (workspaces) the agent can see. Call this first to discover collection IDs; every other write and query tool needs one.

Arguments

None.

Returns

A JSON array of collection summaries. Each item contains:

FieldTypeDescription
idstringStable collection ID. Pass to list_views, query_pages, create_page.
namestringDisplay name.
descriptionstringOptional long-form description.
iconstringIcon identifier (emoji or token).
colorstringTheme colour hex.
defaultViewstringID of the view shown by default when humans open it.

Example

{
  "tool": "list_collections",
  "arguments": {}
}

Sample response:

[
  {
    "id": "col_a1b2c3",
    "name": "Meeting Notes",
    "description": "All team meetings",
    "icon": "📝",
    "color": "#5b8def",
    "defaultView": "view_xyz"
  }
]

See also