RomM MCP Server
An MCP server for RomM — the self-hosted retro game library manager. 40 tools: 26 read-only for browsing platforms, searching ROMs, viewing metadata, collections (regular, smart, and virtual), saves, play activity, and tasks — plus 14 write tools for play status, play sessions, favorites, notes, and collection management, through any MCP-compatible AI assistant.
Tools
Read
| Tool | Description |
|---|---|
romm_status |
Check server configuration and reachability |
romm_stats |
Library-wide statistics (platforms, ROMs, saves, total size) |
romm_platforms |
List platforms with ROM counts and sizes |
romm_library_items |
Browse ROMs with filtering and pagination |
romm_recent |
Recently added or updated ROMs |
romm_get_item |
Full ROM detail — metadata, saves, user status |
romm_search |
Search ROMs by name |
romm_search_by_hash |
Identify a ROM by file hash (CRC, MD5, SHA1, or RetroAchievements) |
romm_filters |
Available filter values (genres, regions, languages, tags) |
romm_collections |
List user-curated collections |
romm_collection_detail |
List ROMs in a specific collection |
romm_smart_collections |
List auto-generated smart collections |
romm_saves |
List save files by ROM or platform |
romm_user_profile |
Browse by status (now playing, backlog, completed, etc.) |
romm_rom_notes |
View notes on a ROM |
romm_firmware |
List BIOS/firmware files per platform |
romm_devices |
List registered devices |
romm_tasks |
List registered tasks (schedule, manual-run availability) and running status |
romm_scan_library |
Trigger a background library rescan (blocked over REST on RomM 5.0 — see Known issues) |
romm_activity |
Recent play activity feed — who played what, when (5.0+) |
romm_play_sessions |
List recorded play sessions with durations (5.0+) |
romm_virtual_collections |
Automatic groupings by genre/franchise/company/etc. (5.0+) |
romm_virtual_collection_detail |
List ROMs in a virtual collection (5.0+) |
romm_smart_collection_detail |
A smart collection's rules and matching ROMs (5.0+) |
romm_whoami |
Authenticated account, role, and effective permissions |
romm_metadata_search |
Search metadata providers (IGDB etc.) for ROM matches (5.0+) |
