Resources

MCP resources are addressable documents the server exposes at tmux:// URIs. Clients read them via resources/read. All libtmux-mcp resources are resource templates — each URI includes a {?socket_name} query parameter for socket isolation, plus structural path parameters ({session_name}, {pane_id}, …) so a single template covers every session, window, or pane.

Every resource delivers a snapshot of the tmux hierarchy at call time. Agents use them for read-only inspection; any write workflow goes through the corresponding tools.

Available resources

get_sessions

List all tmux sessions.

get_sessions

get_session

Get details of a specific tmux session.

get_session

get_session_windows

List all windows in a tmux session.

get_session_windows

get_window

Get details of a specific window in a session.

get_window

get_pane

Get details of a specific pane.

get_pane

get_pane_content

Capture and return the content of a pane.

get_pane_content

---

Sessions

get_sessions

tmux://sessions{?socket_name}

resource-template application/json

List all tmux sessions.

MIME type:

application/json

Parameters

Argument	Type	Required	Description
socket_name	string | null	no	—

get_session

tmux://sessions/{session_name}{?socket_name}

resource-template application/json

Get details of a specific tmux session.

MIME type:

application/json

Parameters

Argument	Type	Required	Description
session_name	string	yes	—
socket_name	string | null	no	—

get_session_windows

tmux://sessions/{session_name}/windows{?socket_name}

resource-template application/json

List all windows in a tmux session.

MIME type:

application/json

Parameters

Argument	Type	Required	Description
session_name	string	yes	—
socket_name	string | null	no	—

Windows

get_window

tmux://sessions/{session_name}/windows/{window_index}{?socket_name}

resource-template application/json

Get details of a specific window in a session.

MIME type:

application/json

Parameters

Argument	Type	Required	Description
session_name	string	yes	—
window_index	string	yes	—
socket_name	string | null	no	—

Panes

get_pane

tmux://panes/{pane_id}{?socket_name}

resource-template application/json

Get details of a specific pane.

MIME type:

application/json

Parameters

Argument	Type	Required	Description
pane_id	string	yes	—
socket_name	string | null	no	—

get_pane_content

tmux://panes/{pane_id}/content{?socket_name}

resource-template text/plain

Capture and return the content of a pane.

MIME type:

text/plain

Parameters

Argument	Type	Required	Description
pane_id	string	yes	—
socket_name	string | null	no	—