Remote Agents MCP server
{
"mcpServers": {
"47-ronn-remote-agents": {
"command": "npx",
"args": [
"-y",
"remote-agents@latest"
],
"env": {
"CLOUDFLARE_API_TOKEN": "<cloudflare_api_token>",
"REMOTE_AGENTS_TOKEN": "<remote_agents_token>"
}
}
}
}{
"mcpServers": {
"47-ronn-remote-agents": {
"command": "npx",
"args": [
"-y",
"remote-agents@latest"
],
"env": {
"CLOUDFLARE_API_TOKEN": "<cloudflare_api_token>",
"REMOTE_AGENTS_TOKEN": "<remote_agents_token>"
}
}
}
}{
"mcpServers": {
"47-ronn-remote-agents": {
"command": "npx",
"args": [
"-y",
"remote-agents@latest"
],
"env": {
"CLOUDFLARE_API_TOKEN": "<cloudflare_api_token>",
"REMOTE_AGENTS_TOKEN": "<remote_agents_token>"
}
}
}
}{
"servers": {
"47-ronn-remote-agents": {
"command": "npx",
"args": [
"-y",
"remote-agents@latest"
],
"env": {
"CLOUDFLARE_API_TOKEN": "${input:cloudflare_api_token}",
"REMOTE_AGENTS_TOKEN": "${input:remote_agents_token}"
}
}
},
"inputs": [
{
"id": "cloudflare_api_token",
"type": "promptString",
"description": "Cloudflare api token",
"password": true
},
{
"id": "remote_agents_token",
"type": "promptString",
"description": "Remote agents token",
"password": true
}
]
}{
"mcpServers": {
"47-ronn-remote-agents": {
"command": "npx",
"args": [
"-y",
"remote-agents@latest"
],
"env": {
"CLOUDFLARE_API_TOKEN": "<cloudflare_api_token>",
"REMOTE_AGENTS_TOKEN": "<remote_agents_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y remote-agentsversion 0.1.40
What it does
An MCP server for controlling fleets of remote machines through AI agents. Agents connect outbound to a relay and can execute commands, manage files, run git operations, and coordinate work across multiple hosts—all over end-to-end encrypted channels. For developers who need to orchestrate remote systems via Claude or other AI interfaces.
- Run shell commands and execute scripts across a fleet of remote machines and aggregate results by host.
- Transfer files and sync directories between remote machines using peer-to-peer UDP channels with automatic relay fallback.
- Schedule distributed MapReduce tasks across tagged subsets of your fleet to partition, process, and reduce data in parallel.
Tools this server exposes
| Tool | Does |
|---|---|
| exec | Execute shell commands on one or more remote agents, with results aggregated per host. |
| read | Read files from remote machines, across all agents or filtered by tags or OS family. |
| write | Write or modify files on remote hosts with optional backup mode and path/command allow-lists. |
| git | Drive git operations across remote agents—clone, pull, push, commit, or check status on multiple hosts. |
| send_file | Transfer a single file from one remote agent to another over a direct UDP/QUIC channel. |
| sync_dir | Sync directories between remote agents using rsync-like semantics with SHA-256 verification. |
| map_reduce | Partition data across the fleet, execute a shell command on each partition, and reduce the outputs with per-partition retry. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.