mcp-romm

Instructions

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})"