# show_option

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

> Show a tmux option value.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Show a tmux option value.

Use to check tmux configuration values such as history-limit, mouse support, or status bar settings.

[All Python tools](https://libtmux.org/en/py/latest/mcp/tools/) · [JSON](https://libtmux.org/en/py/latest/mcp/tools/show_option.json) · [Source](https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/tools/option_tools.py#L153)

## Arguments

* `global_` optional · boolean

  Whether to query the global option.

  Default: `false`.

* `option` required · string

  The tmux option name to query.

* `scope` optional

  Option scope.

  Default: `null`.

* `socket_name` optional

  tmux socket name.

  Default: `null`.

* `target` optional

  Target identifier. For session scope: session name (e.g. 'mysession'). For window scope: window ID (e.g. '@1'). For pane scope: pane ID (e.g. '%1'). Requires scope.

  Default: `null`.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "global_": {
      "default": false,
      "description": "Whether to query the global option.",
      "type": "boolean"
    },
    "option": {
      "description": "The tmux option name to query.",
      "type": "string"
    },
    "scope": {
      "anyOf": [
        {
          "enum": [
            "server",
            "session",
            "window",
            "pane"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Option scope."
    },
    "socket_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "tmux socket name."
    },
    "target": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Target identifier. For session scope: session name\n(e.g. 'mysession'). For window scope: window ID (e.g. '@1').\nFor pane scope: pane ID (e.g. '%1'). Requires scope."
    }
  },
  "required": [
    "option"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "description": "Result of a show_option call.",
  "properties": {
    "option": {
      "description": "Option name",
      "type": "string"
    },
    "value": {
      "description": "Option value"
    }
  },
  "required": [
    "option",
    "value"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false
}
```