tool MCPlatest

`wait_for_text`

wait_for_text( target: string, text: string, timeout_ms?: integer, )

tool [source]¶

Discount this server’s pending input and recent submitted echoes; unmodelled keys stop tracking the current line. Wait for a new shell’s prompt before typing. matched_at_entry reports visible text at entry; a mode ending in -unconfirmed identifies input that was still unconfirmed at the deadline. Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted.

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

Arguments#

target (string) #

Pane ID or pane target.

maxLength
512
text (string) #

Literal text to wait for.

maxLength
4096
timeout_ms? (integer) #

Bounded wait in milliseconds.

minimum
1
maximum
60000

No other arguments are accepted.

Result#

Returns object

elapsed_ms (integer) #

minimum
0
matched (boolean) #
matched_at_entry (boolean) #
mode (string) #
pane_id? (string) #

pattern
"^%[0-9]+$"
text (string) #
timed_out (boolean) #

No other properties are accepted.

Annotations#

destructiveHint: true
idempotentHint: false
openWorldHint: true
readOnlyHint: false
title: "Wait for pane text"

Protocol data#

Use the complete advertised contract for validation and client integration.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "target": {
      "description": "Pane ID or pane target.",
      "maxLength": 512,
      "type": "string"
    },
    "text": {
      "description": "Literal text to wait for.",
      "maxLength": 4096,
      "type": "string"
    },
    "timeout_ms": {
      "description": "Bounded wait in milliseconds.",
      "maximum": 60000,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "target",
    "text"
  ],
  "type": "object"
}

Output schema

{
  "additionalProperties": false,
  "properties": {
    "elapsed_ms": {
      "minimum": 0,
      "type": "integer"
    },
    "matched": {
      "type": "boolean"
    },
    "matched_at_entry": {
      "type": "boolean"
    },
    "mode": {
      "type": "string"
    },
    "pane_id": {
      "pattern": "^%[0-9]+$",
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "timed_out": {
      "type": "boolean"
    }
  },
  "required": [
    "elapsed_ms",
    "matched",
    "matched_at_entry",
    "mode",
    "text",
    "timed_out"
  ],
  "type": "object"
}

Scripting & web

Compiled & native

JVM

.NET

BEAM

tmux

`wait_for_text`

Arguments#

Result#

Annotations#

Protocol data#