Installation

You can run MUTX as local binaries or as containers.

Components

• mutx-tui: interactive terminal application; this is the authority process
• mutx-mcp: MCP server; this is the agent-facing process

In normal use, you run both.

Binary install

TUI

Linux x86_64:

curl -LO https://download.mutx.net/tui/latest/mutx-tui-linux-x86_64
chmod +x mutx-tui-linux-x86_64
sudo mv mutx-tui-linux-x86_64 /usr/local/bin/mutx-tui

macOS Intel:

curl -LO https://download.mutx.net/tui/latest/mutx-tui-macos-intel
chmod +x mutx-tui-macos-intel
sudo mv mutx-tui-macos-intel /usr/local/bin/mutx-tui

macOS Apple Silicon:

curl -LO https://download.mutx.net/tui/latest/mutx-tui-macos-arm
chmod +x mutx-tui-macos-arm
sudo mv mutx-tui-macos-arm /usr/local/bin/mutx-tui

MCP server

Linux x86_64:

curl -LO https://download.mutx.net/mcp/latest/mutx-mcp-linux-x86_64
chmod +x mutx-mcp-linux-x86_64
sudo mv mutx-mcp-linux-x86_64 /usr/local/bin/mutx-mcp

macOS Intel:

curl -LO https://download.mutx.net/mcp/latest/mutx-mcp-macos-intel
chmod +x mutx-mcp-macos-intel
sudo mv mutx-mcp-macos-intel /usr/local/bin/mutx-mcp

macOS Apple Silicon:

curl -LO https://download.mutx.net/mcp/latest/mutx-mcp-macos-arm
chmod +x mutx-mcp-macos-arm
sudo mv mutx-mcp-macos-arm /usr/local/bin/mutx-mcp

Verify

mutx-tui --version
mutx-mcp --version

Container images

Published images:

• ghcr.io/mutx-net/tui:latest
• ghcr.io/mutx-net/mcp:latest

Run the TUI interactively:

docker run --rm -it \
  -v "$HOME/.config/mutx:/home/mutx/.config/mutx" \
  -v "$HOME/.local/share/mutx:/home/mutx/.local/share/mutx" \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/tui:latest

Run the MCP server in HTTP mode:

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mcp:latest

The shared /tmp/mutx mount is mandatory. Without it, the MCP container cannot reach the TUI socket and the two processes will not communicate.

Common deployment shapes

Host TUI plus containerized MCP:

mutx-tui

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mcp:latest

Containerized TUI plus containerized MCP:

docker run --rm -it \
  -v "$HOME/.config/mutx:/home/mutx/.config/mutx" \
  -v "$HOME/.local/share/mutx:/home/mutx/.local/share/mutx" \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/tui:latest

docker run --rm \
  -p 8000:8000 \
  -v /tmp/mutx:/tmp/mutx \
  ghcr.io/mutx-net/mcp:latest

Quick binary start

If you want the shortest local path, run the binaries directly:

mutx-tui
mutx-mcp

Requirements

• A terminal with TTY support for mutx-tui
• The TUI must be running before mutx-mcp
• Solana RPC access for wallet and swap operations

Continue to Quick Start.