MCPconceptTools

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

tool MCPlatest

paste_text

paste_text( enter?: boolean, pane: string, text: string, )
tool [source]

Put text into a pane through a tmux paste buffer instead of typing it key by key. Use this for anything long or awkward: send_keys types the text, so a shell reading it can react to each character, and a bracketed-paste aware program treats a paste as one block. Optional Enter is appended to that same block. Empty text without Enter is a guarded buffer-free no-op. Paste targets only the named pane, even when synchronized input is enabled. A dead, input-disabled, mode-owned, terminal-attended, or inherited-caller target is refused before setup and again immediately before paste. The private buffer is deleted after setup, refusal, and paste outcomes; observations can still race with tmux. A submitted paste is remembered briefly so wait_for_text can discount its own echo. Send input to a pane’s program; a shell that receives it runs it with your user’s permissions.

MCP request method
tools/call Send paste_text as the tool name, with the arguments below.

Arguments#

No other arguments are accepted.

Result#

Returns object

  • bytes (integer) #

    How many bytes came from text, excluding optional Enter.

    minimum
    0
  • pane (string) #

    The pane it went into.

Annotations#

destructiveHint
true
idempotentHint
false
openWorldHint
true
readOnlyHint
false
title
"Paste Text Into Pane"

Protocol data#

Use the complete advertised contract for validation and client integration.

Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"enter": {
"default": false,
"description": "Whether to append Enter to the same paste block.",
"type": "boolean"
},
"pane": {
"description": "The `%`-prefixed pane to paste into.",
"type": "string"
},
"text": {
"description": "The text to deliver.",
"type": "string"
}
},
"required": [
"pane",
"text"
],
"type": "object"
}
Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bytes": {
"description": "How many bytes came from `text`, excluding optional Enter.",
"minimum": 0,
"type": "integer"
},
"pane": {
"description": "The pane it went into.",
"type": "string"
}
},
"required": [
"pane",
"bytes"
],
"type": "object"
}
Esc

Type to search.

Reference previewOpen reference