# nuclear: Free Music Streaming MCP Client for AI Agents

> nuclear is a TypeScript-based streaming music player that finds and plays free music. It integrates as an MCP Client, allowing AI agents to drive music playback, manage queues, and interact with its extensive features. Developers can wire nuclear into Claude Code, Codex CLI, OpenCode, and Claude Desktop environments.

**Published:** 2026-09-28T12:01:09.608+00:00

**Keywords:** nuclear,mcp-client,music-player,ai-agent-control

# nuclear: Driving Free Music Streaming with MCP

nuclear is a TypeScript-based streaming music player designed to find and play free music from various sources. Beyond its core function as a feature-rich player, nuclear stands out as an MCP Client, enabling AI agents to programmatically control music playback and interact with its capabilities. With over 18,500 GitHub stars, it offers a robust platform for integrating music streaming into AI-driven workflows.

## Activating the MCP Server

To integrate nuclear with your AI agent, you first need to enable its built-in MCP server. This is done directly within the application's settings. Navigate to `Settings → Integrations` to activate the server. Once enabled, nuclear exposes an MCP endpoint, typically at `http://127.0.0.1:8800/mcp`, which your AI client can connect to.

## Wiring nuclear into Your AI Environment

Connecting nuclear to various AI development environments is straightforward, leveraging its exposed MCP endpoint. Here are the specific configurations for popular platforms:

### Claude Code

For developers using Claude Code, add nuclear as an MCP client with the following command:

```bash
claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
```

### Codex CLI

If you're working with the Codex CLI, the command to add nuclear is similar:

```bash
codex mcp add nuclear --url http://127.0.0.1:8800/mcp
```

### OpenCode

For OpenCode users, nuclear can be configured in your `mcp` settings block:

```json
{
  "mcp": {
    "nuclear": {
      "type": "remote",
      "url": "http://127.0.0.1:8800/mcp"
    }
  }
}
```

### Claude Desktop / Cursor / Windsurf

To integrate nuclear into Claude Desktop, Cursor, or Windsurf, modify your `mcpServers` configuration:

```json
{
  "mcpServers": {
    "nuclear": {
      "url": "http://127.0.0.1:8800/mcp"
    }
  }
```

## Enhancing AI Agent Capabilities with nuclear

Once connected, nuclear's MCP integration allows AI agents to leverage its extensive feature set. This includes searching for music, streaming tracks, browsing artist and album pages, managing playback queues (shuffle, repeat, reordering), and interacting with favorites and playlists.

To help your AI agent understand nuclear's specific capabilities, a dedicated MCP skill can be loaded. This skill, available as `nuclear-mcp.zip`, helps the AI agent get "up to speed" on how to interact with the player effectively.

## Core Player Features

Beyond its MCP integration, nuclear offers a comprehensive set of features for music enthusiasts:

*   **Music Discovery & Streaming:** Search for and stream music from various sources.
*   **Artist & Album Browsing:** Explore artist biographies, discographies, and similar artists, as well as album track listings.
*   **Queue Management:** Full control over playback queues, including shuffle, repeat, and drag-and-drop reordering.
*   **Personalization:** Manage favorites (albums, artists, tracks) and create, import, or export playlists, including imports from other services.
*   **Extensibility:** A plugin system with a built-in store, alongside support for custom CSS themes.
*   **Usability:** Auto-updates, keyboard shortcuts, and localization in multiple languages.

By exposing these features via MCP, nuclear transforms into a powerful component for AI agents, enabling them to curate and control music experiences programmatically.

## References

*   [nuclear on GitHub](https://github.com/nukeop/nuclear)
*   [Model Context Protocol Documentation](https://modelcontextprotocol.io/introduction)
*   [nuclear on model-context-protocol.com](https://model-context-protocol.com/clients/)

## Related Repository

- [nuclear](https://model-context-protocol.com/clients/nuclear)

**Source:** https://model-context-protocol.com/blog/nuclear-free-music-streaming-mcp-client-for-ai-agents-mcp-client-guide