mcp-romm

Instructions

Implementation Reference

• server.py:746-772 (handler)

  The `romm_smart_collections` tool handler, which fetches smart collections from the ROMM API and formats them for the user.

  @mcp.tool()
  async def romm_smart_collections() -> str:
      """List auto-generated smart collections (rule-based)."""
      data = await _get("collections/smart")
  
      if not isinstance(data, list) or not data:
          return "No smart collections found."
  
      lines = [f"Smart Collections ({len(data)}):\n"]
      for c in data:
          name = c.get("name", "Unknown")
          desc = c.get("description", "")
          cid = c.get("id", "?")
  
          lines.append(f"  {name}")
          if desc:
              short = desc[:100]
              if len(desc) > 100:
                  short += "..."
              lines.append(f"    {short}")
          lines.append(f"    ID: {cid}")
          lines.append("")
  
      return "\n".join(lines)
  
  
  # ── Tools — Saves & User Status ──────────────────────────────────────────