create_directory
ChatGPTCreate a directory on a paired computer, server, or VM. Use this when the user's task requires a new local folder.
edit_block
ChatGPTReplace exact text inside a file on a paired computer, server, or VM. Use this for precise user-requested edits when the existing text to replace is known.
force_terminate
ChatGPTForce-terminate a RelayDesk-managed process on a paired computer, server, or VM. Use this only when the user wants a started process stopped and graceful completion is not appropriate.
get_config
ChatGPTRead RelayDesk configuration from a paired computer or server. Use this when the user wants to inspect RelayDesk runtime settings before troubleshooting or changing them.
get_file_info
ChatGPTGet local file or folder metadata from a paired computer, server, or VM. Use this when the user needs size, timestamps, or file/directory type without reading contents.
get_install_command
ChatGPTCreate a short-lived single-use installer command for a Windows, macOS or Linux computer, bound ONLY to the RelayDesk account authenticated by this MCP connection. Ask the user for the operating system if it is not known. If the AI client has multiple RelayDesk account connections, FIRST ask which account should own the device, inspect who_am_i for the selected connection, and supply expected_account_id to prevent a connection mix-up. Never try to enroll under a different account by inventing owner IDs. Show the exact returned command in a copyable code block; say where to run it, then check list_devices after the installation. The generated command is a temporary account-enrollment capability: share it only privately with the intended user, and do not run it on an already paired different-account device without that account's ownership release.
get_more_search_results
ChatGPTRead more results from an existing RelayDesk file/content search. Use this after start_search when the user needs matching files or content.
interact_with_process
ChatGPTSend non-secret input to a running process on a paired computer, server, or VM. Use this when a user-requested interactive command or REPL is waiting for ordinary input. RelayDesk refuses input when the process is prompting for passwords, passphrases, API keys, tokens, MFA/OTP, or verification codes.
kill_process
ChatGPTTerminate an operating-system process by PID on a paired computer, server, or VM. Use this only when the user explicitly wants that local process stopped.
list_devices
ChatGPTList computers, servers, and VMs explicitly paired to the authenticated RelayDesk account, including live status. Use this when the user wants to see available RelayDesk devices or when another device tool needs a device_id.
list_directory
ChatGPTList files and folders on a paired computer, server, or VM. Use this to explore a local directory tree before reading, editing, moving, or searching files. Restricted authentication-secret directories and credential-bearing files are omitted.
list_processes
ChatGPTList operating-system processes on a paired computer, server, or VM. Use this when the user asks what is running or needs a PID before inspecting or terminating a process.
list_searches
ChatGPTList RelayDesk search sessions on a paired computer, server, or VM. Use this to inspect active or completed searches before reading results or stopping one.
list_sessions
ChatGPTList RelayDesk-managed process sessions on a paired computer, server, or VM. Use this to find processes previously started through RelayDesk and inspect their status.
move_file
ChatGPTMove or rename a file or folder on a paired computer, server, or VM. Use this when the user explicitly requests a local filesystem move or rename.
ping
ChatGPTCheck connectivity to an explicitly paired computer, server, or VM through RelayDesk without modifying files or processes. Use this when the user wants to verify a device is reachable before other remote work.
read_file
ChatGPTRead a text file from a paired computer, server, or VM. Use this when the user asks to inspect local file contents on one of their RelayDesk devices. RelayDesk blocks authentication-secret stores and credential-bearing files such as .env files, SSH/cloud credential directories, browser login stores, and private keys.
read_multiple_files
ChatGPTRead several text files from a paired computer, server, or VM in one request. Use this when the user wants to inspect or compare multiple local files. Authentication-secret stores and credential-bearing files are blocked.
read_process_output
ChatGPTRead output from a process previously started on a paired computer, server, or VM. Use this to inspect command results, logs, build output, or long-running process progress. Output is durably spooled to disk; use log_offset for absolute pagination across the full log.
set_config_value
ChatGPTChange a RelayDesk configuration value on a paired computer or server. Use this only when the user explicitly wants to update a supported RelayDesk setting; remote AI sessions cannot weaken blockedCommands or allowedDirectories.
shutdown
ChatGPTGracefully stop only the RelayDesk agent on an explicitly paired computer, server, or VM. Use this only when the user explicitly wants to disconnect RelayDesk on that device. It does not shut down the operating system.
start_privileged_process
ChatGPTRequest an explicit owner confirmation to reboot an owned paired computer. Only delayed restart commands are supported: Windows shutdown /r /t 60, Linux or macOS sudo -n shutdown -r +1. Do NOT invoke without the user's own request. First call returns a browser approval page and does not execute; after the owner approves that exact device/command, invoke again with identical arguments and approval_request_id. Requires agent 0.5.65 or later. Other blocked commands, secrets, script wrappers and immediate restarts remain denied.
start_process
ChatGPTStart a process or command on a paired computer, server, or VM. Use this when the user asks to run a local command, script, CLI, build, diagnostic, or other process. Explicit filesystem paths and the working directory are checked against allowedDirectories. Do not use this tool to read passwords, API keys, MFA/OTP codes, tokens, private keys, credential stores, or environment-secret dumps; RelayDesk blocks recognized secret-extraction patterns.
start_search
ChatGPTSearch filenames or file contents on a paired computer, server, or VM. Use this when the user wants to locate local files or find text across a local directory tree. Restricted authentication-secret stores and credential-bearing files are excluded from traversal.
stop_search
ChatGPTStop an active RelayDesk file/content search session. Use this when the requested search is complete or the user wants it cancelled.
who_am_i
ChatGPTGet the identity currently authenticated to RelayDesk. Use this when the user needs to confirm which RelayDesk account is connected.
write_file
ChatGPTCreate, overwrite, or append a text file on a paired computer, server, or VM. Use this when the user explicitly asks to create or modify a local text file. RelayDesk will not write into protected credential/secret stores or secret-bearing credential files.