{
  "name": "show_buffer",
  "wireName": "show_buffer",
  "source": {
    "repo": "tmux-python/libtmux-mcp",
    "revision": "4daddc0dfca96c43bf521d818bf91564e1434760",
    "extractedRevision": "4daddc0dfca96c43bf521d818bf91564e1434760",
    "file": "src/libtmux_mcp/tools/buffer_tools.py",
    "line": 396
  },
  "description": "Read back the contents of an MCP-owned buffer.\n\nOutput is tail-preserved: when the buffer exceeds ``max_lines`` the\noldest lines are dropped and\n:attr:`~libtmux_mcp.models.BufferContent.content_truncated` is set\nso the caller can tell truncation happened and opt in to a full\nread via ``max_lines=None``. This mirrors ``capture_pane`` — one\nconsistent bounded-output contract across read-heavy tools so a\npathological ``load_buffer`` staging cannot blow the agent's\ncontext window on a single ``show_buffer`` call.",
  "schemaStatus": "runtime",
  "inputSchema": {
    "additionalProperties": false,
    "properties": {
      "buffer_name": {
        "description": "Must match the full MCP-namespaced form.",
        "type": "string"
      },
      "max_lines": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": 500,
        "description": "Maximum number of lines to return. Defaults to\n:data:`SHOW_BUFFER_DEFAULT_MAX_LINES`. Pass ``None`` for no\ntruncation."
      },
      "socket_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "tmux socket name."
      }
    },
    "required": [
      "buffer_name"
    ],
    "type": "object"
  },
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true,
    "readOnlyHint": false
  },
  "meta": {
    "fastmcp": {
      "tags": [
        "inspect"
      ]
    }
  }
}