romm_status
Check RomM MCP server configuration and reachability to verify system status and connectivity for management operations.
Instructions
Check RomM MCP server configuration and reachability.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- server.py:300-330 (handler)The handler function `romm_status` that fetches the RomM heartbeat/status information.
async def romm_status() -> str: """Check RomM MCP server configuration and reachability.""" lines = ["RomM MCP Status:\n"] lines.append(f" URL: {cfg.romm_url}") lines.append(f" Username: {cfg.romm_username}") lines.append(f" TLS verify: {cfg.tls_verify}") lines.append(f" Timeouts: {cfg.request_timeout}s / {cfg.request_timeout_long}s (long)\n") if not cfg.configured: lines.append(" Status: NOT CONFIGURED (set ROMM_USERNAME + ROMM_PASSWORD)") return "\n".join(lines) try: data = await _get("heartbeat", auth_required=False) if isinstance(data, dict): system = data.get("SYSTEM", {}) meta = data.get("METADATA_SOURCES", {}) fs = data.get("FILESYSTEM", {}) lines.append(" Connected: yes") lines.append(f" Version: {system.get('VERSION', '?')}") lines.append(f" IGDB enabled: {meta.get('IGDB_API_ENABLED', False)}") lines.append(f" ScreenScraper enabled: {meta.get('SS_API_ENABLED', False)}") lines.append(f" HLTB enabled: {meta.get('HLTB_API_ENABLED', False)}") platforms = fs.get("FS_PLATFORMS", []) lines.append(f" Filesystem platforms: {len(platforms)}") else: lines.append(" Connected: yes (unexpected response format)") except Exception as e: lines.append(f" Status: UNREACHABLE — {e}") - server.py:299-299 (registration)The MCP tool registration for `romm_status`.
@mcp.tool()