# list\_document\_types

List the document types with their contexts.

read-only · idempotent · MCP tool · [Agent](https://komrad.dev/latest/api/agent.md)

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListDocumentTypes \
  -H 'Content-Type: application/json' \
  -d '{}'
```

```bash
komrad rpc list-document-types
```

```json
{
  "name": "list_document_types",
  "arguments": {}
}
```

Offered by the komrad MCP server to writer, reviewer, orchestrator agents.

## Request

### Empty

No fields.

## Response

### ListDocumentTypesResponse

| Field | Type | Description |
| --- | --- | --- |
| [`document_types`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-ListDocumentTypesResponse-document_types) | [DocumentType\[\]](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType) | Every document type, by name, with its context. |

## Types

### DocumentType

DocumentType is one kind of document, with the context an agent reads before writing one.

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType-id) | uuid\* | The document type's id. |
| [`name`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType-name) | string | The document type's name, which each document of the type carries as `type`. |
| [`context`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType-context) | string | The markdown an agent reads before writing a document of this type. |
| [`version`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType-version) | int32 | How many times the document type has been written. |
| [`updated_at`](https://komrad.dev/latest/api/agent/list-document-types.md#komrad-agent-v1-DocumentType-updated_at) | timestamp | When the document type was last written. |
