Lets an agent see and operate a remote Windows desktop over a Moonlight/GameStream stream from Apollo or Sunshine.
Picture a Windows PC under your desk that already streams its desktop through Apollo or Sunshine. You work on a Mac or Linux laptop. The Moonlight Desktop MCP server lets your coding agent watch that stream and drive it, the way you would with a game controller app, only with mouse and keyboard events placed in the same coordinates as the captured frame.
This is visual computer use and nothing more. The agent sees what is rendered on the Windows Desktop and acts on it: opening an app, flipping a setting, closing a dialog. It has no shell on the remote machine, no registry access and no process list. Whether an installer finished or a licence is active is judged only from what is visible on screen. Some practical boundaries:
Pairing happens once. The agent calls host_status, then pairing_begin, which returns a PIN and the Apollo address to enter it at; pairing_status confirms. If the PC may be asleep, profile_wol_configure sets up Wake-on-LAN and host_wake uses it.
Each task then follows a fixed rhythm. Check desktop_channel_status and follow the next action it suggests, run session_preflight, then session_start, which always opens the Desktop. Capture with screen_capture, locate the target, send input, capture again to confirm. Finish with session_stop. provider_app_start exists for launching apps registered in Apollo, but only when you explicitly want that.
Every meaningful action is supposed to be checked against a fresh capture. That keeps the agent honest about what really happened on a machine it cannot otherwise inspect.
The Moonlight Desktop MCP server has no npm or npx package. A platform installer for macOS, Linux or Windows PowerShell builds a native Moonlight bridge and checks controller dependencies; rerun it to update. When the Codex CLI is present it registers itself there. Other clients are configured by hand using the separate install guide. Nothing is installed on the Windows host, which must already run Apollo or Sunshine with a Desktop app.
For automation on the local machine instead, see Windows Desktop Automation or the broader terminal and desktop category, alongside other developer tools.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| host_status | Inspect the configured Windows host before pairing or a session. |
| pairing_begin | Start pairing and return a PIN plus the Apollo URL where it is entered. |
| pairing_status | Confirm whether pairing has completed. |
| profile_status | Show the stored host profile. |
| profile_wol_configure | Configure Wake-on-LAN for a PC that may be asleep or off. |
| host_wake | Wake the host using the configured Wake-on-LAN settings. |
| desktop_channel_status | Check whether the desktop stream is available and return the suggested next action. |
| session_preflight | Run checks before starting a desktop session. |
| session_start | Open the Windows Desktop stream, with optional stream_profile and resolution, FPS and bitrate overrides. |
| session_status | Report the state of the current session. |
| session_stop | End the desktop session. |
| screen_capture | Capture the current frame of the remote desktop. |
| provider_app_start | Launch an app registered in Apollo, used only when explicitly requested. |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
This MCP server provides a set of tools that support AI-driven Development workflows.
An example Model Context Protocol Server for Tridion DXD
The world's first MCP-based web shop, built with WorkOS AuthKit and Next.js mcp-adaptor.
# MCP Terminal Server MCP Terminal Server provides terminal access and system tools via a clean web interface. It enables remote command execution