# Ruby MCP examples

Source: https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/examples/

> Run complete Ruby programs for an MCP client or an embedded application.

**MCP concept example** Maintained as a working example of core library usage and deployment. Example APIs, tools and configuration may change without a compatibility or product support commitment.

Both examples include their complete program, pinned dependencies, run
commands, expected results, and cleanup. Each creates its own tmux daemon.

## Default read-only catalog

The [client guide](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/guides/connect-client/#configure-a-client) generates an
MCP configuration using the launcher's absolute path and the current Ruby
executable. Its default catalog contains [`tmux_capabilities`](<https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/tools/tmux_capabilities/>) and
[`tmux_snapshot`](<https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/tools/tmux_snapshot/>). Listing the tools and querying the example session verifies
the connection.

The [embedded example](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/examples/page-session-metadata/) calls those tools from Ruby
inside an Async scope. It creates two sessions and prints their names by
following a snapshot cursor.

## Add bounded observation

For capture or waits in the client launcher, add
`"--enable-tool", "tmux_capture"` or `"--enable-tool", "tmux_wait"` to the
array passed to [`LibTmux::MCP::CLI.run`](<https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/reference/libtmux-mcp-cli-run-19of/>) in `run-mcp.rb`. Adding them to the
generated client configuration's arguments has no effect: the launcher does
not forward those arguments. Enable creation, input, close, or authored
execution only when the client needs those effects.
The [guides overview](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/guides/#enable-observation) explains the tool choices;
the [source-owned guide](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/source-guide/) gives their lifecycle contracts.

- [Page session metadata](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/examples/page-session-metadata/): Embed the MCP application, page two session names from one capture, and close owned resources.
- [Launch a client server](https://libtmux.org/en/ruby/v0.1.0.alpha.2/mcp/guides/connect-client/): Run a stdio MCP server with a private tmux daemon and a generated client configuration.