Paste buffer

paste_buffer

paste_buffer
mutating tool

Paste an MCP-owned buffer into a pane.

Returns:

str

Use when you’ve staged content via load_buffer and need to push it into a target pane. Use bracketed paste mode (default bracket=true) for terminals that handle it; the wrapping escape sequences signal “this is pasted text, not typed input”.

Avoid when the buffer name doesn’t match the MCP namespace — paste_buffer refuses non-libtmux_mcp_* names so it cannot be turned into an arbitrary-buffer paster.

Side effects: Pastes content into the target pane (the pane’s shell receives the bytes as input). Open-world: the resulting shell behavior is whatever the pasted bytes invoke.

Parameters

Parameter

Type

Required

Default

Description

buffer_name

str

yes

Must match the full MCP-namespaced form returned by :func:load_buffer. Non-MCP buffers are rejected so the tool cannot be turned into an arbitrary-buffer reader.

pane_id

str

no

Target pane ID.

bracket

bool

no

True

Use tmux bracketed paste mode. Default True. Pane resolution fallbacks.

session_name

str

no

session_id

str

no

window_id

str

no

socket_name

str

no

tmux socket name.

Inspect