# get\_transcript

Read an agent's whole transcript, one window at a time, passing the returned cursor back to read on.

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/GetTranscript \
  -H 'Content-Type: application/json' \
  -d '{
  "agent_id": "<agent_id>"
}'
```

```bash
komrad rpc get-transcript \
  --agent-id '<uuid>'
```

```json
{
  "name": "get_transcript",
  "arguments": {
    "agent_id": "<agent_id>"
  }
}
```

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

## Request

### GetTranscriptRequest

| Field | Type | Description |
| --- | --- | --- |
| [`agent_id`](https://komrad.dev/latest/api/agent/get-transcript.md#komrad-agent-v1-GetTranscriptRequest-agent_id) | uuid\* | The agent whose transcript to read, by id. |
| [`max_bytes`](https://komrad.dev/latest/api/agent/get-transcript.md#komrad-agent-v1-GetTranscriptRequest-max_bytes) | int32 at least 0 | How many bytes of the transcript to return. |
| [`cursor`](https://komrad.dev/latest/api/agent/get-transcript.md#komrad-agent-v1-GetTranscriptRequest-cursor) | string at most 2048 characters | The `next_page_token` from the previous response. Unset to start at the beginning. |

## Response

### GetTranscriptResponse

| Field | Type | Description |
| --- | --- | --- |
| [`content`](https://komrad.dev/latest/api/agent/get-transcript.md#komrad-agent-v1-GetTranscriptResponse-content) | string | One window of the transcript, as plain text. |
| [`next_page_token`](https://komrad.dev/latest/api/agent/get-transcript.md#komrad-agent-v1-GetTranscriptResponse-next_page_token) | string | The cursor for the next window. Unset at the end of the transcript. |
