webradio-plugin

Search and discover 30,000+ internet radio stations via Radio Browser API. Works as a standalone MCP server for Claude Desktop or as an importable library in any Node.js project.

Search results include clickable stream URLs — click a link to start listening directly in your browser.

Tools

Tool	Description
radio_search	Search stations by name, country, or genre tag
radio_get_station	Get station details and stream URL by UUID
radio_top_stations	Get the most popular stations worldwide

Usage

Claude Desktop (Extension)

Install webradio-plugin-1.0.0.mcpb via double-click, or add to config manually:

{
  "mcpServers": {
    "webradio": {
      "command": "node",
      "args": ["/path/to/webradio-plugin/dist/server.js"]
    }
  }
}

As a Library

import { searchStations, getStationByUUID, getTopStations } from 'webradio-plugin';

const stations = await searchStations('jazz', 'Germany');
const station = await getStationByUUID('abc-123');
const top = await getTopStations(10);

Build

npm install
npm run build

Environment

Variable	Default	Description
RADIO_BROWSER_API_URL	https://de1.api.radio-browser.info	API base URL

License

MIT