CLI Reference

All management happens through mux-cli:

CommandDescriptionExample
mux-cliInteractive menu (auto: setup if fresh, menu if configured)mux-cli
mux-cli --helpShow branded help with all commandsmux-cli --help
mux-cli setupFresh import from existing mcp.jsonmux-cli setup --from ~/.kiro/settings/mcp.json --yes
mux-cli add <name> [json]Add a server (interactive or one-liner)mux-cli add gitlab '{"type":"https","url":"..."}'
mux-cli remove <name>Remove a servermux-cli remove gitlab
mux-cli auth [name|--all]Trigger OAuth for HTTP server(s)mux-cli auth --all
mux-cli healthHealth check all serversmux-cli health
mux-cli listShow registered servers + auth statusmux-cli list
mux-cli statusShow Mux process infomux-cli status
mux-cli metricsUsage stats, charts, credit savings (%), token savingsmux-cli metrics
mux-cli keywords [name]View all keywords, or add/replace for a servermux-cli keywords gitlab
mux-cli updatePull latest code + rebuildmux-cli update

Add Examples

See all add examples 
# One-liner with raw MCP JSON (paste from your mcp.json)
mux-cli add my-gitlab '{"type":"https","url":"https://gitlab.example.com/api/v4/mcp"}'

# Stdio server with env vars
mux-cli add my-elastic '{"command":"uvx","args":["--python","3.12","elasticsearch-mcp-server"],"env":{"ELASTICSEARCH_HOSTS":"https://es.prod:9200"}}'

# Interactive (prompts for transport, URL/command, etc.)
mux-cli add my-server

# Interactive with JSON paste option
mux-cli add my-server
# → Choose "2) Paste JSON" → paste the server config object

Remove Examples

See remove examples 
mux-cli remove my-gitlab            # By name directly
mux-cli remove                       # Interactive (shows list, asks for name)

Auth Examples

See auth examples 
mux-cli auth --all                  # Auth ALL unauthorized HTTP servers one-by-one
mux-cli auth my-gitlab              # Auth a specific server (opens browser)
mux-cli auth                         # Interactive (shows HTTP servers + auth status, type 'all' or a name)