MCP server for controlling MiSTer-FPGA retro gaming system. Provides tools for launching games, searching ROM library, taking screenshots, managing system state, and executing shell commands on MiSTer hardware.
Read a configuration option from the current core's CFG file. These are persistent settings (like 'Aspect Ratio', 'Scanlines', etc.). Pass the option name to read its current value.
Write a configuration option to the current core's CFG file. These changes persist across resets. Pass the option name and value (typically a string matching the CONF_STR menu items).
Get MiSTer-FPGA system information including hostname, IP address, CPU temperature, RAM usage, disk space for all mounted volumes, and uptime. Useful for monitoring device health.
Send input to MiSTer-FPGA via virtual keyboard. Use 'key' for named keyboard keys (osd, menu, confirm, up, down, left, right, coin, start). Use 'raw' for Linux keycodes. Use 'combo' for key combinations (e.g. ['leftalt', 'f12']). Use 'text' to type a string character by character with correct keycodes and shift handling (e.g. 'LOAD"*",8,1\n').
Launch a game on MiSTer-FPGA by search query or direct ROM path. Use 'query' for fuzzy search (e.g. 'sonic 2') or 'path' for exact ROM path. Optionally filter by 'system' (e.g. 'SNES', 'MegaDrive', 'PSX'). Either 'query' or 'path' is required.
Get the OSD (On-Screen Display) menu structure for the currently loaded core or a specified core. Returns the parsed CONF_STR menu items including options, triggers, file loaders, and sub-pages. Useful for understanding what settings a core supports and what the OSD menu looks like.
Navigate the OSD menu on MiSTer-FPGA using directional inputs and selection. Allows programmatic OSD control to change settings or select menu items without manual input.
Get only the visible OSD menu items for the current core, based on the current CFG state. This shows which options are actually accessible given the current configuration (hidden options are filtered out). Useful for understanding the live OSD state.
Reload the currently loaded core (reset and reinitialize). Useful for refreshing the core state after configuration changes or to recover from a hang. Warning: This interrupts any running game.
Rescan the ROM library on MiSTer-FPGA. Discover new games added to the media folders. Takes a few seconds depending on library size.
Take a screenshot of what's currently displayed on MiSTer-FPGA. Returns the screenshot as a PNG image. Useful for seeing what game is running or verifying a launch succeeded.
Search the MiSTer-FPGA ROM library by name. Returns matching games with name, path, system, and storage location. Use 'system' to filter by platform. Results are fuzzy-matched and ranked by relevance.
Execute a shell command on MiSTer-FPGA and return the output. Use for file operations, system administration, or any task not covered by other tools. Commands run as the MiSTer user with full system access.
Get the current status of MiSTer-FPGA, including which core is loaded and what game (ROM) is running. Use this to check what's currently playing before launching something new.
Get detailed MiSTer-FPGA system information including hardware details, network configuration, and storage breakdown.
List all available systems (consoles/computers) on MiSTer-FPGA with their ROM counts and storage locations. Use this to discover what platforms are available before searching or launching games.
Manage Tailscale VPN on MiSTer-FPGA. Actions: 'setup' installs and configures Tailscale (returns auth URL if needed), 'status' shows connection state and IP, 'start' starts the daemon, 'stop' stops it. Tailscale enables secure remote access from anywhere.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 0 | 2026-07-28+ | v2 |