// MCP TOOL REFERENCE

CMUX AGENT TOOLS

63 tools from the Cmux Agent MCP Server, categorised by risk level.

View the Cmux Agent policy →
// ALL 63 CMUX AGENT TOOLS
READ 21 tools
Read cmux_browser_get Get data from the browser page (url, title, text, html, value, attribute, element count). Read cmux_browser_screenshot Take a screenshot of the browser page. Read cmux_browser_snapshot Get a DOM accessibility snapshot of the browser page. Read cmux_current_window Get the currently focused window. Read cmux_current_workspace Get the currently active workspace. Read cmux_find Search across windows and panes by content or title. Read cmux_identify Show context info for the current CMUX session — focused window, workspace, pane, surface refs. Call this f... Read cmux_list_notifications List unread notifications. Read cmux_list_panels List all panels in a workspace. Read cmux_list_panes List all panes in a workspace. Read cmux_list_status List all sidebar status entries for a workspace. Read cmux_list_windows List all open windows. Read cmux_read_all_deep Deep read of ALL panes. For idle CLI agents, prompts them asking Read cmux_read_screen Read terminal output from a single surface. Works on all surface types. Use --scrollback to include scroll ... Read cmux_screenshot Take a screenshot of the CMUX window using macOS screencapture. Read cmux_sidebar_state Get current sidebar state (cwd, git branch, ports, status, progress, logs). Read cmux_status Check if CMUX is installed and running. Shows project config and full hierarchy. IMPORTANT: All cmux tools ... Read cmux_tree Show full hierarchy tree of windows, workspaces, panes, surfaces, and panels. Read cmux_workspace_snapshot Full workspace snapshot: tree + all pane output + sidebar state. Single call for complete situational aware... Read cmux_capture_pane Capture pane output (tmux-compatible). Works on all surface types. Read cmux_session_reconcile Compare saved session manifest against what is actually running in CMUX. Reports drift: surfaces that disap...
WRITE 8 tools
Write cmux_new_workspace Create a new workspace. Returns the workspace_ref so you can use it immediately without a follow-up list call. Write cmux_break_pane Move a pane to its own new workspace. Write cmux_move_surface Move a surface to a different pane, workspace, or window. Write cmux_move_workspace_to_window Move a workspace to a different window without closing it. Write cmux_reorder_surface Reorder a tab within its pane — change its position without closing it. Write cmux_reorder_workspace Reorder a workspace in the SIDEBAR — change its position without closing it. Write cmux_session_save Save current CMUX state (workspaces, panes, CLIs, session IDs) to a manifest for crash recovery. Call this ... Write cmux_swap_pane Swap two panes.
DESTRUCTIVE 5 tools
Destructive cmux_clear_notifications Clear all notifications. Destructive cmux_close_all Close ALL workspaces (or all except specific ones). Use Destructive cmux_close_surface Close a surface (tab). Destructive cmux_close_window Close a window. Destructive cmux_close_workspace Close one or more workspaces and all their panes. Pass a single ref or an array of refs.
EXECUTE 29 tools
Execute cmux_browser_console Get or clear browser console logs/errors. Execute cmux_batch Execute multiple CMUX operations in a single MCP call. Each step references an existing cmux tool by name a... Execute cmux_browser_eval Execute JavaScript in the browser page. Execute cmux_browser_navigate Navigate the browser: goto a URL, or go back/forward/reload. Execute cmux_browser_wait Wait for a condition in the browser (selector, text, URL, load state). Execute cmux_new_pane Create a new pane (terminal or browser) in a workspace. Returns the new surface ref. Execute cmux_new_split Split an existing pane. Returns the new surface ref and updated pane count. - Execute cmux_new_surface Create a new surface (tab) — terminal or browser. Execute cmux_new_window Create a new window. Returns the window ref. Execute cmux_respawn_pane Restart a pane process. Execute cmux_start Launch CMUX if not already running. Opens the cmux.app. Execute cmux_browser_click Click an element in the browser. Execute cmux_browser_fill Fill an input field in the browser. Execute cmux_browser_open Open a browser surface (split in the current workspace). Execute cmux_browser_tab Manage browser tabs (new, list, switch, close). Execute cmux_browser_type Type text into an element in the browser (key by key). Execute cmux_drag_surface_to_split Move a tab into a split position — turns a tab into its own pane by dragging it to a side. Does not close t... Execute cmux_focus_pane Focus a specific pane. Execute cmux_focus_window Focus a specific window. Execute cmux_join_pane Join a pane into another pane — merges two split panes together without closing either. The opposite of bre... Execute cmux_resize_pane Resize a pane in a direction. Execute cmux_select_workspace Switch to a specific workspace. Execute cmux_send Send text to a surface without pressing Enter. Works on all surface types (plain terminals and AI CLI agents). Execute cmux_send_key Send a key press to a surface (enter, tab, escape, backspace, delete, up, down, left, right, ctrl+c, etc.).... Execute cmux_send_key_all Send a key (e.g., ctrl+c, escape) to ALL panes in a workspace. Useful for cancelling all agents. Execute cmux_send_panel Send text to a specific panel. Execute cmux_send_submit Send text and press Enter to a surface. Works on all surface types (plain terminals and AI CLI agents). Execute cmux_send_submit_some Send the same text + Enter to SPECIFIC surfaces (not all). Target by surface refs — useful when only some a... Execute cmux_session_recover Recover a crashed CMUX session from the saved manifest. Recreates all workspaces, panes, and RESUMES each CLI

Route Cmux Agent through PolicyLayer and every one of its 63 tools is checked against your policy before it runs.

CHECK YOUR STACK →

See every tool, the dangerous ones, and the token cost across your stack.

// FAQ
How many tools does the Cmux Agent MCP server have? +

The Cmux Agent MCP server exposes 63 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Cmux Agent tools? +

Route the Cmux Agent server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Cmux Agent tools fall into? +

Cmux Agent tools are categorised as Read (21), Write (8), Destructive (5), Execute (29). Each category has a recommended default policy.

Enforce policy on every Cmux Agent tool call.

Start from Cmux Agent, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.