Check RomM MCP server configuration and reachability.

Get library statistics — platform count, ROM count, saves, total size.

List platforms with ROM counts.

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

Recently added or updated ROMs.

limit: Number of results (default 20, max 100).

Get full detail for a single ROM — metadata, user status, saves.

rom_id: The ROM's ID (from romm_library_items or 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).

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.

Get available filter values for ROM browsing — genres, regions, languages, tags.

List user-curated collections.

List ROMs in a specific collection.

collection_id: The collection's ID (from romm_collections).

List auto-generated smart collections (rule-based).

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

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

View notes on a ROM.

rom_id: The ROM's ID (from romm_library_items or romm_search).

List BIOS/firmware files. Optionally filter by platform.

platform_id: Filter to a specific platform (0 = all).

List registered devices (handhelds, emulators, etc.).

Check running and scheduled task status.

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.

Set your personal play status on a ROM. Modifies only your own user data.

Provide only the fields you want to change; omitted fields are left as-is.

rom_id: The ROM's ID (from romm_search or romm_library_items). status: Play status — one of "incomplete", "finished", "completed_100", "retired", "never_playing". Empty = leave unchanged. backlogged: true/false to mark/unmark backlogged. Omit to leave unchanged. now_playing: true/false to mark/unmark as currently playing. Omit to leave unchanged. rating: 0-10 rating. -1 (default) = leave unchanged. completion: 0-100 percent complete. -1 (default) = leave unchanged. mark_played: Set the last-played timestamp to now. clear_played: Clear the last-played timestamp (mutually exclusive with mark_played).

Add or remove a ROM from your Favorites.

In RomM, favorites are a special collection. This finds (or creates) your favorites collection and adds/removes the ROM.

rom_id: The ROM's ID. favorite: True to favorite (default), False to unfavorite.

Add a note to a ROM. The note belongs to you.

rom_id: The ROM's ID. title: Note title (required). content: Note body in markdown (optional). tags: Optional list of tag strings. is_public: Whether other RomM users can see the note (default: false).

Edit an existing note. Only the fields you provide are changed.

rom_id: The ROM's ID. note_id: The note's ID (from romm_rom_notes). title: New title (empty = unchanged). content: New body (empty = unchanged). tags: New tag list (omit to leave unchanged). is_public: New visibility (omit to leave unchanged).

Permanently delete a note. This cannot be undone.

rom_id: The ROM's ID. note_id: The note's ID (from romm_rom_notes).

Create a new user collection.

name: Collection name (required). description: Optional description.

Add one or more ROMs to a collection (without replacing the existing list).

collection_id: The collection's ID (from romm_collections). rom_ids: List of ROM IDs to add.

Remove one or more ROMs from a collection (without deleting the collection).

collection_id: The collection's ID (from romm_collections). rom_ids: List of ROM IDs to remove.

Permanently delete a collection. This cannot be undone.

The ROMs themselves are not deleted — only the collection grouping.

collection_id: The collection's ID (from romm_collections).