mcp-romm

Instructions

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()