list_documents

[Documents]

List exact document projections with optional typed filters and order. Repeat arguments with a cursor; restart after cursor_expired.

Parameters

Name	Type	Required	Description
collectionId	string	Yes	Collection ID from list_collections.
spaceId	string	Yes	Workspace ID from list_spaces.
cursor	string	No	Opaque token from a prior page. Unknown tokens require enumeration to restart.
fields	json	No	Fields to return, any of title, summary, body, data, tags, sources, links, status, createdAt, updatedAt, and actor. Omit it for the default projection.
filter	json	No	Typed conditions, all of which must match: {"all": [...]}, up to 16. Each has a path (a document root such as /title or /tags, or a /data pointer), an op, and a type. exists needs only path and op. eq, contains, gt, gte, lt, and lte take type (string, number, boolean, null, date, or instant) and value; in takes type and values (up to 50).
includeArchived	boolean	No	Include archived records. Default: `false`
limit	number	No	Maximum items per page, from 1 to 50. Default: `20`
orderBy	json	No	Up to three sort keys: [{"path": "/updatedAt", "type": "instant", "direction": "desc"}]. type is string, number, boolean, date, or instant; direction is asc or desc.

Examples

Replace the sample IDs with values from your store. Use a fresh UUID for each requestId.

List decisions tagged deploy, newest first.

Arguments 
{
  "spaceId": "11111111-1111-4111-8111-111111111111",
  "collectionId": "33333333-3333-4333-8333-333333333333",
  "filter": {
    "all": [
      {
        "path": "/tags",
        "op": "contains",
        "type": "string",
        "value": "deploy"
      }
    ]
  },
  "orderBy": [
    {
      "path": "/updatedAt",
      "type": "instant",
      "direction": "desc"
    }
  ]
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_documents",
    "arguments": {
      "spaceId": "11111111-1111-4111-8111-111111111111",
      "collectionId": "33333333-3333-4333-8333-333333333333",
      "filter": {
        "all": [
          {
            "path": "/tags",
            "op": "contains",
            "type": "string",
            "value": "deploy"
          }
        ]
      },
      "orderBy": [
        {
          "path": "/updatedAt",
          "type": "instant",
          "direction": "desc"
        }
      ]
    }
  }
}