mcp-romm

Instructions

Implementation Reference

• server.py:709-734 (handler)

  The handler function that retrieves and formats the collection details using the ROMM API.

  async def romm_collection_detail(collection_id: int) -> str:
      """List ROMs in a specific collection.
  
      collection_id: The collection's ID (from romm_collections).
      """
      data = await _get(f"collections/{collection_id}")
  
      if not isinstance(data, dict) or "id" not in data:
          return f"Collection {collection_id} not found."
  
      name = data.get("name", "Unknown")
      desc = data.get("description", "")
      roms = data.get("roms", [])
  
      lines = [f"{name}"]
      if desc:
          lines.append(f"  {desc[:200]}")
      lines.append(f"  ROMs: {len(roms)}\n")
  
      if isinstance(roms, list):
          for i, rom in enumerate(roms[:50], 1):
              if isinstance(rom, dict):
                  rom_name = rom.get("name") or rom.get("rom_name", "Unknown")
                  platform = rom.get("platform_display_name") or rom.get("platform_slug", "")
                  line = f"  {i}. {rom_name}"
                  if platform:

• server.py:708-709 (registration)

  Registration of the romm_collection_detail tool using the @mcp.tool() decorator.

  @mcp.tool()
  async def romm_collection_detail(collection_id: int) -> str: