MCPpre-alphaTools

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.

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 54 tools. Your server’s available objects depend on its configuration. Setup documentation explains how to connect a client.

Server5 tools#

create_session

Create a new tmux session.

get_server_info

Get information about the tmux server.

kill_server

Kill the tmux server and all its sessions.

list_servers

Discover live tmux servers under the current user’s $TMUX_TMPDIR.

list_sessions

List tmux sessions (terminal workspaces) on a tmux server.

Session5 tools#

create_window

Create a new window in a tmux session.

get_session_info

Return metadata for a single tmux session (ID, name, window count, activity).

kill_session

Kill a tmux session.

list_windows

List tmux windows (terminal tabs) in a session, or across the server.

rename_session

Rename a tmux session.

Window9 tools#

get_window_info

Return metadata for a single tmux window (ID, name, layout, dimensions).

kill_window

Kill (close) a tmux window. Requires exact window_id (e.g. ‘@3’).

list_panes

List tmux panes (terminal multiplexer splits) in a window, session, or server.

move_window

Move a window to a different index or session.

rename_window

Rename a tmux window.

resize_window

Resize a tmux window.

select_layout

Set the layout of a tmux window.

select_window

Select (focus) a tmux window by ID, index, or direction.

split_window

Split a tmux window to create a new pane.

Pane18 tools#

capture_pane

Capture the visible contents of a tmux pane (terminal scrollback).

capture_since

Capture new tmux terminal scrollback since the previous cursor.

clear_pane

Clear the contents of a tmux pane.

find_pane_by_position

Find the pane occupying a corner of a tmux window.

get_pane_info

Get detailed information about a tmux pane.

kill_pane

Kill (close) a tmux pane. Requires exact pane_id (e.g. ‘%5’).

paste_text

Paste multi-line text into a pane using tmux paste buffers.

pipe_pane

Log a pane’s live output to a file (or stop an active log).

resize_pane

Resize a tmux pane.

respawn_pane

Restart a pane’s process in place, preserving pane_id and layout.

run_command

Run a shell command in a pane, wait for completion, and capture output.

search_panes

Search visible terminal text across all tmux panes.

select_pane

Select (focus) a tmux pane by ID or direction.

send_keys

Send keys (commands or text) to a tmux pane.

send_keys_batch

Send an ordered batch of raw key/text operations to tmux panes.

set_pane_title

Set the title of a tmux pane.

snapshot_pane

Snapshot a tmux pane: visible terminal output, cursor, mode, scroll.

swap_pane

Swap the positions of two panes.

Buffers4 tools#

delete_buffer

Delete an MCP-owned buffer.

load_buffer

Load text into a new agent-namespaced tmux paste buffer.

paste_buffer

Paste an MCP-owned buffer into a pane.

show_buffer

Read back the contents of an MCP-owned buffer.

Hooks2 tools#

show_hook

Look up a specific tmux hook by name.

show_hooks

List configured tmux hooks at the given scope.

Options and environment4 tools#

set_environment

Set a tmux environment variable.

set_option

Set a tmux option value.

show_environment

Show tmux environment variables.

show_option

Show a tmux option value.

Coordination2 tools#

signal_channel

Signal a tmux wait-for channel, waking blocked waiters.

wait_for_channel

Block until a tmux wait-for channel is signalled.

Other tools5 tools#

call_read_tools_batch

Call several inspect tools serially and return per-tool results.

display_message

Read tmux variables against a target and return the substituted text.

enter_copy_mode

Enter copy mode in a tmux pane, optionally scrolling up.

exit_copy_mode

Exit copy mode in a tmux pane.

wait_for_text

Wait for NEW output in a tmux pane, then return.

Resources

This server does not advertise resources in the reference configuration.

Resource templates

6 advertised in the reference configuration.

Prompts

4 advertised in the reference configuration.

Reference configuration
LIBTMUX_TOOLSETS
inspect,manage,execute,teardown

Protocol version: 2025-11-25. Download the full protocol catalog.

Source: tmux-python/libtmux-mcp@4daddc0dfca9.

The language API reference documents embedding and implementation types.

Esc

Type to search.

Reference preview Open reference