MCP server for RomM — self-hosted game and ROM management platform
Romm MCP MCP server exists for a simple reason — assistants are far more useful when they can act on Romm MCP directly instead of describing what you should do. MCP server for RomM — self-hosted game and ROM management platform.
Give your AI assistant full access to browse, search, and manage your retro game library.
Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.
Once Romm MCP is connected, these are the calls the assistant has available:
romm_stats — Library statistics — total platforms, ROMs, saves, states, screenshots, file sizeromm_list_platforms — List all platforms with ROM counts, categories, and slugsromm_browse_roms — Browse and filter ROMs with pagination. Supports platform, collection, genre, company, region filters, and sortingromm_get_rom — Full ROM details by ID — metadata, genres, companies, summary, rating, YouTube linkromm_search_roms — Search ROMs by nameromm_manage_collections — CRUD collections (list, get, create, update, delete). Also supports smart and virtual collectionsromm_get_collection_roms — List all ROMs in a specific collectionromm_list_firmware — List firmware files available per platformromm_download_rom — Generate an authenticated download URL for a ROMromm_update_rom — Update ROM metadata — display name, notes, favorite statusromm_rom_notes — Manage notes attached to a ROM (list, add, update, delete)romm_manage_saves — List save files, optionally filtered by ROMYou will need 2 environment variables: ROMM_BASE_URL, ROMM_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
rmm_* token)Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Romm MCP's toolset — romm_stats, romm_list_platforms, romm_browse_roms and 11 more — is a fair guide to whether it matches your workflow. It is maintained by rodrigosiviero; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| romm_stats | Library statistics — total platforms, ROMs, saves, states, screenshots, file size |
| romm_list_platforms | List all platforms with ROM counts, categories, and slugs |
| romm_browse_roms | Browse and filter ROMs with pagination. Supports platform, collection, genre, company, region filters, and sorting |
| romm_get_rom | Full ROM details by ID — metadata, genres, companies, summary, rating, YouTube link |
| romm_search_roms | Search ROMs by name |
| romm_manage_collections | CRUD collections (list, get, create, update, delete). Also supports smart and virtual collections |
| romm_get_collection_roms | List all ROMs in a specific collection |
| romm_list_firmware | List firmware files available per platform |
| romm_download_rom | Generate an authenticated download URL for a ROM |
| romm_update_rom | Update ROM metadata — display name, notes, favorite status |
| romm_rom_notes | Manage notes attached to a ROM (list, add, update, delete) |
| romm_manage_saves | List save files, optionally filtered by ROM |
| romm_manage_states | List save state files, optionally filtered by ROM |
| romm_system | System operations — heartbeat, config, trigger library scan, metadata update |
{
"mcpServers": {
"romm": {
"command": "npx",
"args": ["-y", "romm-mcp"],
"env": {
"ROMM_BASE_URL": "http://your-romm-instance:5500",
"ROMM_API_KEY": "rmm_your_api_key_here"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
rmm_* token)| Variable | Description | Required |
|---|---|---|
| ROMM_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| ROMM_API_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.