Setup

Connect an assistant to Soundbox.

Connect a compatible AI assistant to search, inspect, and manage your own Soundbox library without giving it access to anyone else’s.

Connect with your Soundbox account

In your assistant's MCP or Connectors settings, add a Streamable HTTP server using this address:

https://soundboxradio.com/mcp

Your assistant will then open a browser so you can sign in to Soundbox and approve the connection. This is the recommended route: there is no key to copy, and you can remove that assistant later from Soundbox Settings without affecting other connections.

What a connected assistant can do

A connected assistant can search for stations, check streams, read current programme information, and manage the stations and songs in the library you authorised. This includes editing station names, aliases, descriptions, tags, enabled state, and the You say phrase for a routine shortcut. It can also mark a routine as added.

Routine shortcuts remain separate from station details. An assistant can change the phrase stored in Soundbox, but Alexa routines themselves are managed in the Alexa app.

For clients without browser sign-in

Some clients and unattended scripts cannot complete browser sign-in. In Soundbox Settings, open Let an assistant add stations and choose Copy config under With a key. Add the supplied entry alongside any existing MCP servers in that client’s configuration.

A key grants access to your library, so treat it like a password. Keep it in a settings file or environment variable, never in a chat. Replace the key in Soundbox Settings whenever you need to disconnect every client using it.

A typical configuration looks like this. Use the exact format supplied by your client where it differs.

{
  "mcpServers": {
    "soundbox": {
      "type": "http",
      "url": "https://soundboxradio.com/mcp",
      "headers": { "Authorization": "Bearer YOUR-KEY" }
    }
  }
}

If the connection does not appear

Restart the assistant after changing a configuration file. If it still cannot see Soundbox, check the server address, the configuration format required by that client, and the client’s MCP documentation.