list_documents
List the documents agents have written, without their bodies.
read-onlyidempotentMCP toolAgent
Set agent_id to list one agent's documents.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListDocuments \
-H 'Content-Type: application/json' \
-d '{}'komrad rpc list-documents{
"name": "list_documents",
"arguments": {}
}Offered by the komrad MCP server to writer, reviewer, orchestrator agents.
Request#
ListDocumentsRequest#
| Field | Type | Description |
|---|---|---|
agent_id | uuid | The agent whose documents to list, by id. Unset lists every agent's, archived agents included. |
type | string not empty at most 100 characters | The type of documents to list, by name. Unset lists every type. |
pagination | Pagination | The page to read. |
| one of | The task whose documents to list. Unset lists every task's. | |
task_id | uuid | The task, by id. |
task_slug | string not empty | The task, by slug. |
Response#
ListDocumentsResponse#
| Field | Type | Description |
|---|---|---|
documents | Document[] | One page of documents, most recently written first, without their text. |
next_page_token | string | The cursor for the next page. Unset on the last page. |
Types#
Pagination#
Pagination selects one page of a listing.
Document#
Document is markdown an agent writes for the person to read.
| Field | Type | Description |
|---|---|---|
id | uuid* | The document's id. |
agent_id | uuid* | The id of the agent that owns the document. |
name | string | The document's title. No two of one agent's documents share one. |
type | string | The name of the document's type. |
body | string | The document's text, in markdown. Empty in a listing. |
created_at | timestamp | When the document was created. |
updated_at | timestamp | When the document was last written. |
version | int32 | How many times the document has been written. |
task_id | uuid | The id of the task the agent was on when the document was created. Unset for an orchestrator's documents. |