mcp-romm
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ROMM_URL | No | Your RomM instance URL | http://localhost:3000 |
| ROMM_PASSWORD | Yes | RomM password | |
| ROMM_USERNAME | Yes | RomM username | |
| ROMM_TLS_VERIFY | No | Verify TLS certificates | true |
| ROMM_REQUEST_TIMEOUT | No | Default request timeout (seconds) | 30 |
| ROMM_REQUEST_TIMEOUT_LONG | No | Timeout for slow endpoints | 60 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| romm_statusA | Check RomM MCP server configuration and reachability. |
| romm_statsA | Get library statistics — platform count, ROM count, saves, total size. |
| romm_platformsA | List platforms with ROM counts. |
| romm_library_itemsA | Browse ROMs — filter by platform, search term, or favorites. Paginated. platform_id: Filter to a single platform (use romm_platforms to find IDs). 0 = all. search: Text search in ROM names. favorite: Show only favorites (default: false). limit: Items per page (default 25, max 100). offset: Skip this many items (default 0). order_by: Sort field — "name", "fs_size_bytes", "updated_at" (default: name). order_dir: "asc" or "desc" (default: asc). |
| romm_recentA | Recently added or updated ROMs. limit: Number of results (default 20, max 100). |
| romm_get_itemA | Get full detail for a single ROM — metadata, user status, saves. rom_id: The ROM's ID (from romm_library_items or romm_search). |
| romm_searchA | Search ROMs by name across the library. query: Search term (required). platform_id: Filter to a single platform (0 = all). limit: Max results (default 20). |
| romm_search_by_hashC | Identify a ROM by file hash. Provide at least one hash value. crc_hash: CRC32 hash string. md5_hash: MD5 hash string. sha1_hash: SHA1 hash string. |
| romm_filtersA | Get available filter values for ROM browsing — genres, regions, languages, tags. |
| romm_collectionsB | List user-curated collections. |
| romm_collection_detailA | List ROMs in a specific collection. collection_id: The collection's ID (from romm_collections). |
| romm_smart_collectionsA | List auto-generated smart collections (rule-based). |
| romm_savesA | List save files. Filter by ROM or platform. rom_id: Filter to a specific ROM (0 = all). platform_id: Filter to a specific platform (0 = all). |
| romm_user_profileA | Browse ROMs by user status — favorites, now playing, backlogged, completed. status_filter: Filter by user status. Options: "now_playing", "backlog", "wishlist", "completed", "retired", "" (shows favorites). |
| romm_rom_notesA | View notes on a ROM. rom_id: The ROM's ID (from romm_library_items or romm_search). |
| romm_firmwareB | List BIOS/firmware files. Optionally filter by platform. platform_id: Filter to a specific platform (0 = all). |
| romm_devicesA | List registered devices (handhelds, emulators, etc.). |
| romm_tasksA | Check running and scheduled task status. |
| romm_scan_libraryA | Trigger a library rescan to discover new ROMs and platforms. This is a background task — it returns immediately. New ROMs will appear in the library as the scan progresses. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/lodordev/mcp-romm'
If you have feedback or need assistance with the MCP directory API, please join our Discord server