misterclaw

MiSTerClaw is the first MCP server for MiSTer-FPGA. Control your MiSTer from any AI agent.

-blue)

MiSTerClaw lets AI agents — Claude, ChatGPT, OpenClaw, Hermes, Cursor, and others — control a MiSTer-FPGA over the network. Launch games, search your ROM library, take screenshots, read and modify core settings and DIP switches, navigate the OSD menu, manage the system, and even set up Tailscale VPN for secure remote access from anywhere. It uses the Model Context Protocol (MCP) standard, so any MCP-compatible client works out of the box. For agents without MCP support, a CLI client is also included.

Add MiSTerClaw to your MCP client config:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "misterclaw": {
      "command": "/path/to/misterclaw-mcp",
      "args": ["--host", "mister-fpga"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "misterclaw": {
      "command": "/path/to/misterclaw-mcp",
      "args": ["--host", "mister-fpga"]
    }
  }
}

| Tool | Description | |------|-------------| | mister_status | What's currently playing | | mister_launch | Launch a game by search or path | | mister_search | Search the ROM library | | mister_systems | List all available systems with ROM counts | | mister_screenshot | Take a screenshot (returns PNG image) | | mister_info | System info (hostname, IP, temp, RAM, disks, uptime) | | mister_input | Send keyboard input (OSD navigation, named keys) | | mister_osd_info | Query OSD menu structure from CONF_STR database | | mister_osd_visible | Show