internet-radio-mcp

An open-source Model Context Protocol (MCP) server for internet radio. It lets Claude, Cursor, VS Code Copilot and other MCP clients search radio stations worldwide and get their direct stream URLs. It also lists top and trending stations, countries and genres.

The station data comes from Radio Browser, a community-maintained, public-domain directory with over 50,000 stations that have working streams. The server is built by 72FM, a free web radio player built on the same directory. Every result includes a listen_url that plays the station in the browser on 72FM, as well as the station's own stream_url.

Stations belong to their broadcasters. Neither 72FM nor this server owns, operates or curates them. Anyone can add or edit entries in the directory, so a stream can occasionally be offline.

• No API key, no account, read-only.
• 5 tools, 1 prompt, stdio transport.
• Runtime dependencies: @modelcontextprotocol/server (the official MCP TypeScript SDK, v2) and zod.

Example questions

• "Find jazz stations in Brazil"
• "What are the most popular stations in Japan?"
• "Give me the stream URL for BBC World Service"
• "What's trending on internet radio right now?"
• "Which countries have the most radio stations?"
• "What genres can I search for? Then find me some lofi stations."

Install

Requires Node.js 20 or newer. The server runs straight from GitHub with npx, so there is nothing to install globally.

Claude Code

claude mcp add internet-radio -- npx -y github:AlonDrilich/internet-radio-mcp

Then run /mcp in a session to confirm that internet-radio is connected.

Claude Desktop

Open Settings → Developer → Edit Config. This opens claude_desktop_config.json: on macOS it is at ~/Library/Application Support/Claude/claude_desktop_config.json, and on Windows at %APPDATA%\Claude\claude_desktop_config.json. Add:

{
  "mcpServers": {
    "internet-radio": {
      "command": "npx",
      "args": ["-y", "github:AlonDrilich/internet-radio-mcp"]
    }
  }
}

Restart Claude Desktop.

Cursor

Add to Cursor with one click, or add the server to ~/.cursor/mcp.json to use it everywhere, or to .cursor/mcp.json to use it in one project:

{
  "mcpServers": {
    "internet-radio": {
      "command": "npx",
      "args": ["-y", "github:AlonDrilich/internet-radio-mcp"]
    }
  }
}

VS Code (GitHub Copilot, Agent mode)

Install in VS Code with one click, or add the server to .vscode/mcp.json, or run MCP: Add Server from the Command Palette:

{
  "servers": {
    "internet-radio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:AlonDrilich/internet-radio-mcp"]
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/AlonDrilich/internet-radio-mcp

The repository carries a gemini-extension.json, so the server is added as the internet-radio extension.

Other clients

Any MCP client that can launch a stdio server can use the same command: npx -y github:AlonDrilich/internet-radio-mcp.

The first launch downloads the package from GitHub, which takes a few seconds. Later launches use the npx cache.

Docker

The same server is published as a container image, and is listed in the official MCP Registry as io.github.AlonDrilich/internet-radio-mcp:

docker run -i --rm ghcr.io/alondrilich/internet-rad

... [View full README on GitHub](https://github.com/alondrilich/internet-radio-mcp#readme)