# tmux MCP for Rust

Source: https://libtmux.org/en/rs/latest/mcp/

> Run tmux-mcp or embed its typed tool surface in a Rust application.

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

`tmux-mcp` serves tmux over MCP stdio. It provides topology discovery,
terminal capture, command execution, bounded waits, and a static capability
resource.

Building requires Rust 1.88 or newer. Running requires tmux 3.3a or newer.
Toolsets select inspection, management, execution, and teardown. Read
[`tmux://capabilities`](<https://libtmux.org/en/rs/latest/mcp/resources/capabilities/>) for the effective startup selection.

## Start here

- [Install](https://libtmux.org/en/rs/latest/mcp/#install) points an MCP client at this server.
- [Tools](https://libtmux.org/en/rs/latest/mcp/tools/) lists the MCP operations, arguments, and results.
- [Guides](https://libtmux.org/en/rs/latest/mcp/guides/) connect a client and choose its tmux socket.
- [Topics](https://libtmux.org/en/rs/latest/mcp/topics/) explain toolsets, command waits, and capability discovery.
- [Examples](https://libtmux.org/en/rs/latest/mcp/examples/) run a Rust MCP client with a private tmux server.
- [Language API](https://libtmux.org/en/rs/latest/mcp/reference/) documents embedding and implementation types.

The Rust [Workspace Manager](https://libtmux.org/en/rs/latest/workspace/) is a separate crate. The current MCP catalog does not
include a workspace-file operation.

[Crate documentation and prerequisites](https://github.com/libtmux/libtmux-rs/blob/a6fc2a65674177b92b17fa380757155d2ba150fd/crates/tmux-mcp/README.md).