Romm MCP Server

MCP server for RomM — self-hosted game and ROM management platform

Remote serverstreamable-httpGo

What is the Romm MCP Server?

MCP server for RomM — self-hosted game and ROM management platform

What you get

Give your AI assistant full access to browse, search, and manage your retro game library.

  • Browse — your full ROM library with pagination, filtering, and sorting
  • Search — games by name across all platforms
  • Platforms — — list all platforms with ROM counts and metadata
  • Collections — — create, list, update, and delete game collections
  • ROM details — — full metadata including genres, companies, ratings, summaries
  • Firmware — — list available firmware files per platform

Configuration and credentials

  • Node.js >= 20.0.0 - A running RomM instance (v5.0+) - A RomM API key (rmm_* token)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded 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.

ToolWhat it does
romm_statsLibrary statistics — total platforms, ROMs, saves, states, screenshots, file size
romm_list_platformsList all platforms with ROM counts, categories, and slugs
romm_browse_romsBrowse and filter ROMs with pagination. Supports platform, collection, genre, company, region filters, and sorting
romm_get_romFull ROM details by ID — metadata, genres, companies, summary, rating, YouTube link
romm_search_romsSearch ROMs by name
romm_manage_collectionsCRUD collections (list, get, create, update, delete). Also supports smart and virtual collections
romm_get_collection_romsList all ROMs in a specific collection
romm_list_firmwareList firmware files available per platform
romm_download_romGenerate an authenticated download URL for a ROM
romm_update_romUpdate ROM metadata — display name, notes, favorite status
romm_rom_notesManage notes attached to a ROM (list, add, update, delete)
romm_manage_savesList save files, optionally filtered by ROM
romm_manage_statesList save state files, optionally filtered by ROM
romm_systemSystem operations — heartbeat, config, trigger library scan, metadata update
romm_screenshotsList screenshots, optionally filtered by ROM

How to install the Romm MCP Server

{
  "mcpServers": {
    "romm": {
      "command": "npx",
      "args": [
        "-y",
        "romm-mcp"
      ],
      "env": {
        "ROMM_BASE_URL": "http://your-romm-instance:5500",
        "ROMM_API_KEY": "YOUR_ROMM_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js >= 20.0.0 - A running RomM instance (v5.0+) - A RomM API key (rmm_* token)
VariableDescriptionRequired
ROMM_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
ROMM_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Romm MCP to romm stats.”
  • “Use Romm MCP to romm list platforms.”
  • “Use Romm MCP to romm browse roms.”

Frequently asked questions

MCP server for RomM — self-hosted game and ROM management platform Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.