# show_option

Source: https://libtmux.org/en/ts/latest/mcp/tools/show_option/

> Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read one named tmux option at server, session, window, or pane scope.

tool MCPlatest

MCP concept example

A working example of the core library. It can change without notice.

[What concept means](https://libtmux.org/en/meta/support/#concept-and-alpha)

* **show_option**( [name](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Fname): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), [scope](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Fscope)?: "server" | "session" | "global-session" | "window" | "global-window" | "pane", [target](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Ftarget)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), )

  tool \[[source](https://github.com/libtmux/libtmux-ts/blob/46cccfef2a546de55ce8b308249b8c76339089a0/packages/mcp/src/tools/settings.ts#L105)][¶](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option)

  Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read one named tmux option at server, session, window, or pane scope.

  * MCP request method

    `tools/call` Send `show_option` as the tool name, with the arguments below.

  ## Arguments[#](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.parameters)

  * **[`name`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Fname)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

    The tmux option to read, such as “status-left”.

  * **[`scope`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Fscope)**? ("server" | "session" | "global-session" | "window" | "global-window" | "pane")

    Default server.

  * **[`target`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.input%2Fproperties%2Ftarget)**? ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

    Session id/name or pane id, for the matching scope.

  ## Result[#](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.result)

  Returns [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)")

  * **[`name`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.output%2Fproperties%2Fname)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

  * **[`scope`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.output%2Fproperties%2Fscope)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

  * **[`value`](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.output%2Fproperties%2Fvalue)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

  No other properties are accepted.

  ## Annotations[#](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.annotations)

  * [`destructiveHint`](https://libtmux.org/en/ts/latest/mcp/reference/glossary/#destructiveHint)

    `true`

  * [`idempotentHint`](https://libtmux.org/en/ts/latest/mcp/reference/glossary/#idempotentHint)

    `false`

  * [`openWorldHint`](https://libtmux.org/en/ts/latest/mcp/reference/glossary/#openWorldHint)

    `true`

  * [`readOnlyHint`](https://libtmux.org/en/ts/latest/mcp/reference/glossary/#readOnlyHint)

    `false`

  ## Protocol data[#](https://libtmux.org/en/ts/latest/mcp/tools/show_option/#mcp.tool.show_option.schemas)

  Use the complete advertised contract for validation and client integration.

  Input schema

  ```json
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "name": {
        "description": "The tmux option to read, such as \"status-left\".",
        "type": "string"
      },
      "scope": {
        "description": "Default server.",
        "enum": [
          "server",
          "session",
          "global-session",
          "window",
          "global-window",
          "pane"
        ],
        "type": "string"
      },
      "target": {
        "description": "Session id/name or pane id, for the matching scope.",
        "type": "string"
      }
    },
    "required": [
      "name"
    ],
    "type": "object"
  }
  ```

  Output schema

  ```json
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "additionalProperties": false,
    "properties": {
      "name": {
        "type": "string"
      },
      "scope": {
        "type": "string"
      },
      "value": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "name",
      "scope",
      "value"
    ],
    "type": "object"
  }
  ```