Call mutating tools batch¶

Use when you need an ordered workflow made from existing typed MCP tools, such as renaming and splitting a known window, while preserving each tool’s own schema and safety checks.

Avoid when you need tmux’s native semicolon command parsing. This tool batches MCP tools; it does not create one tmux command sequence. For shell commands with completion and output, prefer run_command.

Side effects: Runs readonly and mutating nested tools in order. Destructive nested tools are rejected even when the server process is running with LIBTMUX_SAFETY=destructive.

Example:

{
  "tool": "call_mutating_tools_batch",
  "arguments": {
    "operations": [
      {
        "tool": "rename_window",
        "arguments": {"window_id": "@2", "new_name": "logs"}
      },
      {
        "tool": "split_window",
        "arguments": {"window_id": "@2", "direction": "right"}
      }
    ],
    "on_error": "stop"
  }
}

Parameters