create_local
Create a persistent local terminal session on the host machine. Get a session ID to run commands interactively across multiple calls.
Instructions
Creates a persistent local terminal session (PTY on supported platforms)
on the machine hosting this MCP server. The session stays active across
tool calls; drive it with `execute` and close it with `disconnect`.
WHEN TO USE:
- Use this for a shell on the LOCAL host (the machine running this server).
For a shell on a REMOTE host, use `connect_ssh` instead.
- Reuse an existing session_id rather than creating one per command.
BEHAVIOR & SIDE EFFECTS:
- Spawns a shell with the permissions of the user running the MCP server —
full read/write file access and execution privileges on the host.
- No rate limits or destructive-command filters are applied.
- Leaks a process if left open; call `disconnect` when finished.
Returns:
A unique session_id used to drive (`execute`) and close (`disconnect`)
this shell.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shell | No | Optional absolute path or executable name of the shell to use (e.g., 'powershell.exe', '/bin/bash', '/bin/zsh'). If omitted, defaults to cmd.exe on Windows or /bin/bash on Unix/macOS. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |