romm_recent
Retrieve recently added or updated ROMs from your RomM library to track new content and changes.
Instructions
Recently added or updated ROMs.
limit: Number of results (default 20, max 100).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- server.py:446-483 (handler)The handler for the romm_recent tool, which fetches recently updated ROMs from the API and formats the output.
async def romm_recent(limit: int = 20) -> str: """Recently added or updated ROMs. limit: Number of results (default 20, max 100). """ limit = min(max(limit, 1), 100) params: dict = { "limit": limit, "offset": 0, "order_by": "updated_at", "order_dir": "desc", } data = await _get("roms", params=params, long_timeout=True) items = [] if isinstance(data, dict): items = data.get("items", []) elif isinstance(data, list): items = data if not items: return "No ROMs found." lines = [f"Recently updated ROMs ({len(items)}):\n"] for i, rom in enumerate(items, 1): name = rom.get("name", "Unknown") platform = rom.get("platform_display_name") or rom.get("platform_slug", "?") updated = rom.get("updated_at", "") rom_id = rom.get("id", "?") line = f" {i}. {name} [{platform}]" lines.append(line) if updated: lines.append(f" Updated: {updated}") lines.append(f" ID: {rom_id}") return "\n".join(lines) - server.py:445-445 (registration)Tool registration using @mcp.tool() decorator.
@mcp.tool()