# tmux MCP for C++

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

> Build the native C++ MCP executable and use its platform-specific tmux tool catalog.

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

`libtmux-mcp-server` is a native executable that exposes tmux through
MCP over standard input and output. It is an optional consumer of the C++
library, enabled separately in the CMake build.

The catalog exposes discovery, creation, capture, input, search, and
bounded text waits. Native Windows advertises the same catalog, with
unsupported psmux operations failing explicitly at dispatch.

## Start here

- [Install](https://libtmux.org/en/cxx/latest/mcp/#install) points an MCP client at this server.
- [Tools](https://libtmux.org/en/cxx/latest/mcp/tools/) lists the MCP operations, arguments, and results.
- [Guides](https://libtmux.org/en/cxx/latest/mcp/guides/) build the executable and select an endpoint.
- [Topics](https://libtmux.org/en/cxx/latest/mcp/topics/) explain platform coverage, identifiers, and failures.
- [Examples](https://libtmux.org/en/cxx/latest/mcp/examples/) call a tool, then explore server internals.
- [Language API](https://libtmux.org/en/cxx/latest/mcp/reference/) documents embedding and implementation types.

Toolsets and exact tool names select the startup surface. The static
[`tmux://capabilities`](<https://libtmux.org/en/cxx/latest/mcp/resources/tmux-capabilities/>) resource reports it; workflow prompts and dynamic
resource templates are absent.

The [Workspace Manager](https://libtmux.org/en/cxx/latest/workspace/) is another source consumer. Its
configuration types are not part of the installed core API, and the MCP
server does not include a workspace-file operation.

[Executable and platform contract](https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/apps/mcp/README.md).