Tools
Browse the operations the server exposes to MCP clients. Use the registered name and arguments when sending a tools/call request.
The reference configuration advertises 45 tools. Your server’s available objects depend on its configuration. Setup documentation explains how to connect a client.
Server3 tools#
Start a pane’s configured process; accepts no command payload. Create a detached session with a configured pane process.
Inspect tmux metadata; accepts no client-supplied executable input. Return liveness and identity metadata for the selected tmux server.
Inspect tmux metadata; accepts no client-supplied executable input. List sessions on the selected server.
Session5 tools#
Start a pane’s configured process; accepts no command payload. Create a window with a configured pane process.
Inspect tmux metadata; accepts no client-supplied executable input. Return metadata for one session.
Delete tmux state; accepts no command payload. Delete one session and every window it owns.
Inspect tmux metadata; accepts no client-supplied executable input. List windows, optionally within one session.
Change tmux state; no client-supplied executable input. Set a literal-safe session name.
Window9 tools#
Inspect tmux metadata; accepts no client-supplied executable input. Return metadata and placements for one window.
Delete tmux state; accepts no command payload. Delete one window and every pane it owns.
Inspect tmux metadata; accepts no client-supplied executable input. List panes, optionally within a session or window.
Change tmux state; no client-supplied executable input. Move one window appearance to another session.
Change tmux state; no client-supplied executable input. Set a literal-safe window name.
Change tmux state; no client-supplied executable input. Resize the terminal dimensions reported for one window.
Change tmux state; no client-supplied executable input. Apply a named layout, a unique abbreviation for the running tmux version, or a checksummed saved layout. Invalid syntax is refused before window lookup; tmux validates geometry when applying the layout.
Change tmux state; no client-supplied executable input. Select one exact window appearance.
Start a pane’s configured process; accepts no command payload. Create a configured-process pane without accepting command or environment data.
Pane18 tools#
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Return a bounded slice of rendered pane text.
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Return output after an opaque pane cursor.
Delete tmux state; accepts no command payload. Irreversibly discard retained scrollback for one pane.
Inspect tmux metadata; accepts no client-supplied executable input. Find a pane occupying a named window corner.
Inspect tmux metadata; accepts no client-supplied executable input. Return metadata for one pane.
Delete tmux state; accepts no command payload. Delete one pane and its running process.
Send input to a pane’s program; a shell that receives it runs it with your user’s permissions. Paste literal text and an optional newline target-only after two state checks.
Change tmux state; no client-supplied executable input. Resize one pane by dimensions or a directional amount.
Start a pane’s configured process; accepts no command payload. Restart only the pane’s configured process; no caller command is accepted.
Run a shell command in a pane with your user’s permissions. Run one command in a singular trusted POSIX shell and return bounded output.
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Search bounded pane content for literal text or a regular expression.
Change tmux state; no client-supplied executable input. Select one pane as active.
Send input to a pane’s program; a shell that receives it runs it with your user’s permissions. Send keys after checking the effective synchronized-pane cohort.
Send input to a pane’s program; a shell that receives it runs it with your user’s permissions. Send an ordered bounded batch with a fresh check for every row.
Change tmux state; no client-supplied executable input. Set one literal-safe pane title.
Change tmux state; no client-supplied executable input. Set the window input default; pane overrides determine effective synchronization.
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Return pane metadata and bounded terminal content together.
Change tmux state; no client-supplied executable input. Swap two panes without changing their identities.
Hooks1 tool#
Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read configured hooks, optionally for one session.
Options and environment4 tools#
Change tmux state; no client-supplied executable input. Set the default retained scrollback line limit.
Change tmux state; no client-supplied executable input. Set the global tmux mouse option through a boolean.
Read the tmux environment; accepts no client-supplied executable input. Returned values may contain secrets. Read global or session tmux environment values.
Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read one exact tmux option.
Coordination2 tools#
Change tmux state; no client-supplied executable input. Signal one tmux wait-for channel.
Change tmux state; no client-supplied executable input. Wait within one deadline for a tmux channel signal.
Other tools3 tools#
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Invoke a serial batch of at most 16 inspect tools. One client approval covers every nested name; inner tools receive no separate approval. Retained rows contain full nested envelopes; oversized results are marked resultTruncated, and the response stays below the 1,000,000-byte wire cap.
Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Resolve validated variable names without accepting raw format syntax.
Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. Wait within one deadline for pane text.
Resources
1 advertised in the reference configuration.
Resource templates
This server does not advertise resource templates in the reference configuration.
Prompts
This server does not advertise prompts in the reference configuration.
Reference configuration
LIBTMUX_TOOLSETSinspect,manage,execute,teardown
Protocol version: 2025-11-25. Download the full protocol catalog.
Source: libtmux/libtmux-swift@6b51d1408b55.
The language API reference documents embedding and implementation types.