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

**List terminal sessions.** List the browser terminal sessions opened on the environment (the newest 50) and the one in use. Recordings of your own sessions can be fetched with corestack_terminal_transcript_get. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

List the browser terminal sessions opened on the environment (the newest 50) and the one in use. Recordings of your own sessions can be fetched with corestack_terminal_transcript_get.

## Inputs

- `site_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- 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_sessions_list",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_terminal_sessions_list with site_id 4211. (List terminal sessions.) Tell me what it returned.
```

## The same task elsewhere

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