List knowledge-base documents

Tool: list_documents. Requires Viewer or higher in the applicable workspace and a connected OAuth session. Returns the newest 100 active documents, ordered by creation time, with document UUIDs, filenames, and processing status. This MCP tool has no pagination arguments; use the paginated REST document list to retrieve older documents. Use UUIDs in node document_uuids. Confirm processing completed before expecting retrieval. Listing does not upload or process documents.

Arguments

Send an empty arguments object: {}.

Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

{}

Result and errors

The schema below describes MCP structuredContent, including the result wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See troubleshooting. Effect: Reads data. Retry: Declared idempotent. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

Input schema

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

Result schema

{
  "properties": {
    "result": {
      "items": {
        "properties": {
          "document_uuid": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "processing_status": {
            "type": "string"
          },
          "total_chunks": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "document_uuid",
          "filename",
          "processing_status",
          "total_chunks"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}

Get started

Use MCP

Workspaces

Agents

Calls and outcomes

Phone numbers

Resources

Authoring guidance

Documentation

Arguments

Example arguments

Result and errors

​Arguments

​Example arguments

​Result and errors

Arguments

Example arguments

Result and errors