---
title: "corestack_terminal_transcript_get"
url: https://docs.corefinity.com/mcp/tools/corestack_terminal_transcript_get
type: tool
last_updated: 2026-11-13
feature: terminal
related:
  - https://docs.corefinity.com/api/reference/access/download-terminal-transcript.md
  - https://docs.corefinity.com/guides/sites/access-and-security/browser-terminal.md
---
# corestack_terminal_transcript_get

**Get a terminal recording.** Get the recording of a browser terminal session you opened (asciicast). It opens in the person's browser; with reveal_to_agent: true you get a link to read it yourself. Scope: exec. The secret opens in the person's browser; set reveal_to_agent to true to receive it yourself (needs exec).

- Scope: `exec`
- Runs as a task: no
- Returns a secret only when `reveal_to_agent` is set

## When to use it

Get the recording of a browser terminal session you opened (asciicast). It opens in the person's browser; with reveal_to_agent: true you get a link to read it yourself.

## Inputs

- `session_id` (integer, ≥ 1, required)
- `reveal_to_agent` (boolean, default `false`): Return the secret to you instead of opening it in the person's browser. Needs exec.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "reveal_to_agent": {
      "default": false,
      "description": "Return the secret to you instead of opening it in the person's browser. Needs exec.",
      "type": "boolean"
    },
    "session_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "session_id"
  ],
  "type": "object"
}
```

## Refusals

- `expired`: the Control Panel answered 410 (a terminal recording past 90 days, an expired logs download), or a transfer object or link has passed its life; start again.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_terminal_transcript_get",
  "arguments": {
    "session_id": 7702
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_terminal_transcript_get with session_id 7702. (Get a terminal recording.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/terminal/sessions/{session}/transcript](https://docs.corefinity.com/api/reference/access/download-terminal-transcript.md)
- Guide: [Browser terminal](https://docs.corefinity.com/guides/sites/access-and-security/browser-terminal.md)
