romm_saves
List and filter save files for ROMs by game or platform to manage gaming progress across your collection.
Instructions
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).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rom_id | No | ||
| platform_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- server.py:775-808 (handler)The handler for the romm_saves tool, which fetches save file information from the ROMM API based on optional rom_id and platform_id filters.
@mcp.tool() async def romm_saves(rom_id: int = 0, platform_id: int = 0) -> str: """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). """ params: dict = {} if rom_id: params["rom_id"] = rom_id if platform_id: params["platform_id"] = platform_id data = await _get("saves", params=params) if not isinstance(data, list) or not data: qualifier = "" if rom_id: qualifier += f" for ROM {rom_id}" if platform_id: qualifier += f" on platform {platform_id}" return f"No saves found{qualifier}." lines = [f"Saves ({len(data)}):\n"] for s in data[:50]: fname = s.get("file_name", "?") size = s.get("file_size_bytes", 0) rom_name = s.get("rom_name", "") platform = s.get("platform_slug", "") updated = s.get("updated_at", "") line = f" - {fname}" if rom_name: line += f" ({rom_name})"