mcp-romm

Instructions

Implementation Reference

• server.py:653-674 (handler)

  The implementation of the `romm_filters` tool which fetches filter data (genres, regions, etc.) from the ROMM API and formats it into a string summary.

  async def romm_filters() -> str:
      """Get available filter values for ROM browsing — genres, regions, languages, tags."""
      data = await _get("roms/filters", long_timeout=True)
  
      if not isinstance(data, dict):
          return "No filter data available."
  
      lines = ["Available ROM Filters:\n"]
  
      for key in ("genres", "franchises", "collections", "companies", "regions",
                  "languages", "tags"):
          values = data.get(key, [])
          if values:
              display = ", ".join(str(v) for v in values[:30])
              if len(values) > 30:
                  display += f"... (+{len(values) - 30} more)"
              lines.append(f"  {key.title()} ({len(values)}): {display}")
  
      if len(lines) == 1:
          return "No filters available (library may be empty)."
  
      return "\n".join(lines)