MCPAPI Reference

Choose documentation 3

latest

Current version

latest
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

create_session

Start a pane’s configured process; accepts no command payload. Create a detached tmux session and return its ids. Give a width and height when nothing will attach to it: a session with no client keeps tmux’s default 80x24, which truncates wide output.

All C# tools · JSON · Source

Arguments

height optional · integer | null
Rows. Omit for tmux's default of 24.

Default: null.

name optional · string | null
The session name. Omit and tmux names it with a number.

Default: null.

startDirectory optional · string | null
The literal starting directory. Omit for the MCP server's own working directory.

Default: null.

width optional · integer | null
Columns. Omit for tmux's default of 80.

Default: null.

Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema
{
"additionalProperties": false,
"properties": {
"height": {
"default": null,
"description": "Rows. Omit for tmux's default of 24.",
"maximum": 2147483647,
"minimum": -2147483648,
"type": [
"integer",
"null"
]
},
"name": {
"default": null,
"description": "The session name. Omit and tmux names it with a number.",
"type": [
"string",
"null"
]
},
"startDirectory": {
"default": null,
"description": "The literal starting directory. Omit for the MCP server's own working directory.",
"type": [
"string",
"null"
]
},
"width": {
"default": null,
"description": "Columns. Omit for tmux's default of 80.",
"maximum": 2147483647,
"minimum": -2147483648,
"type": [
"integer",
"null"
]
}
},
"type": "object"
}
Output schema
{
"properties": {
"changed": {
"type": "string"
},
"paneId": {
"default": null,
"type": [
"string",
"null"
]
},
"sessionId": {
"default": null,
"type": [
"string",
"null"
]
},
"windowId": {
"default": null,
"type": [
"string",
"null"
]
}
},
"required": [
"changed"
],
"type": "object"
}
Tool annotations
{
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true,
"readOnlyHint": false,
"title": "Create session"
}
Esc

Type to search.