Shell Drop

sh.shelldropPublished by shelldrop.shOfficial publisherv0.1.0Updated Nov 11, 2026

Read-only help with SSH, tmux and Tailscale setup for running AI agents from an iPhone or iPad.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Read-only remote MCP server that gives an assistant setup and troubleshooting guidance for running CLI coding agents on a Mac or Linux box and reaching them…

What you can do
  • Walk through setting up a macOS or Linux machine for phone access: SSH, tmux, Tailscale, keep-awake and SSH keys
  • Look up exact tmux commands for phone use: attach, detach, list, kill, scrollback, mouse, copy, rename, sessions, windows and panes
  • Generate a phone-friendly tmux configuration snippet with instructions for applying it
  • Diagnose common phone-to-machine problems such as timeouts, refused connections, missing sessions and clipboard not reaching the phone
When to use it
Useful when you want to drive a CLI coding agent on a desktop or server from an iPhone or iPad and need step-by-step setup, tmux command references or help fixing a broken remote connection.
Requirements
A remote endpoint at mcp.shelldrop.sh over Streamable HTTP; no authentication, API keys or environment variables are declared. The guidance assumes a macOS or Linux machine, SSH, tmux and Tailscale, and the Shell Drop app on the phone.
Before you install
The tools only return text and do not change anything on any machine, so any setup steps they describe must be carried out by you. The server is stateless and declares no auth; the README states it does not log inputs.

Installation

In SourceWeft

  1. Open Shell Drop in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/sh.shelldrop%2Fshelldrop/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "shell-drop": {
      "type": "http",
      "url": "https://mcp.shelldrop.sh/mcp"
    }
  }
}

README

shelldrop-mcp

Read-only remote MCP server for Shell Drop, intended for https://mcp.shelldrop.sh/mcp. A stateless Cloudflare Worker speaking Streamable HTTP: a fresh MCP server per request, JSON responses, no sessions, no storage, no auth, no logging of inputs.

bash
npm installnpm test            # unit tests plus JSON-RPC over the Worker's fetch handlernpm run typechecknpx wrangler dev    # local server at http://localhost:8787/mcp

Tools: setup_guide, tmux_howto, generate_tmux_conf, troubleshoot_connection. All answers live in src/content.ts, derived from ../skills/shelldrop-remote-setup/SKILL.md and https://shelldrop.sh/tmux-cheat-sheet/.

Deploy: npx wrangler deploy (custom domain mcp.shelldrop.sh). GET / redirects to the docs page https://shelldrop.sh/mcp/.

Source: mcp-server/README.md at commit 6c4bcdc

Tools

4

setup_guide

Setup guide

Step-by-step guide to set up a macOS or Linux machine so AI agents can be run and checked from an iPhone or iPad: SSH, tmux, Tailscale, keep-awake, SSH key, verify.

Parametersosrequired

tmux_howto

tmux how-to

Exact tmux commands for common tasks from a phone: attach, detach, list, kill, scrollback, mouse, copy, rename, new session, windows and panes.

Parameterstaskrequired

generate_tmux_conf

Generate tmux.conf

Return a phone-friendly ~/.tmux.conf snippet (session-name titles, mouse scrolling, OSC 52 clipboard, long history, optional Ctrl-a prefix) plus how to apply it.

Parametersmouseprefixset_titleshistory_limitset_clipboard

troubleshoot_connection

Troubleshoot connection

Fixes for common phone-to-machine problems: connection timeout, connection refused, tmux "can't find session", copy from tmux not reaching the phone.

Parameterssymptomrequired

Version history

1
  1. v0.1.0LatestNov 11, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts