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
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| romm_status | Check RomM MCP server configuration and reachability. |
| romm_stats | Get library statistics — platform count, ROM count, saves, total size. |
| romm_platforms | List platforms with ROM counts. |
| romm_library_items | 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_recent | Recently added or updated ROMs. limit: Number of results (default 20, max 100). |
| romm_get_item | 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_search | 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_hash | 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_filters | Get available filter values for ROM browsing — genres, regions, languages, tags. |
| romm_collections | List user-curated collections. |
| romm_collection_detail | List ROMs in a specific collection. collection_id: The collection's ID (from romm_collections). |
| romm_smart_collections | List auto-generated smart collections (rule-based). |
| romm_saves | 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_profile | 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_notes | View notes on a ROM. rom_id: The ROM's ID (from romm_library_items or romm_search). |
| romm_firmware | List BIOS/firmware files. Optionally filter by platform. platform_id: Filter to a specific platform (0 = all). |
| romm_devices | List registered devices (handhelds, emulators, etc.). |
| romm_tasks | Check running and scheduled task status. |
| romm_scan_library | 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 | |