Built-in Streamable HTTP MCP server for Nuclear Music Player that lets Claude inspect available music-player domains, discover method signatures, describe data types, and control playback, queue, favorites, playlists, dashboard, and provider workflows.
Nuclear MCP Server runs inside the local Nuclear desktop app and exposes a Streamable HTTP server on the localhost interface., The `call` tool can execute Nuclear API methods after discovery through `list_methods`, `method_details`, and `describe_type`., Available domains include Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and Providers, so agents can change what is playing and modify local music-player state., Nuclear's plugin and provider system can retrieve streaming sources, metadata, playlists, and dashboard content from third-party services; use providers only where automated access is allowed., Keep the server bound to localhost, avoid exposing the MCP endpoint on a network interface, and require confirmation before letting an agent change playlists, favorites, queues, or provider settings.
Privacy notes
Tool calls and transcripts can include listening history, search terms, artists, albums, track titles, playlist names, favorites, provider choices, dashboard content, and local player settings., The MCP endpoint is local, but connected MCP clients, model providers, logs, screenshots, and shared chat transcripts can still retain music-library and listening-behavior data., Streaming and metadata providers may receive searches, track identifiers, IP addresses, user-agent metadata, or plugin-specific account context according to their own policies., The MCP server URL and port are local connection details; do not publish screenshots or logs that include private player state or provider credentials.
Author
Nuclear
Submitted by
oktofeesh1
Claim status
unclaimed
Last verified
2026-06-06
Decision playbook
Review trust signals before you adopt
Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.
Compare context
Selected
0
Current score
63
Baseline
—
Delta
No baseline selected
No major trust-signal divergence detected in the current selection.
Source and provenance checks
Needs review
Confirm ownership and provenance before trusting install instructions.
Source link availableRequired
Open the canonical repository and verify ownership.
Done
Source provenance statusRequired
Marked as source-backed.
Done
Metadata reviewed
No reviewed flag detected in metadata.
Pending
Safety and privacy checks
Complete
Validate risk disclosures before installation or API wiring.
Safety notes presentRequired
Review the listed safety guidance before running commands.
Done
Privacy notes presentRequired
Review data handling notes before connecting accounts or secrets.
Done
Trust level risk gateRequired
Trust level does not block evaluation.
Done
Package and install checks
Needs review
Check package metadata and artifact integrity signals.
Install payload available
Install or copy payload is available for review.
Done
Package verification flag
No package verification flag provided.
Pending
Checksum metadata
No checksum provided for downloaded artifact.
Pending
Compare-driven decision checks
Needs review
Use compare context to validate trade-offs before adoption.
Compare tray has multiple entries
Add at least one more entry to compare trust differences.
5 safety and 4 privacy notes across 4 risk areas. Review closely: credentials & tokens, network access, third-party handling.
4 areas
SafetyNetwork accessNuclear MCP Server runs inside the local Nuclear desktop app and exposes a Streamable HTTP server on the localhost interface.
SafetyExecution & processesThe `call` tool can execute Nuclear API methods after discovery through `list_methods`, `method_details`, and `describe_type`.
SafetyThird-party handlingAvailable domains include Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and Providers, so agents can change what is playing and modify local music-player state.
SafetyThird-party handlingNuclear's plugin and provider system can retrieve streaming sources, metadata, playlists, and dashboard content from third-party services; use providers only where automated access is allowed.
SafetyNetwork accessKeep the server bound to localhost, avoid exposing the MCP endpoint on a network interface, and require confirmation before letting an agent change playlists, favorites, queues, or provider settings.
PrivacyThird-party handlingTool calls and transcripts can include listening history, search terms, artists, albums, track titles, playlist names, favorites, provider choices, dashboard content, and local player settings.
PrivacyNetwork accessThe MCP endpoint is local, but connected MCP clients, model providers, logs, screenshots, and shared chat transcripts can still retain music-library and listening-behavior data.
PrivacyThird-party handlingStreaming and metadata providers may receive searches, track identifiers, IP addresses, user-agent metadata, or plugin-specific account context according to their own policies.
PrivacyCredentials & tokensThe MCP server URL and port are local connection details; do not publish screenshots or logs that include private player state or provider credentials.
Disclosure: AGPL-3.0-only open-source desktop music player with a built-in local MCP server. Users remain responsible for following Nuclear plugin, provider, streaming-source, copyright, and service-use terms.
Safety notes
Nuclear MCP Server runs inside the local Nuclear desktop app and exposes a Streamable HTTP server on the localhost interface.
The `call` tool can execute Nuclear API methods after discovery through `list_methods`, `method_details`, and `describe_type`.
Available domains include Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and Providers, so agents can change what is playing and modify local music-player state.
Nuclear's plugin and provider system can retrieve streaming sources, metadata, playlists, and dashboard content from third-party services; use providers only where automated access is allowed.
Keep the server bound to localhost, avoid exposing the MCP endpoint on a network interface, and require confirmation before letting an agent change playlists, favorites, queues, or provider settings.
Privacy notes
Tool calls and transcripts can include listening history, search terms, artists, albums, track titles, playlist names, favorites, provider choices, dashboard content, and local player settings.
The MCP endpoint is local, but connected MCP clients, model providers, logs, screenshots, and shared chat transcripts can still retain music-library and listening-behavior data.
Streaming and metadata providers may receive searches, track identifiers, IP addresses, user-agent metadata, or plugin-specific account context according to their own policies.
The MCP server URL and port are local connection details; do not publish screenshots or logs that include private player state or provider credentials.
Prerequisites
Nuclear Music Player installed from the project's releases or platform packages.
MCP server enabled in Nuclear under Settings > Integrations.
MCP client support for Streamable HTTP or remote URL based server configuration.
Review of the actual local URL shown by Nuclear because the server starts on ports 8800 through 8809.
Agreement on whether an AI assistant may control local playback, queues, favorites, playlists, dashboard views, metadata, and music providers.
Schema details
Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
10 minutes
Difficulty
beginner
Tool listing metadata
Disclosure
AGPL-3.0-only open-source desktop music player with a built-in local MCP server. Users remain responsible for following Nuclear plugin, provider, streaming-source, copyright, and service-use terms.
Full copyable content
{
"mcpServers": {
"nuclear": {
"url": "<copy the MCP Server URL from Nuclear Settings>"
}
}
}
About this resource
Content
Nuclear MCP Server is the built-in Model Context Protocol server in Nuclear
Music Player. Once enabled in the desktop app, it exposes a local Streamable
HTTP endpoint that lets Claude inspect available music-player methods, understand
their parameters, describe return types, and execute approved player actions.
Use it when Claude should help drive a local Nuclear session, inspect the queue,
control playback, add tracks, work with favorites or playlists, browse dashboard
data, or route through Nuclear's music providers without giving the assistant a
general-purpose browser or shell.
These sources were reviewed on 2026-06-06. Prefer the live repository,
MCP integration guide, README, license, package metadata, MCP architecture
guide, Rust server implementation, tool definitions, metadata source, and
settings handler for current setup and behavior details.
Features
Enable a built-in local Streamable HTTP MCP server from Nuclear settings.
Discover API domains with list_methods.
Inspect method names, parameters, and return types with method_details.
Inspect complex data shapes such as tracks, queues, queue items, and
playlists with describe_type.
Execute player API methods through the call tool.
Work across Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and
Providers domains.
Bind to localhost on port 8800, or the next available port through 8809.
Installation
Install Nuclear Music Player, open Settings > Integrations, and enable the MCP
server. Nuclear shows the actual local server URL after startup. The default
host and path are:
127.0.0.1:8800/mcp
Add it to Claude Code with Streamable HTTP transport:
claude mcp add nuclear --transport http <copy-url-from-nuclear-settings>
For MCP clients that accept URL-based server configuration:
{
"mcpServers": {
"nuclear": {
"url": "<copy the MCP Server URL from Nuclear Settings>"
}
}
}
If Nuclear chooses a different port, replace 8800 with the port shown in the
MCP Server URL field.
Use Cases
Ask Claude what playback, queue, playlist, favorite, dashboard, metadata, or
provider methods are available before taking action.
Build a listening queue from a prompt, then review the proposed tracks before
adding them.
Create or update playlists from approved artists, albums, or tracks.
Inspect favorites or queue state while planning a listening session.
Control playback in a local desktop session without giving the assistant
shell access.
Explore Nuclear provider behavior with bounded, user-confirmed actions.
Safety and Privacy
Nuclear MCP Server is local, but it still lets an agent change the state of a
running desktop music player. Require confirmation before modifying playlists,
favorites, queue entries, provider settings, or any action that starts playback.
Treat searches, queue contents, listening history, favorites, playlists,
provider choices, metadata, local settings, and MCP transcripts as personal
data. Keep the server bound to localhost, and do not expose the local MCP
endpoint over a network unless you have reviewed the access controls.
Duplicate Check
No nukeop/nuclear, Nuclear Music Player MCP, Nuclear MCP Server, or matching
source URL entry was found in content/mcp or README.md. Existing browser,
media conversion, and search MCP entries do not cover Nuclear's built-in music
player control server.
Show that Nuclear MCP Server is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.
[](https://heyclau.de/entry/mcp/nuclear-mcp-server)
How it compares
Nuclear MCP Server side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.
1 trust signal differ across this comparison (Submitter).
Built-in Streamable HTTP MCP server for Nuclear Music Player that lets Claude inspect available music-player domains, discover method signatures, describe data types, and control playback, queue, favorites, playlists, dashboard, and provider workflows.
Hosted streamable-HTTP MCP server that exposes inference.sh platform tools for running apps, managing tasks, proxying external MCP connectors, and calling hundreds of hosted AI models from Claude Code, Cursor, and other MCP clients.
MCP transport bridge that converts between stdio, SSE, and Streamable HTTP so local MCP clients can reach remote servers, or remote clients can reach local stdio servers.
Hosted streamable-HTTP MCP server registered as ai.com.mcp/skills-search that exposes Agent Skills Search API tools for discovering skills from the skills.sh registry using the open Agent Skills format.
✓Nuclear MCP Server runs inside the local Nuclear desktop app and exposes a Streamable HTTP server on the localhost interface.
The `call` tool can execute Nuclear API methods after discovery through `list_methods`, `method_details`, and `describe_type`.
Available domains include Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and Providers, so agents can change what is playing and modify local music-player state.
Nuclear's plugin and provider system can retrieve streaming sources, metadata, playlists, and dashboard content from third-party services; use providers only where automated access is allowed.
Keep the server bound to localhost, avoid exposing the MCP endpoint on a network interface, and require confirmation before letting an agent change playlists, favorites, queues, or provider settings.
✓The hosted MCP server can execute inference.sh apps, platform tasks, and proxied connector tools that may create, update, or delete data in connected services such as GitHub, Linear, Slack, Notion, or databases.
Bearer API keys grant account-scoped access to platform capabilities; rotate compromised keys immediately and avoid committing tokens to repositories or shared MCP config files.
MCP proxy features can discover and call tools on remote MCP servers through inference.sh, which expands the runtime trust boundary beyond the primary client configuration.
Tool calls may trigger paid inference, connector actions, storage writes, or outbound network requests according to the selected app or connector.
Use least-privilege connector authorization and review each proxied server before enabling it in production agent workflows.
✓mcp-proxy can expose local stdio MCP servers as network services; keep the host bound to `127.0.0.1` unless remote access is intentional.
Passing `--host=0.0.0.0`, permissive CORS, or named-server routes can make tools reachable by other systems on the network.
Proxy configuration can include bearer tokens, OAuth client secrets, headers, server commands, environment variables, and working directories.
The proxy can spawn arbitrary configured MCP server commands; only use trusted command strings and config files.
Remote SSE or Streamable HTTP servers should be authenticated and trusted before forwarding client requests or tool outputs.
✓Search results expose skill metadata and install instructions; installing a skill can give an agent executable scripts, shell commands, and third-party repository access.
Treat discovered skills like unreviewed dependencies—inspect `SKILL.md`, scripts, and publisher sources before `npx skills add` or equivalent installers run.
Self-hosted HAPI deployments inherit API rate limits and outbound network access to `https://skills.sh/api`; scope firewall and logging policies accordingly.
Hosted remotes process search queries on vendor infrastructure; avoid sending confidential project names or customer identifiers in search strings when policy requires on-prem discovery.
Privacy notes
✓Tool calls and transcripts can include listening history, search terms, artists, albums, track titles, playlist names, favorites, provider choices, dashboard content, and local player settings.
The MCP endpoint is local, but connected MCP clients, model providers, logs, screenshots, and shared chat transcripts can still retain music-library and listening-behavior data.
Streaming and metadata providers may receive searches, track identifiers, IP addresses, user-agent metadata, or plugin-specific account context according to their own policies.
The MCP server URL and port are local connection details; do not publish screenshots or logs that include private player state or provider credentials.
✓Prompts, files, tool arguments, task metadata, connector payloads, and model outputs are processed by inference.sh and may transit connected third-party MCP services.
OAuth-backed connectors can expose account, workspace, issue, message, or repository content to the agent through proxied tool results.
API keys, connector tokens, and task logs should be treated as sensitive credentials and kept out of version control and public issue threads.
Hosted execution may retain usage, billing, and operational telemetry according to inference.sh policies; review the platform privacy documentation before processing regulated data.
✓MCP requests, responses, tool outputs, progress events, headers, OAuth tokens, API access tokens, and session identifiers may pass through the proxy process.
Named server config files can contain command arguments, environment variables, and credentials for downstream MCP servers.
Exposed network endpoints can reveal tool names, server status, and results to clients that can reach the proxy.
Logs and troubleshooting output may include endpoint URLs, command names, headers, connection errors, or server names.
Store config files outside shared repositories when they include tokens or private server details.
✓Search queries, skill names, registry metadata, and tool responses enter MCP client context and may be logged by the hosted remote operator.
skills.sh registry responses can include publisher URLs, install counts, and repository identifiers that reveal technology choices to shared clients.
Installing skills from search results may download repository archives or scripts that process local files; review each skill's privacy posture before use.
Self-hosted HAPI CLI mode keeps search traffic on your infrastructure but still contacts the public skills.sh API unless you mirror the backend.
Prerequisites
Nuclear Music Player installed from the project's releases or platform packages.
MCP server enabled in Nuclear under Settings > Integrations.
MCP client support for Streamable HTTP or remote URL based server configuration.
Review of the actual local URL shown by Nuclear because the server starts on ports 8800 through 8809.
An inference.sh account and API key from `belt login` or the platform dashboard.
An MCP client that supports streamable HTTP transport, such as Claude Code, Cursor, Cline, or Windsurf.
Review of which inference.sh apps, connectors, and proxy tools the agent may call before enabling write-capable workflows.
A billing and quota plan if the workflow will run image, video, LLM, search, or connector-backed tasks at scale.
Python 3.10 or newer.
uv, pipx, or Docker for installation.
A known MCP endpoint or local stdio MCP server to bridge.
Review of required headers, OAuth client credentials, CORS origins, host, port, and named-server configuration.
An MCP client that supports streamable HTTP transport, such as Claude Code, Cursor, Cline, or Windsurf.
Review of which discovered skills the agent may install or execute before enabling autonomous workflows.
Optional Docker or HAPI CLI setup if you need a self-hosted skills-search server instead of the hosted remote.
Install
claude mcp add nuclear --transport http <copy-url-from-nuclear-settings>
Run `belt login` to create an inference.sh API key, then add the streamable HTTP MCP endpoint `https://api.inference.sh/mcp` with `Authorization: Bearer inf_<your_api_key>` in your MCP client settings.
uv tool install mcp-proxy
Add the streamable HTTP MCP endpoint `https://skills-sh.run.mcp.com.ai/mcp` to your MCP client, then call `searchSkills` to query the skills.sh registry.
Config
Manual-only setup:
claude mcp add nuclear --transport http <copy-url-from-nuclear-settings>