# Relay Remotify MCP

> Relay Remotify MCP is an open-source MCP server for developer tools. Run shell commands on a remote machine through an HTTPS relay, no SSH needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, self-hosted
- **Website:** https://relay.remotify.run
- **Repository:** https://github.com/onlsol/relay.remotify.run/tree/HEAD/mcp
- **MCP Registry name:** io.github.onlsol/relay-remotify-mcp
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

Giving an AI agent a long-lived SSH credential is a risk many teams would rather avoid. This stdio server routes commands through an HTTP relay instead. You paste a one-line listener, which needs only curl and bash, on the remote machine, and the assistant pushes commands that wait until the listener picks them up.

In supervised mode the listener prints each command and waits for you to type y on the remote terminal before it runs. Adding ?mode=auto to the URL switches to unattended execution. Sessions use a random 128-bit key with no accounts, and the relay discards session data after three hours idle. The README says the MCP package sends no telemetry and only talks to the relay you point it at.

By default it uses the free public relay at relay.remotify.run, which is Apache-2.0 open source, so you can self-host it by setting REMOTIFY_URL. It suits hosts behind NAT, headless devices and CI boxes that can dial out but not in.

## Features

- **No SSH required:** The remote needs only curl and bash and outbound HTTPS, with no inbound ports.
- **Supervised approval:** Each command prints on the remote and waits for a y before running.
- **Auto mode:** Appending ?mode=auto runs commands without asking.
- **Asynchronous delivery:** Commands and results wait on the relay until the other side fetches them.
- **Self-hostable relay:** Point REMOTIFY_URL at your own instance of the Apache-2.0 relay.
- **Ephemeral sessions:** Keys are random hex with no account, and sessions are purged after 3 hours idle.

## Good for

- Let an assistant run commands on a server without handing it SSH access
- Check release state after a deploy on a box CI cannot reach
- Administer a machine behind NAT using only outbound HTTPS
- Reach headless or edge devices that can dial out but not in

## Install

### Claude Code (Terminal)

```sh
claude mcp add relay-remotify-mcp --env REMOTIFY_KEY='<REMOTIFY_KEY>' -- npx -y remotify-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "relay-remotify-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}
```

## Tools

- `remote_exec`: Sends a shell command to the remote listener and returns its output.
- `remote_session_info`: Shows the session details and listener one-liners to paste on the remote.
- `remote_session_reset`: Resets the relay session.

## FAQ

### Does the remote machine need anything installed?

No. The listener one-liner needs only curl and bash and leaves nothing installed.

### Can I approve each command?

Yes. In supervised mode the remote terminal prompts for y before each command; auto mode skips this.

### Can I host the relay myself?

Yes. The relay is Apache-2.0 open source and REMOTIFY_URL points the server at another instance.

### Which clients are documented?

Claude Code, Codex CLI, OpenCode, Cursor, Windsurf, Claude Desktop and Gemini CLI.

### Is Relay Remotify MCP free?

Yes. Relay Remotify MCP is open source, so you can use and self-host it for free.

### How do I add Relay Remotify MCP to Claude Code?

Run this command in your terminal: claude mcp add relay-remotify-mcp --env REMOTIFY_KEY='<REMOTIFY_KEY>' -- npx -y remotify-mcp

### What are the best alternatives to Relay Remotify MCP?

The closest alternatives to Relay Remotify MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/relay-remotify-mcp
