Nuclear
by nukeop
Nuclear is a free, ad-free streaming music player whose built-in MCP server exposes four discovery-based tools to search, queue, and control playback.
Add to Claude Code
claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
About
Nuclear's MCP server follows a hierarchical discovery pattern instead of dumping every capability into one flat tool list: list_methods returns what's available within a domain (Queue, Playback, Metadata, Favorites, Playlists, Dashboard, Providers), method_details fills in the parameters and return type for a specific method, describe_type explains any complex data type those methods reference, and call actually executes the method with the arguments the agent just looked up. It runs on localhost only, defaulting to port 8800 with automatic fallback if that's taken.
The player itself streams and searches music from free, ad-free open sources with no account required, supports building, importing, and exporting playlists, and runs on a full plugin system (sources, lyrics, visualizers, themes) with a built-in plugin store. It's a Tauri (Rust + React) app in a pnpm/Turborepo monorepo, available on Windows, macOS, and Linux.
Key features
- list_methods and method_details let an agent discover what's callable per domain before invoking anything
- call executes any Nuclear API method (Playback, Queue, Favorites, Playlists, Providers) with looked-up parameters
- Runs on localhost only (port 8800, with automatic fallback), no cloud relay involved
- Streams and searches music from free, ad-free open sources with no account required
- Full plugin system for sources, lyrics, and visualizers, with a built-in plugin store
- Cross-platform desktop app (Tauri/Rust + React) for Windows, macOS, and Linux
Use cases
- Letting an agent build or edit a playlist and start playback entirely through natural-language requests
- Controlling music playback (play, pause, skip, queue) hands-free while working in an MCP-enabled editor
- Searching across Nuclear's connected sources for a track or artist without touching the app's UI
- Automating repetitive music-library tasks like importing playlists from other services
Available tools
list_methods
Lists the methods available within a given domain, such as Queue or Playback.
method_details
Returns full parameter and return-type details for a specific method.
describe_type
Describes the JSON structure of a complex data type referenced by a method.
call
Executes a specific Nuclear API method with the supplied parameters.
Frequently asked questions
Do I need an account or API key?
No. Nuclear streams from free, open sources, and the MCP server runs locally with no account, API key, or cloud relay involved.
How does an agent know what it's allowed to call?
It calls list_methods and method_details first to discover available methods per domain, then calls call with the parameters it just learned about.