Skip to main content
Glama

FeuSh MCP

Let your AI agent work on another computer. Claude Code, Cursor, Codex, VS Code or any MCP client can run commands, take screenshots and move files on a remote Windows, macOS or Linux machine, using a 9-digit number, a key and the owner's approval.

FeuSh is like AnyDesk for the terminal, made for AI: the person on the other side shares their computer from the FeuSh app, you tell your agent what to fix, and they see every command before it runs.

You:     The PC at 611 267 918 doesn't print. Key 7KX-42P. Check it and tell me before changing anything.
Agent:   exec → Get-Printer, Get-Service Spooler, Get-PrintJob …
         The spooler is stopped and there are 14 stuck jobs. Do you want me to restart it?

Website · Docs · Download · Pricing · Español

Install

You need Node.js 18 or later. The first run downloads the official feu command from feush.com and checks its signature. If feu is already installed, it uses that.

Claude Code

claude mcp add feush -- npx -y feush-mcp

Cursor (~/.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf and other clients:

{
  "mcpServers": {
    "feush": {
      "command": "npx",
      "args": ["-y", "feush-mcp"]
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "feush": { "type": "stdio", "command": "npx", "args": ["-y", "feush-mcp"] }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.feush]
command = "npx"
args = ["-y", "feush-mcp"]

Without Node.js, install feu and use feu mcp as the command:

curl -fsSL https://feush.com/install.sh | sh        # macOS and Linux
irm https://feush.com/install.ps1 | iex             # Windows (PowerShell)

Related MCP server: remote-desktop-commander

How it works

  1. The person who needs help installs the FeuSh app and taps Share. They get a 9-digit number and a key that changes every time.

  2. They give you the number and the key. You pass them to your agent in the chat, or put the key in FEU_PASSWORD when you start the server so it never goes into the conversation.

  3. The first time the agent connects, FeuSh asks the person «Allow?». Nobody gets in without that yes; with no answer in 60 seconds the connection is refused.

  4. The agent works. The person sees every command before it runs and can stop everything at any moment. Everything goes to a log on their computer.

Tools

Tool

What it does

exec

Runs a command (PowerShell, cmd, bash or zsh) and returns stdout, stderr and the exit code. Up to 600 s.

screenshot

Saves a PNG of the other screen.

put / get

Sends or brings one file, up to 1 GiB, checking its SHA-256.

computers

Lists the computers saved with a name (feu book add office 611267918).

disconnect

Closes the session with a computer.

guide

Short instructions for the agent: safe recipes for Windows, macOS and Linux, and the error codes.

The session stays open: the key and the approval happen once, not on every command.

Security

  • Approval on the other side. Every new connection needs the person's yes, and they can stop it at any time.

  • End-to-end encryption. Computers connect directly when the network allows; otherwise traffic goes through a relay that cannot read it.

  • Brute-force lockout. The key changes with every share; after 20 wrong keys FeuSh refuses connections for 10 minutes.

  • Signed binaries. This package downloads feu only over HTTPS and only runs it if the minisign signature matches the FeuSh release key and names the right file for your platform.

  • Local log. The log stays on the shared computer (feu log). Command output is never stored.

Plans

The Free plan needs no account, key or card. It is for helping family and friends: up to 5 different computers a month, one open at a time, and your AI on one computer. Pro ($12 per person a month, or $10 paying yearly) is for technicians and teams who charge for helping: unlimited computers, 10 open at a time and your AI on several at once. Getting help is always free; only the person who helps pays.

Compared with

  • AnyDesk / TeamViewer: made for people looking at a screen. FeuSh gives an agent a real terminal with exit codes and files, and keeps the human approval.

  • SSH: needs open ports, accounts and keys on the other side. FeuSh works behind NAT and firewalls with only a number and a one-time key, and the owner approves.

  • Remote shell MCP servers: most of them assume you already have SSH or a server. FeuSh includes the connection, the approval and the app for the person you are helping.

About this repository

This repository holds the npx feush-mcp launcher (MIT license) and the setup docs. FeuSh itself (the app and feu) is downloaded from feush.com. Questions: hello@feush.com.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables full local computer control from MCP clients, including terminal commands, file system operations, application management, screen capture, and input device automation across Windows, macOS, and Linux.
      27
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables secure remote access to your computer's filesystem and terminal through MCP, allowing AI assistants to manage files, run commands, and automate tasks from anywhere via a hosted relay.
      223
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to remotely control multiple computers via MCP: run commands, manage files, install software, view and control screens, and execute parallel tasks across machines.
      6 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients such as ChatGPT to execute shell commands, manage files, and view or capture images on Mac and Linux hosts. Supports terminal-based connection approval, time-limited access, and output controls.
      MIT