Read Screen
read_screenCaptures the current terminal screen and cursor position for an SSH session so you can inspect interactive output without running a new command.
Instructions
Read the terminal screen state for a session.
Returns the current screen content from the terminal emulator, including cursor position. Only works when MCP_SSH_INTERACTIVE_MODE=1 is set.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"host": "<host>"
},
"name": "read_screen"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Hostname, IP address, or SSH config alias | |
| port | No | SSH port (optional, will use SSH config or default 22) | |
| username | No | SSH username (optional, will use SSH config or current user) | |
| max_lines | No | Maximum number of lines to return (default: 24) |