brew tap calibress/rwav
brew install rwav-bridge-mcp
# or
npm i -g @calibress/rwav-bridge-mcp

{
  "mcpServers": {
    "rwav": { "transport": "stdio", "command": "rwav-bridge-mcp" }
  }
}

\n

RWAV Bridge MCP

Control your Roon system using RWAV Bridge with an MCP‑aware client (Roo Code, VS Code, Copilot).

Auto discovery is enabled by default and should work once installed; you can optionally pin a base URL on constrained networks. See MCP Tools Reference for the full list of public tools.

Download RWAV Bridge: https://www.rwav-bridge.co.uk/downloads

Install

macOS / Linux (Homebrew)

brew tap calibress/rwav
brew install rwav-bridge-mcp

Windows / macOS / Linux (npm)

npm i -g @calibress/rwav-bridge-mcp

Configure Your MCP Host

Use stdio and the installed command (no absolute dev path):

{
  "mcpServers": {
    "rwav": {
      "transport": "stdio",
      "command": "rwav-bridge-mcp"
    }
  }
}

First Run

1. Install & run RWAV Bridge on the same network as your Roon Core:
   https://www.rwav-bridge.co.uk/downloads
2. Launch your MCP‑aware client; it will start rwav-bridge-mcp and auto‑discover the Bridge.

Connection & Health

• Status: tools_bridge_connection_status →
  { connected, health:'ok'|'unreachable', baseUrl, manualPinned }
• Manual base (pin):

  tools_bridge_set_base { url:"http://<bridge-ip>:3002", verify:true }

  Pins the base so discovery won’t override it.

• Unpin:

  tools_bridge_unset_base {}

  Allows discovery to update the base again.

Artwork

• LAN MCP: tools_image_resolve returns LAN image URLs from the Bridge.
• Relay: the same tool returns CDN URLs (https://cdn.rwav.app/…).
• Short/invalid keys: use tools_artwork_resolve with item context
  (item_key, optional zoneId/sessionId); the server validates image_key and advises how to resolve a proper one.

Playback Navigation (Queue‑First)

• For “skip to …”: always check the queue first
  1. tools_queue_get → locate the title
  2. tools_queue_play_from_here { queue_item_id }
• Verification: tools_queue_play_from_here includes
  verification_status and a verification_directive to use tools_now_playing_get when needed.

Zone ID Format

zoneId must be the Roon zone UUID (hex). Passing a display name (e.g., “Weiss”) is rejected.
Use tools_zones_list or set a default zone once and omit zoneId.

Troubleshooting

• Bridge not found: ensure RWAV Bridge is running; then retry.

  Downloads: https://www.rwav-bridge.co.uk/downloads

• Images: LAN MCP uses Bridge local resolver; Relay uses CDN.
• Stability: set a stable base with tools_bridge_set_base if discovery is blocked.