RWAV Bridge MCP

Core AI Capabilities

Intelligent Music Discovery

  • Unified Search: tools_search_run provides AI with comprehensive search across Library, TIDAL, and Qobuz in a single operation, returning structured results with artwork and session context.
  • Smart Content Resolution: AI can leverage tools_track_variants_open to discover and present multiple versions of tracks (remixes, live, acoustic) with intelligent canonical selection.
  • Context-Aware Browsing: AI can navigate hierarchical content structures using tools_node_open, tools_list_children, and tools_get_actions for deep exploration.

Advanced Playlist Intelligence

  • Dynamic Playlist Building: tools_playlist_plan enables AI to create sophisticated transient playlists with strategic positioning (append vs addnext) and artwork integration.
  • Batch Processing: tools_playlist_execute supports AI-driven bulk operations with verification, error recovery, and position tracking.
  • Intelligent Track Selection: AI can use tools_library_tracks_pick, tools_genre_tracks_pick, and specialized pickers for curated content discovery.

Multi-Zone Audio Orchestration

  • Zone Intelligence: tools_zones_list and tools_outputs_list provide AI with comprehensive zone topology for intelligent audio routing decisions.
  • Dynamic Grouping: tools_group_zones and tools_ungroup_zones enable AI to create adaptive audio environments based on context.
  • Seamless Transfer: tools_transfer_playback allows AI to move audio experiences between zones while maintaining playback state.

AI-Enhanced Content Exploration

Artist & Album Intelligence

  • Artist Hub Navigation: tools_artist_open provides AI with comprehensive artist overviews including actions, top tracks, and album collections.
  • Album Context Analysis: tools_album_open delivers album-level intelligence with track listings, artwork, and actionable insights.
  • Genre-Based Discovery: tools_genres_list and genre-specific tools enable AI to create mood and style-based experiences.

Streaming Service Integration

  • TIDAL Intelligence: tools_tidal_open and TIDAL-specific tools give AI access to curated content, new releases, and personalized recommendations.
  • Qobuz Integration: tools_qobuz_open provides AI with high-fidelity content discovery and classical music expertise.
  • Cross-Source Resolution: AI can intelligently select the best source (Library -> TIDAL -> Qobuz) based on content availability and quality.

Live Radio & Dynamic Content

  • Radio Station Intelligence: tools_live_radio_list and playback tools enable AI to curate live radio experiences based on user preferences.
  • Real-Time Content: AI can leverage live radio for dynamic, always-fresh content experiences.
  • Station Discovery: Intelligent station selection based on genre, mood, and listening patterns.

AI-Powered Playback Control

Intelligent Transport Control

  • Context-Aware Playback: tools_now_playing_get provides AI with real-time playback state for intelligent decision-making.
  • Smart Transport Operations: tools_now_playing_playpause, tools_now_playing_next, and tools_now_playing_previous enable AI to manage playback based on context.
  • Precision Control: tools_now_playing_seek allows AI to implement intelligent seeking based on content analysis and user behavior.

Queue Intelligence

  • Smart Queue Management: tools_queue_get provides AI with comprehensive queue state for intelligent playlist management.
  • Position-Aware Operations: tools_queue_play_from_here enables AI to implement intelligent queue navigation based on context.
  • Queue Analytics: tools_queue_head_get and tools_queue_tail_get provide efficient queue state verification for AI operations.

Volume & Output Intelligence

  • Adaptive Volume Control: tools_volume_adjust and tools_volume_set enable AI to implement intelligent volume management based on context and environment.
  • Output Targeting: AI can precisely control individual outputs within zones for optimized audio experiences.
  • Safety Intelligence: Built-in volume safeguards prevent AI from making dangerous volume changes.

AI-Optimized Operations

Batch Processing Intelligence

  • Bulk Track Operations: tools_tracks_addnext_bulk enables AI to efficiently manage large-scale track additions with position control.
  • Multi-Track Analysis: tools_track_open_batch_by_query allows AI to analyze multiple tracks simultaneously for intelligent decision-making.
  • Efficient Content Discovery: Batch operations minimize API calls while maximizing information retrieval.

Intelligent Error Recovery

  • Automatic Retry Logic: Built-in verification parameters enable AI to implement robust error recovery without manual intervention.
  • Fallback Strategies: AI can leverage wrapped execution modes that automatically attempt alternative approaches when primary operations fail.
  • Session Management: Intelligent session handling ensures AI operations remain reliable across extended interactions.

Context Persistence

  • Session-Aware Operations: AI can maintain context across multiple operations using consistent session IDs.
  • State Management: Tools provide AI with the ability to track and manage complex multi-step operations.
  • Intelligent Caching: Built-in caching mechanisms optimize AI performance for repeated operations.

AI Developer Experience

Comprehensive Tool Discovery

  • Capability Reporting: tools_capabilities provides AI with real-time information about available features and limitations.
  • Intelligent Tool Selection: AI can dynamically select the most appropriate tools based on the specific task and context.
  • Performance Optimization: Tools are designed for AI usage patterns with efficient parameter structures and response formats.

Structured Data Responses

  • Consistent Response Formats: All tools return structured data that AI can easily parse and process.
  • Artwork Integration: Built-in artwork support enables AI to create visually rich experiences.
  • Metadata-Rich Responses: Comprehensive metadata enables AI to make intelligent decisions about content and presentation.

Error Intelligence

  • Structured Error Reporting: Detailed error responses enable AI to implement intelligent error handling.
  • Recovery Guidance: Error responses include actionable recommendations for AI to attempt recovery.
  • Diagnostic Information: Comprehensive diagnostics enable AI to understand and resolve complex issues.

AI Use Case Patterns

Intelligent Playlist Curation

  • Discover user preferences through search and history analysis
  • Use tools_playlist_plan to create contextually appropriate playlists
  • Execute with tools_playlist_execute using optimal strategy (append/addnext)
  • Verify results and adjust based on user feedback

Multi-Zone Experience Design

  • Analyze available zones and outputs using discovery tools
  • Create intelligent groupings based on context and user preferences
  • Transfer or initiate playback with appropriate content
  • Monitor and adjust based on real-time feedback

Content Discovery Journeys

  • Start with broad search using tools_search_run
  • Narrow down using genre, artist, or album-specific tools
  • Explore variants and alternatives using specialized discovery tools
  • Execute playback or queue operations based on user intent