mcp-romm

Instructions

Implementation Reference

• server.py:940-960 (handler)

  The handler implementation for the 'romm_devices' MCP tool, which fetches and lists registered devices from the Romm API.

  @mcp.tool()
  async def romm_devices() -> str:
      """List registered devices (handhelds, emulators, etc.)."""
      data = await _get("devices")
  
      if not isinstance(data, list) or not data:
          return "No devices registered."
  
      lines = [f"Devices ({len(data)}):\n"]
      for d in data:
          name = d.get("name", "Unknown")
          device_type = d.get("type", "")
          device_id = d.get("id", "?")
  
          line = f"  - {name}"
          if device_type:
              line += f" ({device_type})"
          lines.append(line)
          lines.append(f"    ID: {device_id}")
  
      return "\n".join(lines)