MCP Setup - RWAV Bridge

New here? Start with the MCP Quick Start for installation and first-run guidance, then return here to configure discovery and networking.

From your MCP client

Run tools_bridge_version_get or tools_bridge_connection_status and confirm connected:true with a version.

Configure MCP Discovery

Recommended (auto)

Set RWAV_DISCOVERY=auto and RWAV_BASE=auto in your MCP environment. The MCP server will discover via Bonjour/SSDP and verify with /capabilities.

Static fallback

Set RWAV_BASE=http://<bridge-host>:3002 if multicast is blocked. Optionally set RWAV_DEFAULT_ZONE=<zoneId> if you want a default playback zone.

Firewall & Network Tips

Allow inbound TCP 3002 to the Bridge host (LAN scope).
Allow UDP 5353 (mDNS) and UDP 1900 (SSDP) for discovery on the LAN.
Ensure the Bridge and Roon Core are on the same subnet/VLAN; avoid guest/Wi‑Fi isolation.

Headless (systemd) on Linux

Create a unit at /etc/systemd/system/rwav-bridge.service pointing to the Bridge binary:

[Service]
ExecStart=/usr/local/bin/rwav-bridge
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then:
sudo systemctl daemon-reload && sudo systemctl enable --now rwav-bridge
systemctl status rwav-bridge
curl http://localhost:3002/version

Upgrades

Stop the app/service.
Install the new version from rwav-bridge.co.uk.
Start the app/service, then re‑verify /version and /capabilities.

Troubleshooting

Bridge not listed in Roon Extensions

Toggle “Enable Extensions” off/on; restart Roon.
Reinstall/Restart the Bridge.
Verify same LAN/subnet; disable guest/Wi‑Fi isolation.

MCP can’t connect (discovery)

Try RWAV_BASE=http://<bridge-host>:3002.
Check firewall rules for TCP 3002; allow UDP 5353/1900.

404/timeout from endpoints

Confirm the Bridge process is running and /capabilities works locally.
If using a VPN, ensure local LAN access is enabled.

Quick Sanity Checklist

Roon Core running and signed in.
Roon Settings → Extensions → RWAV Bridge is Authorized/Enabled.
curl http://<bridge-host>:3002/capabilities returns JSON.
MCP discovery set to auto or static RWAV_BASE points to the Bridge host.
Basic tool call works (e.g., tools_bridge_version_get).