create_session
Create a new persistent terminal session with a specified working directory for running commands and monitoring logs.
Instructions
Create a PTY session with an explicit working directory.
MCP does not provide a standard field for the client's current working
directory. The caller must provide cwd explicitly.
Args: session_id: Stable identifier for this PTY session. cwd: Working directory for the session's shell. description: Free-form description of what this session is doing (for humans).
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": {
"session_id": "<session_id>",
"cwd": "<cwd>"
},
"name": "create_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | Yes | ||
| session_id | Yes | ||
| description | No | Free-form description of what this session is doing (for humans). Does not affect execution. |