# signal_channel

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

> Signal a tmux ``wait-for`` channel, waking blocked waiters.

MCP is in development

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

Signal a tmux `wait-for` channel, waking blocked waiters.

With no current waiter, tmux records one pending signal for the next waiter to consume. Signalling that channel again clears it. A woken waiter continues whatever work follows its wait.

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

## Arguments

* `channel` required · string

  Channel name. Must match \`\`^\[A-Za-z0-9\_.:-]{1,128}$\`\`.

* `socket_name` optional

  tmux socket name.

  Default: `null`.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "channel": {
      "description": "Channel name. Must match ``^[A-Za-z0-9_.:-]{1,128}$``.",
      "type": "string"
    },
    "socket_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "tmux socket name."
    }
  },
  "required": [
    "channel"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object",
  "x-fastmcp-wrap-result": true
}
```

Tool annotations

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