Nexus Shell Agent Bridge

Official
Other

Native macOS SSH client with 26 local MCP tools for visible terminals, SFTP, SSH keys, connections, and read-only observability. Credentials stay inside the app.

About Nexus Shell Agent Bridge MCP Server

Native macOS SSH client with 26 local MCP tools for visible terminals, SFTP, SSH keys, connections, and read-only observability. Credentials stay inside the app.

Features

Tools
Getting Started

Requires an Apple Silicon Mac with macOS 14.2 or later. Install the signed direct-download or Homebrew build (`brew install --cask viewer12/tap/nexus-shell`). Open Nexus Shell, enable **Settings -> Agent Bridge**, paste the setup instruction shown by the app into your MCP client, then approve the client inside Nexus Shell on its first tool call. Agent Bridge is not included in TestFlight or Mac App Store builds.

Tools (26)
Functions this server exposes to AI clients

list_connections

List saved SSH connections without returning credentials.

get_connection

Read non-secret details for one saved connection.

create_connection

Create a saved SSH connection.

update_connection

Update a saved SSH connection.

delete_connection

Delete a saved SSH connection.

test_connection

Test whether a saved SSH connection can connect.

open_terminal

Open a real, visible terminal tab for a saved connection.

list_terminals

List terminal sessions currently visible in Nexus Shell.

send_text

Send text to a visible terminal session.

run_command

Run a command in a visible terminal and return its output.

read_terminal

Read available output from a visible terminal session.

close_terminal

Close a terminal session.

exec_command

Execute a command through a saved SSH connection.

sftp_list

List files in a remote directory over SFTP.

sftp_read_file

Read a remote file over SFTP.

sftp_write_file

Write content to a remote file over SFTP.

sftp_upload

Upload a local file over SFTP.

sftp_download

Download a remote file over SFTP.

sftp_mkdir

Create a remote directory over SFTP.

sftp_delete

Delete a remote file or directory over SFTP.

sftp_rename

Rename or move a remote file over SFTP.

list_keys

List SSH key metadata without returning private key material.

generate_key

Generate a new SSH key inside Nexus Shell.

deploy_public_key

Deploy a public key to a saved SSH server.

list_monitors

List read-only monitoring definitions and status.

list_session_logs

List local session-log metadata without terminal contents.

Example
brew install --cask viewer12/tap/nexus-shell